Guia de reconexão: WhatsApp API e WhatsApp API Dual
Aprenda a identificar se o seu canal usa WhatsApp API oficial ou API Dual, o que revisar antes de reconectá-lo e como resolver os problemas mais comuns durante o processo.
Se o seu canal do WhatsApp aparecer desconectado, inativo ou tiver parado de receber mensagens, primeiro você deve identificar que tipo de conexão ele usa. O processo não é o mesmo para WhatsApp API oficial e WhatsApp API Dual.
Não exclua o canal nem crie um novo para testar. Na maioria dos casos, o problema é resolvido reconectando o canal existente — criar um novo pode duplicar o número, perder o histórico e desconectar o funil que você já tinha configurado.
Decisão rápida: que tipo de canal eu tenho?
Você usa o WhatsApp no celular para responder?
Sim → provavelmente você tem API Dual ou QR tradicional.
Não → provavelmente você tem WhatsApp API oficial.
A conexão original foi feita escaneando um código QR?
Sim → verifique se era API Dual ou QR tradicional (seção seguinte).
Não → provavelmente era WhatsApp API oficial.
Se não tiver certeza, não reconecte aleatoriamente: verifique primeiro o tipo de canal que o Vambe mostra, na seção Como acessar a seção de conexão de canais.
1. Diferenças entre WhatsApp API, API Dual e QR
WhatsApp API oficial
Não
Por meio da Meta e da configuração do número
O canal funciona a partir da plataforma do WhatsApp Business API
WhatsApp API Dual
Sim, junto com o Vambe
Por meio de código QR e Meta
Permite usar o app do WhatsApp Business e o Vambe ao mesmo tempo
WhatsApp QR tradicional
Sim
Por meio de vinculação semelhante ao WhatsApp Web
Não é uma conexão API oficial nem uma conexão Dual
WhatsApp API oficial é a conexão direta com a infraestrutura oficial da Meta:
Não se usa o aplicativo do WhatsApp no celular para responder.
O número é registrado dentro de uma conta do WhatsApp Business da Meta.
O número deve poder receber um código por SMS ou ligação durante o registro ou a validação.
Requer acesso ao Business Portfolio ou à conta empresarial correspondente.
Permite usar funções oficiais como modelos, campanhas e automações, sujeitas às políticas da Meta.
WhatsApp API Dual ou Dual Coexistence (também chamada de WhatsApp Coexistence):
Permite usar o app do WhatsApp Business no celular e o Vambe simultaneamente.
A conexão inicial ou a reconexão é feita por meio de um código QR.
Requer uma conta do WhatsApp Business, não uma conta pessoal.
O Business Portfolio da Meta deve estar verificado.
Pode exigir um método de pagamento configurado na Meta para campanhas e mensagens com modelos.
As mensagens enviadas do celular e do Vambe têm regras diferentes.
WhatsApp QR tradicional — importante não confundir com API Dual:
É feito como uma vinculação parecida com o WhatsApp Web.
Não corresponde ao WhatsApp API oficial.
Não oferece as mesmas capacidades de modelos, campanhas e automações oficiais.
Pode depender da sessão do celular conectado.
API Dual e QR tradicional não são a mesma coisa, embora ambos possam usar um código QR. A API Dual usa a conexão oficial do WhatsApp Business e permite trabalhar com o Vambe e o app do WhatsApp Business simultaneamente; o QR tradicional não.
2. Como identificar o tipo de canal
Entre no Vambe.
Abra a seção Canais.
Procure o canal do WhatsApp que apresenta problemas.
Verifique o nome, o número e o tipo de conexão exibido.
Confirme como ele foi conectado originalmente:
Se foi configurado pela Meta e o app do WhatsApp no celular não é usado, provavelmente é WhatsApp API oficial.
Se um código QR foi escaneado pelo app do WhatsApp Business e o celular ainda é usado para responder, provavelmente é API Dual.
Se foi vinculado como WhatsApp Web e não foi configurado como API, provavelmente é um canal QR tradicional.
Sinais rápidos para reconhecê-los
É provavelmente WhatsApp API oficial se:
O número não está ativo no app do WhatsApp do celular.
Um Business Portfolio foi configurado na Meta.
O número foi validado por SMS ou ligação.
Modelos do WhatsApp são usados pelo Vambe.
A conexão aparece como WhatsApp API oficial.
É provavelmente API Dual se:
O número continua funcionando no app WhatsApp Business.
O celular é usado para responder conversas.
A conexão foi feita escaneando um código QR.
O canal aparece como Dual, Coexistence ou uma denominação semelhante.
É possível responder pelo celular e pelo Vambe.
É provavelmente QR tradicional se:
Conecta-se de forma semelhante ao WhatsApp Web.
Não existe uma configuração de WhatsApp Business API na Meta.
O canal não tem funções oficiais de API.
A conexão depende de uma sessão ativa no celular.
3. O que verificar antes de reconectar
Acessos necessários
Acesso à conta do Vambe.
Permissões suficientes para administrar canais.
Acesso de administrador ou administrador técnico ao Business Portfolio da Meta.
Acesso à conta do WhatsApp Business correspondente.
Acesso ao celular que usa o número, se for API Dual.
Informações do canal — tenha em mãos:
O nome interno do canal no Vambe.
O número completo com código do país.
Os últimos dígitos do número, para evitar confundi-lo com outro.
O tipo de conexão.
O Business Portfolio da Meta associado.
A conta do WhatsApp Business correspondente.
Condições técnicas — verifique que:
O celular tenha conexão estável com a internet.
O navegador esteja atualizado.
As janelas pop-up não estejam bloqueadas.
O celular tenha bateria suficiente.
O app WhatsApp Business esteja atualizado, se você estiver usando API Dual.
O usuário tenha permissão para escanear códigos QR ou administrar dispositivos vinculados.
O número possa receber SMS ou ligações, se a Meta solicitar uma verificação.
Ninguém mais esteja tentando registrar ou reconectar o mesmo número ao mesmo tempo.
Não compartilhe códigos de verificação, senhas nem códigos QR.
Não exclua o número da Meta antes de confirmar que tipo de conexão ele precisa.
Não crie um novo canal para substituir um desconectado sem revisar o canal original.
Não abra vários processos de conexão em guias diferentes.
Se o assistente, o funil ou as conversas forem importantes para a operação, confirme que o canal original ainda está associado ao funil correto antes de tocar em qualquer coisa.
4. Como reconectar o WhatsApp API oficial
Use este procedimento quando o canal for uma conexão oficial do WhatsApp API e você não usar o aplicativo do WhatsApp no celular.
Abrir a seção de canais
Entre no Vambe.
Abra Canais.
Localize o canal do WhatsApp que aparece desconectado ou com problemas.
Verifique se o Vambe mostra uma opção como Reconectar, Conectar novamente ou uma ação equivalente.
Se o canal original aparecer disponível para reconexão, use esse canal. Evite criar um novo.
Confirmar a conta da Meta
Quando o processo da Meta abrir:
Confirme que você está usando o Business Portfolio correto.
Verifique se a conta tem permissões de administrador.
Selecione a conta do WhatsApp Business correspondente ao número.
Confirme que você está trabalhando com o número correto.
Um dos erros mais comuns é entrar com uma conta pessoal ou com um Business Portfolio diferente daquele que originalmente administrava o canal.
Confirmar ou registrar o número
Dependendo do estado do canal, a Meta pode mostrar uma opção para confirmar um número existente, autorizar novamente a conexão, adicionar um número de telefone ou registrá-lo novamente.
Se a Meta mostrar um número que você não reconhece, pare o processo e revise a conta antes de continuar.
Se aparecer a opção para registrar um número:
Selecione Adicionar novo número de telefone.
Digite o número com seu código de país.
Selecione o método de verificação: SMS ou ligação telefônica.
Digite o código recebido.
Conclua o processo na Meta.
Volte ao Vambe e continue com a verificação se a plataforma solicitar.
Em alguns fluxos, o código recebido deve ser usado primeiro na Meta e depois novamente no Vambe. Siga exatamente as instruções que aparecem na tela.
Finalizar a conexão
Confirme que a Meta terminou a configuração.
Volte ao Vambe.
Verifique se o canal muda para um status conectado ou ativo.
Confirme se o número e o nome do canal estão corretos.
Verifique se o canal continua associado ao funil correto.
Fazer um teste
Envie uma mensagem para o número a partir de outro celular.
Envie uma resposta pelo Vambe, respeitando as regras do WhatsApp para conversas abertas e modelos.
5. Como reconectar o WhatsApp API Dual
Use este procedimento quando o número continuar funcionando no app WhatsApp Business e também precisar ser usado no Vambe.
Preparar o celular
Abra o app WhatsApp Business.
Confirme que você está usando a conta correta.
Verifique se o número corresponde ao canal do Vambe.
Verifique se o celular tem conexão com a internet.
Mantenha o app aberto durante o processo.
Certifique-se de que o app esteja atualizado.
A função Dual não corresponde a uma conta pessoal do WhatsApp. Ela deve ser usada com o WhatsApp Business.
Confirmar os requisitos da Meta
Antes de escanear o código QR, verifique se:
O Business Portfolio está verificado.
Você tem permissões para administrar a conta.
A conta do WhatsApp Business corresponde ao número correto.
Existe um método de pagamento configurado na Meta, se forem usados modelos ou campanhas.
Não há outro processo de vinculação aberto.
Iniciar a reconexão pelo Vambe
Entre em Canais.
Localize o canal Dual desconectado.
Selecione a opção de reconexão que o Vambe mostrar.
Aguarde até que o código QR apareça.
Não use uma captura de tela antiga. O código QR pode mudar e deve ser escaneado diretamente da tela ativa do Vambe.
Escanear o código QR
No app WhatsApp Business:
Abra Configurações ou o menu de opções.
Entre em Dispositivos vinculados.
Selecione Vincular um dispositivo.
Autorize a ação se o app solicitar.
Escaneie o código QR que aparece no Vambe.
Se o código expirar, gere um novo e escaneie novamente.
Confirmar a vinculação
Aguarde o Vambe confirmar a conexão.
Verifique se o canal aparece ativo.
Confira se o celular continua mostrando a vinculação correspondente.
Confirme se o canal continua conectado ao funil correto.
Fazer testes dos dois lados
Envie uma mensagem pelo celular.
Responda pelo Vambe.
Envie uma mensagem de outro número para o canal.
Confirme se a conversa aparece no Vambe.
6. O que fazer se a reconexão não funcionar
O código QR não aparece
Verifique se: você está reconectando um canal Dual e não um canal API oficial; o navegador não está bloqueando a tela de conexão; não há outro processo aberto em uma guia diferente; o canal ainda existe no Vambe; a sessão anterior não ficou pela metade. Se a tela ficar em branco, atualize a página uma vez e entre novamente no canal — não abra muitos processos simultâneos.
O código QR expirou
Os códigos QR são temporários. Feche o código anterior, solicite ou gere um novo, abra o WhatsApp Business no celular, acesse Dispositivos vinculados e escaneie o novo código diretamente da tela. Não tente escanear uma captura de tela antiga.
O WhatsApp não permite escanear o código
Verifique se: você está usando o WhatsApp Business e não o WhatsApp pessoal; o app está atualizado; a câmera tem permissões; o brilho da tela é suficiente; o celular tem conexão com a internet; o código não expirou; o limite de dispositivos vinculados não foi atingido.
A Meta indica que o número já está conectado
Essa mensagem pode aparecer porque o número já está associado a outra conta do WhatsApp Business, ainda está vinculado a uma conexão anterior, um novo processo foi iniciado em vez de reconectar o canal existente, foi escolhido um Business Portfolio errado, ou o número está ativo em um app incompatível com o tipo de conexão escolhido.
Não exclua a conta nem desvincule o número sem confirmar primeiro qual é a conexão correta. Se o número já pertence a um canal funcional, tente reconectar esse canal em vez de registrá-lo novamente.
O código por SMS não chega
Verifique o código do país, a cobertura do celular, se o número pode receber SMS, se não há chamadas ou mensagens internacionais bloqueadas e se não foram solicitados códigos demais em sequência. Se estiver disponível, tente a opção de ligação telefônica. Não compartilhe o código com outra pessoa nem o insira em uma página que não seja a Meta ou o Vambe.
A Meta mostra o Business Portfolio errado
Cancele o processo, faça logout da Meta se necessário, entre novamente com o usuário administrador correto, confirme o Business Portfolio associado ao canal e repita a reconexão pelo canal existente. Se você não tiver acesso ao Business Portfolio correto, será necessário que um administrador da Meta faça a reconexão.
A conta da Meta não está verificada
A conexão Dual exige um Business Portfolio verificado. Se a Meta solicitar a verificação da empresa, verifique o status de verificação na Meta Business, conclua a verificação solicitada, confirme que a conta aparece como verificada e reinicie o processo de reconexão. Não tente resolver a falta de verificação criando outro canal.
O canal aparece conectado, mas não recebe mensagens
Verifique nesta ordem: se o número usado pelo cliente está correto; se o canal está ativo no Vambe; se o canal continua conectado a um funil; se o funil tem uma primeira etapa válida; se existe um assistente atribuído a essa etapa; se a mensagem de teste não está sendo enviada do mesmo celular administrador; se não existem restrições ou bloqueios na Meta.
O canal recebe mensagens, mas o assistente não responde
A reconexão pode estar correta. Verifique se o canal está associado a um funil, se o assistente está ativo, se o contato foi enviado para a etapa correta, se existe uma configuração para não responder, se a mensagem está dentro das regras de atendimento do WhatsApp ou se é necessário usar um modelo porque a janela de 24 horas está fechada.
Um canal duplicado foi criado
Não continue testando em ambos os canais. Primeiro identifique qual é o canal original, qual tem o histórico e a configuração corretos, qual está conectado ao funil e qual usa o número correto. Depois, peça ajuda antes de excluir qualquer um dos canais — excluir o canal errado pode afetar a operação e as associações existentes.
7. Lista de verificação final
A reconexão pode ser considerada concluída quando todos estes pontos forem atendidos:
O canal aparece como conectado ou ativo.
O número está correto.
O tipo de conexão corresponde à configuração original.
O Business Portfolio selecionado é o correto.
Na API Dual, o celular aparece vinculado corretamente.
O canal está conectado ao funil correspondente.
Uma mensagem de teste é recebida.
É possível responder pelo Vambe.
Na API Dual, é possível responder pelo celular.
A mensagem chega ao contato correto.
Não existe um segundo canal duplicado para o mesmo número.
A equipe sabe de onde deve responder e quais regras se aplicam.
8. Quando solicitar ajuda
Solicite suporte se:
Você não sabe se o canal é API, Dual ou QR.
A Meta mostra uma conta ou número que você não reconhece.
O número aparece conectado a outra conta e você não sabe qual.
O Business Portfolio correto não aparece.
Você não tem permissões de administrador.
A reconexão termina, mas o canal continua desconectado.
O canal está conectado, mas as mensagens não chegam depois de realizar os testes.
Há dois canais com o mesmo número.
O processo solicita excluir ou desvincular informações e você não tem certeza das consequências.
Informações que você deve enviar ao suporte
Nome interno do canal.
Últimos dígitos do número.
Tipo de conexão, se você souber.
Mensagem exata do erro.
Captura de tela do erro.
Etapa em que a reconexão parou.
Se o número funciona no app WhatsApp Business.
Se o Business Portfolio está verificado.
Se o canal aparece conectado a um funil.
Nunca envie: senhas, códigos de verificação, tokens, códigos QR, nem dados de acesso à Meta.
Perguntas frequentes
WhatsApp API e API Dual são a mesma coisa? Não. Ambas são conexões oficiais relacionadas à Meta, mas funcionam de forma diferente. O WhatsApp API oficial é usado pela plataforma e não requer o app do WhatsApp no celular. A API Dual permite usar o app WhatsApp Business e o Vambe ao mesmo tempo.
Posso reconectar a API Dual sem o celular? Não. Para a API Dual você precisa acessar o celular que tem a conta do WhatsApp Business instalada, porque deve escanear o código QR pela seção de dispositivos vinculados.
Posso conectar um número pessoal como API Dual? Não. A API Dual requer uma conta do WhatsApp Business.
Posso usar o mesmo número no WhatsApp API oficial e na API Dual? Você não deve iniciar duas conexões diferentes com o mesmo número sem confirmar primeiro a configuração compatível. Fazer isso pode causar conflitos, duplicidades ou erros de registro.
A reconexão apaga as conversas? Não se deve assumir que as conversas serão apagadas nem que serão mantidas automaticamente. Por isso é importante não excluir o canal nem registrar novamente o número sem confirmar o procedimento correto.
Por que posso responder pelo celular, mas não pelo Vambe? Na API Dual, o celular e o Vambe têm regras diferentes. Se a conversa estiver fora da janela de atendimento de 24 horas, pelo Vambe pode ser necessário usar um modelo aprovado.
Por que o canal aparece conectado, mas o assistente não responde? A conexão do canal é apenas uma parte da configuração. Você também deve verificar se o canal está associado a um funil e se existe um assistente ativo na etapa correspondente.
Os clientes veem o nome do canal? Não. É um nome interno para identificá-lo dentro do Vambe. Os clientes recebem as mensagens pelo número associado.
Em resumo
Se depois de seguir estes passos o canal continuar desconectado, não exclua a conexão nem registre o número novamente. Guarde a mensagem de erro e peça ajuda informando o nome do canal, os últimos dígitos do número e a etapa exata em que a reconexão falhou.
Atualizado
Isto foi útil?