Canais
Como conectar um número de WhatsApp (canal) ao OrbitSender — o botão Conectar com QR Code, código de pareamento, importar sessão ou link de conexão externa, e como resolver canal desconectado.
Um canal (ou número de WhatsApp / instância) é um número conectado ao OrbitSender. É por ele que suas campanhas são enviadas. Você pode ter mais de um canal, conforme seu plano.
O que são canais
Cada canal representa um aparelho/número de WhatsApp conectado. O envio das campanhas é distribuído entre os canais do segmento.
Como conectar um canal
Um canal pendente ou inativo tem um único botão Conectar. Ao clicar nele, abre um seletor com quatro formas de conectar: QR Code, Código de pareamento, Importar conexão e Criar link de conexão externa. Escolha a que preferir — todas levam o canal ao status ativo.
Acesse a área de Canais
No menu do painel, abra Canais.
Crie um novo canal
Clique em Novo Canal (botão no topo direito). No formulário, dê um nome entre
3 e 32 caracteres — ele é normalizado para minúsculas com hífens (espaços
viram hífens e acentos são removidos), por exemplo vendas ou canal-principal.
Clique em Criar Canal para salvar.
Abra o seletor de conexão
No card do canal recém-criado (que aparece como pendente), clique em Conectar. Abre o seletor com as quatro formas de conectar; cada opção mostra um título e um subtítulo (por exemplo, QR Code • Escaneie com o WhatsApp).
Escolha o método de conexão
Selecione uma das opções do seletor:
- QR Code — abre o modal com o QR Code. No celular, abra WhatsApp → Aparelhos conectados → Conectar um aparelho e escaneie o código exibido na tela.
- Código de pareamento — em vez de escanear, você recebe um código para digitar no WhatsApp do celular. (Não aparece em canais OrbitX / api-whats.)
- Importar conexão — cola a sessão de um WhatsApp Web já aberto, sem escanear. Veja Importar conexão.
- Criar link de conexão externa — gera um link protegido por código para outra pessoa conectar o WhatsApp à distância. Veja Link de conexão externa.
Confirme a conexão
Quando conectado, o status do canal muda para ativo. Pronto para usar.
Importar conexão (colar a sessão do WhatsApp Web)
Em vez de escanear o QR Code, você pode importar uma sessão já aberta no WhatsApp Web. A sessão importada nasce conectada — não há QR Code para escanear.
Baixe a extensão de conexão
No seletor, escolha Importar conexão para abrir o modal Importar sessão.
Clique em Baixar extensão (arquivo /extensions/ExtensaoConexao.zip) e
extraia o ZIP — ele contém o JSON da sessão.
Feche a aba do WhatsApp Web
Feche a aba do WhatsApp Web usada para extrair a sessão antes de salvar — senão o WhatsApp derruba a conexão importada (conflito de sessão).
Cole o JSON e salve
Cole o JSON da sessão na caixa de texto e clique em Salvar sessão. O JSON
precisa conter os campos obrigatórios (localStorage, noise e signal); se
faltar algum, aparece JSON de sessão incompleto. Faltando: [campos]. Com tudo
certo, você vê Sessão salva! Iniciando conexão... e o canal fica ativo.
Link de conexão externa (conectar à distância)
Serve para outra pessoa conectar o WhatsApp deste canal remotamente — por exemplo, o dono do número que não tem acesso ao painel. Você gera um link protegido por um código de 6 dígitos e envia os dois para essa pessoa.
Lado do dono: gerar o link
Crie o link
No seletor, escolha Criar link de conexão externa. Selecione a validade (5, 15, 30, 45 minutos ou 1 hora — o padrão é 15 min) e clique em Gerar link.
Copie o link e o código
Após gerar, aparece o link (algo como
app.orbitsender.com/conect/...) e o código de acesso de 6 dígitos, com um
contador de tempo restante. Use os botões Copiar link, Copiar código
ou Copiar link e código e envie os dois para quem vai conectar.
Lado de quem recebe: conectar
Abra o link e digite o código
Abra a URL recebida (app.orbitsender.com/conect/...) e digite o código de 6
dígitos. Se o código estiver errado, aparece Código incorreto; o tempo
restante fica visível durante todo o processo.
Escolha o método e conecte
Escolha QR Code, Código de pareamento ou Importar. No Importar, há o botão Baixar extensão e vale o mesmo aviso: feche a aba do WhatsApp Web antes de salvar. Ao conectar, aparece a confirmação de sucesso.
Compartilhe com segurança
O link é protegido por um token longo na URL e por um código de 6 dígitos — envie os dois apenas para a pessoa certa. O link expira por tempo (a validade que você escolheu), trava após 8 tentativas de código erradas e expira ao conectar (uso único). Se expirar ou travar, gere um link novo.
Status de conexão no topo
No header do painel há um indicador de conexão que resume o estado dos seus canais com três estados:
- 🟢 Conectado — todos os canais estão conectados. Mostra quantos estão conectados.
- 🟡 Parcialmente conectado — alguns canais caíram. Mostra quantos estão desconectados.
- 🔴 Desconectado — nenhum canal está conectado. Mostra quantos estão desconectados.
Ao passar o mouse sobre o indicador, aparece a lista dos canais desconectados (com o status de cada um: desconectado, pendente ou conectando). Quando está tudo 🟢, o mesmo hover confirma Todos os canais conectados. Clicar leva à tela de Canais — ou abre o aviso de que não há nenhum canal conectado, quando é o caso.
Use o indicador para reagir rápido a quedas: se aparecer 🟡 ou 🔴, vá reconectar os canais em Reconexão do canal.
Como o disparo se distribui entre vários canais
Quando um segmento tem 2 ou mais canais, o OrbitSender divide os grupos entre eles (o "rodízio de canais"). Na prática:
- A divisão é decidida no momento em que a campanha é criada, não durante o envio. Cada grupo recebe um canal fixo para aquela campanha — o rodízio é por grupo e por campanha, nunca por mensagem.
- A cada nova campanha há um novo sorteio. Como é embaralhado, um mesmo grupo pode sair por canais diferentes em campanhas diferentes.
- Não há "canal principal". O canal usado para criar a campanha não tem prioridade.
Cada grupo é enviado por um único canal naquela campanha — nunca pelos dois ao mesmo tempo (isso geraria mensagem duplicada).
Manual × monitoramento
- Campanha manual: os grupos compartilhados são embaralhados e distribuídos de forma intercalada entre os canais.
- Campanha por monitoramento / Arena: a divisão é proporcional à carga — o sistema equilibra o total de grupos por canal.
Nos dois casos o resultado é equilibrado; muda só o método de cálculo.
Enviar ao mesmo tempo ou em sequência
Dividir os grupos entre canais não significa enviar ao mesmo tempo — quem controla isso é a fila em Filas de Disparo → Envios Simultâneos:
- Por Canal → todos os canais enviam em paralelo (reduz o tempo total).
- Desativado → envio em sequência, um de cada vez, mesmo dividido.
- Por Segmento → sequencial dentro do segmento; o paralelismo é entre segmentos, não entre os canais do mesmo segmento.
Referência prática: um canal bem aquecido atende cerca de 50 grupos. Com 2 canais e fila Por Canal, o tempo total cai aproximadamente pela metade.
Para vincular canais: Segmentos → Editar → selecionar canais → Salvar Alterações.
Todos os canais precisam ser admin dos grupos
Na prática, todos os canais do segmento devem ser membros — e admin, quando o grupo restringe mensagens a administradores — de todos os grupos.
- O OrbitSender assume que qualquer canal pode postar em qualquer grupo do segmento; ele não verifica automaticamente se o canal é membro/admin.
- Se o rodízio atribuir um grupo a um canal sem acesso, o envio falha para aquele grupo e ele é redistribuído para outro canal. Se nenhum canal conseguir, o grupo fica com erro.
O sistema descobre por tentativa-e-erro. Você é responsável por deixar todos os canais como admin de todos os grupos — isso evita falhas e mensagens que não chegam. Veja O canal precisa ser admin do grupo.
Contingência: quando um canal cai no disparo
Ter vários canais na campanha é a contingência do OrbitSender. Quando um canal desconecta no meio do disparo:
- A campanha não para — os demais canais continuam enviando.
- Os grupos ainda não enviados pelo canal caído são redistribuídos para os outros canais vivos do mesmo segmento (uma etapa automática de redistribuição).
- O canal substituto é o primeiro canal vivo que aceitar (por ordem de cadastro) — não há escolha por "canal mais saudável".
- Se todos falharem para um grupo, ele fica com erro.
Reconexão do canal
Veja também Escolha o método de conexão para reconectar por outro método, e o Status de conexão no topo para identificar rapidamente os canais caídos.
- A reconexão é sempre manual — clique em Conectar e escolha o método no seletor (QR Code, Código de pareamento ou Importar conexão). Não há reconexão automática.
- Você recebe uma notificação ("toque para reconectar"), mas o app não reconecta sozinho.
- Reconectar NÃO reprocessa as mensagens que ficaram para trás — só deixa o canal disponível para as próximas campanhas.
Risco de duplicidade
Se o canal chegou a entregar a mensagem mas caiu antes de o sistema confirmar, o grupo é tratado como "não enviado" e redistribuído — o que pode gerar a mesma mensagem 2×. Veja A mesma promoção chegou 2x.
O que o OrbitSender NÃO faz
Para você não criar expectativa errada:
- Não existe "canal reserva/backup" de disparo. A contingência é a redistribuição entre os canais que você já vinculou — não há um número de espera que entra sozinho. (O Canal de segurança é outra coisa.)
- Não há reconexão automática — canal caído só volta manualmente.
- Não há failover por "saúde" — o substituto é o primeiro vivo, não o melhor.
- O OrbitSender não desconecta seu número sozinho para "prevenir banimento". A proteção vem do provedor e do rate-limit — respeitar as taxas de envio é o que reduz o risco.
- Não há reprocessamento automático de grupos com erro — só dá para reprocessar manualmente os pendentes.
O canal de segurança não é reserva de disparo
O Canal de segurança não participa da contingência de disparo — ele protege grupos contra invasores e é cobrado à parte. Não conte com ele como reserva de envio.
Proxy / IP dedicado e estabilidade
O OrbitSender suporta proxy com IP dedicado por número (IP residencial, Brasil), que ajuda a manter o canal estável e reduzir sinais de risco.
- O proxy é vinculado 1 para 1 a cada número (IP fixo), com renovação automática.
- Não há rodízio automático de IP — a troca de proxy é manual. "Rodízio de canais" (grupos entre canais) é diferente de "rodízio de IP".
Boas práticas de contingência
- Use 2+ canais no mesmo segmento — é a única contingência real.
- Deixe todos os canais admin de todos os grupos para a redistribuição funcionar.
- Mantenha os celulares online (internet estável) para reduzir quedas.
- Reaja rápido à notificação de canal desconectado e reconecte pelo QR.
- Respeite as taxas de envio e mantenha os canais aquecidos.
- Após uma queda, confira os grupos com erro — não são reenviados sozinhos.
Canal de segurança
Um canal de segurança é um número dedicado a proteger seus grupos contra invasores, funcionando junto com a Detecção de invasores.
Para criar: Canais → Novo Canal → Tipo de Conexão → Conexão (Segurança) e conecte via QR Code um número que não seja admin dos grupos — ele monitora e reporta invasores.
Quem já tem 2+ canais pode usar um deles como segurança sem custo; um número exclusivo de segurança é um adicional pago. Como esse canal normalmente não é admin, para apagar a mensagem de um invasor é preciso promovê-lo a admin temporariamente, apagar, remover o invasor e rebaixar.
Problemas comuns ao conectar (QR Code, desconexão)
- QR Code expira: clique em Conectar → QR Code para gerar um novo se demorar para escanear.
- Canal cai/desconecta: verifique se o celular está com internet e se o WhatsApp não foi desconectado manualmente. Para reconectar, use Conectar e escolha o método no seletor — veja Escolha o método de conexão.
- Não consigo excluir: desconecte o canal antes de excluí-lo.
Mais soluções em Solução de problemas.
Cadastro e login
Como criar conta (cadastro/registro), fazer login e recuperar a senha no OrbitSender, além do primeiro acesso ao painel e da fila de espera.
Segmentos
Como criar segmentos no OrbitSender — agrupar grupos de WhatsApp, sincronizar grupos, filtrar, editar e configurar monitoramento de grupo.