Escolher o conector correto

Baileys e WWebJS aparecem no grupo de conexões não oficiais. Use somente o conector aprovado para a sua instalação; uma sessão criada em um tipo não deve ser tratada como se pertencesse ao outro.

Janela Novo Canal com Baileys e WWebJS entre os tipos de WhatsApp não oficiais
Confirme o tipo antes de salvar. Criar várias sessões para o mesmo número dificulta o diagnóstico e pode duplicar eventos.
Imagem ampliada

Preencher o formulário do canal

Formulário Novo Canal com Baileys, nome, canal padrão e grupos de configuração
No Baileys, o formulário exibe o método de pareamento, alertas operacionais, nome do canal e configurações específicas da biblioteca.
Imagem ampliada
  1. 1

    Acesse Configuração > Configurações > Sessões.

  2. 2

    Selecione Adicionar Canal.

  3. 3

    Escolha Baileys ou WWebJS conforme o conector aprovado.

  4. 4

    Informe um nome interno claro, sem telefone, senha ou outro dado sensível.

  5. 5

    Ative Canal padrão somente quando esse canal realmente deva ser a opção principal da operação.

  6. 6

    Em Atribuições, escolha Chat Flow, fila ou usuário conforme o roteamento planejado; evite um usuário fixo quando a fila fará a distribuição.

  7. 7

    Revise os campos exibidos e salve uma única vez.

  8. 8

    Atualize a lista e abra a sessão criada.

Formulário Novo Canal com WWebJS e código de pareamento ativo
WWebJS compartilha os campos essenciais de conexão, mas não apresenta todos os grupos específicos do Baileys. Configure somente o que a tela da biblioteca escolhida exibir.
Imagem ampliada

WWebJS compartilha os campos essenciais de conexão, mas não apresenta todos os grupos específicos do Baileys. Configure somente o que a tela da biblioteca escolhida exibir.

Abrir imagem original em nova aba ↗

Autorizar por QR Code ou código de pareamento

Formulário Baileys com a opção Usar código de pareamento e campo de número com DDI
Quando o código de pareamento estiver disponível, informe o número exato com DDI, sem sinal de mais, espaços ou pontuação.
Imagem ampliada
  1. 1

    Para usar QR Code, mantenha Usar código de pareamento desligado, crie o canal e solicite o código na sessão.

  2. 2

    No celular autorizado, abra o WhatsApp, acesse Dispositivos conectados e leia o QR Code exibido.

  3. 3

    Para usar código de pareamento, ative a opção antes de criar o canal e informe o número exato com DDI, sem +, espaços ou pontuação.

  4. 4

    Siga no aparelho o fluxo de vinculação apresentado para concluir o código de pareamento.

  5. 5

    Aguarde a mudança do estado da sessão antes de atualizar a tela ou gerar outro código.

  6. 6

    Confirme que o número vinculado é o número de teste planejado.

  7. 7

    Considere a autorização concluída somente quando o cartão da sessão indicar conexão estabelecida ou CONNECTED.

Validar entrada, resposta e roteamento

Controles da tela de Sessões para atualizar e adicionar canais
Atualize a lista para confirmar o estado da conexão antes de iniciar o teste de mensagens.
Imagem ampliada
  1. 1

    Envie uma mensagem simples de outro número de teste para o canal conectado.

  2. 2

    Localize o ticket em Atendimento e confira canal, contato, fila e responsável.

  3. 3

    Assuma o ticket, responda pelo Atendeu Rápido e confirme o recebimento no aparelho de teste.

  4. 4

    Envie uma segunda mensagem e confirme que o ticket existente foi atualizado sem duplicidade.

  5. 5

    Recarregue Sessões e confirme que o canal permanece conectado.

  6. 6

    Libere o uso somente depois que entrada, saída e roteamento forem aprovados.

Recuperar a sessão sem duplicar o canal

  • QR Code expirou: gere outro código na mesma sessão.
  • Estado não atualiza: use Atualizar e aguarde antes de repetir o pareamento.
  • Sessão desconectou: confirme internet, funcionamento do aplicativo e estado do aparelho.
  • Mensagens não chegam: confira sessão, fila, usuários vinculados e o ticket de teste.
  • Sessão conectada e funcionando: não desconecte nem recrie apenas para testar outro método.
  • Falha persiste: registre horário, nome do canal, estado visível e resultado do teste sem expor QR Code ou telefone completo.