Conectar um número

Conectar um número ao Orbicast é como abrir o WhatsApp Web: você lê um código pelo celular e o número passa a atender também por aqui. Não é uma conta nova e não duplica nada — o celular continua sendo o dono da conta e pode desconectar quando quiser.

Sessão não é canal Signal

São duas coisas com nomes parecidos que vivem em camadas diferentes, e confundi-las atrapalha a leitura de quase toda tela da ferramenta.

Sessão	Canal Signal
Conceito da ferramenta: um número pareado.	Conceito do protocolo: um par de chaves com um dispositivo.
Ocupa um slot de aparelho na conta.	Existe um por aparelho do interlocutor, não por conta.
Você cria e encerra pela tela.	Nasce e morre sozinho, conforme a conversa acontece.

A consequência prática é a que mais surpreende: uma sessão gera vários canais Signal. Se o seu contato usa celular, WhatsApp Web e um tablet, ele tem três dispositivos — e cada mensagem enviada a ele é cifrada três vezes, uma por dispositivo, com chaves diferentes. Não existe “cifrar uma vez e distribuir”: é por isso que a tela de estado Signal lista canais, e não contatos.

Quantas sessões cabem

O limite não é da ferramenta, é da conta: a Meta permite um número restrito de aparelhos companheiros simultâneos por conta — hoje, quatro, o mesmo teto que vale para o WhatsApp Web e o app de desktop. Cada sessão aqui consome um desses slots, e eles são disputados com os aparelhos que você já usa no dia a dia. Parear a quinta derruba a mais antiga.

O ciclo de estados

Quatro estados, e as transições entre eles são fechadas: o que não está na tabela é bug, não estado novo.

Estado	O que significa	Pode ir para
AGUARDANDO_PAREAMENTO	O QR está na tela e o servidor espera o celular autorizar.	CONECTADA · ENCERRADA
CONECTADA	O canal está aberto e o número envia e recebe.	DESCONECTADA · ENCERRADA
DESCONECTADA	Queda de rede ou reinício. As credenciais continuam válidas.	CONECTADA · ENCERRADA
ENCERRADA	Logout no celular ou banimento. Terminal: não há saída.	—

A distinção que importa: DESCONECTADA se recupera sozinha — as credenciais Signal continuam no banco, e a reconexão é automática, sem QR e sem ninguém por perto. ENCERRADA é terminal: exige um novo pareamento, ou seja, o celular em mãos para ler outro QR. É a diferença entre um soluço de rede às três da manhã e uma parada que espera até alguém acordar.

Estar CONECTADA também não basta para enviar. Uma sessão conectada porém em pausa — colocada lá pelo freio automático — recusa envios até a pausa vencer. Conectar e poder enviar são perguntas separadas de propósito.

O pareamento, marco a marco

O QR não é uma caixa-preta que gira: cada etapa do handshake é observável, e a tela de nova sessão acende os marcos conforme eles chegam. Nesta ordem:

1 WebSocket aberto
2 Noise XX → Transport state (canal cifrado)
3 QR entregue pelo servidor
4 Celular autorizou o aparelho
5 Pronto para enviar e receber

Travar num marco específico diz muito mais do que “o QR não funcionou”. Parar no segundo aponta para rede ou TLS; parar no terceiro, para o servidor não ter entregado o código; parar entre o terceiro e o quarto significa que o QR expirou antes da leitura — nada disso é a mesma falha, embora as três apareçam igual para quem só olha a tela do celular.

Identificador técnico (JID)

Esta parte interessa a quem dá suporte ou integra outro sistema — no uso do dia a dia você não precisa dela.

O JID é o endereço de um aparelho na rede do WhatsApp, não de uma pessoa. A leitura é direta:

5535999999999:12@s.whatsapp.net
└── telefone ─┘ └┬┘ └─ domínio ─┘
                índice do aparelho

O sufixo é a parte que revela o multi-device. :0 é o celular principal — o aparelho dono da conta, aquele que autoriza os demais. Qualquer índice maior que zero é um aparelho companheiro: um WhatsApp Web, um desktop, ou uma sessão desta ferramenta. Os números não são sequenciais nem previsíveis; :12 não significa que existam doze aparelhos, apenas que aquele recebeu esse identificador.

Por isso a mesma pessoa aparece várias vezes na lista de canais Signal, com o mesmo telefone e sufixos diferentes. Não é duplicidade: é o retrato de quantos aparelhos daquele contato precisaram receber uma cópia cifrada. Quando o envio informa quantos dispositivos receberam, está contando exatamente essas linhas.

Um JID sem sufixo (5535999999999@s.whatsapp.net) endereça o usuário, não um aparelho — é a forma usada ao escolher o destinatário de um envio. Quem resolve isso em dispositivos concretos é a camada Signal, no momento de cifrar.