> For the complete documentation index, see [llms.txt](https://academy.vambe.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.vambe.ai/canal/canal-pt-br/conexao-de-canais-da-vambe/guia-de-reconexao-whatsapp-api-e-whatsapp-api-dual.md).
# 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.
{% hint style="danger" %}
**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.
{% endhint %}
***
### 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](https://academy.vambe.ai/canal/conexion-de-canales-de-vambe/como-ingresar-a-la-seccion-de-conexion-de-canales).
***
## 1. Diferenças entre WhatsApp API, API Dual e QR
| Tipo de conexão | Usa o app do WhatsApp no celular? | Como se conecta? | Principais características |
| --------------------------- | --------------------------------- | ------------------------------------------------- | ---------------------------------------------------------------- |
| **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.
{% hint style="warning" %}
**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.
{% endhint %}
***
## 2. Como identificar o tipo de canal
1. Entre no Vambe.
2. Abra a seção **Canais**.
3. Procure o canal do WhatsApp que apresenta problemas.
4. Verifique o nome, o número e o tipo de conexão exibido.
5. 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.
{% hint style="danger" %}
* 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.
{% endhint %}
***
## 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.
{% stepper %}
{% step %}
**Abrir a seção de canais**
1. Entre no Vambe.
2. Abra **Canais**.
3. Localize o canal do WhatsApp que aparece desconectado ou com problemas.
5. 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.
{% endstep %}
{% step %}
**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.
{% hint style="warning" %}
Um dos erros mais comuns é entrar com uma conta pessoal ou com um Business Portfolio diferente daquele que originalmente administrava o canal.
{% endhint %}
{% endstep %}
{% step %}
**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.
{% hint style="danger" %}
Se a Meta mostrar um número que você não reconhece, **pare o processo** e revise a conta antes de continuar.
{% endhint %}
Se aparecer a opção para registrar um número:
1. Selecione **Adicionar novo número de telefone**.
2. Digite o número com seu código de país.
3. Selecione o método de verificação: SMS ou ligação telefônica.
4. Digite o código recebido.
5. Conclua o processo na Meta.
6. 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.
{% endstep %}
{% step %}
**Finalizar a conexão**
1. Confirme que a Meta terminou a configuração.
2. Volte ao Vambe.
3. Verifique se o canal muda para um status conectado ou ativo.
4. Confirme se o número e o nome do canal estão corretos.
5. Verifique se o canal continua associado ao funil correto.
{% endstep %}
{% step %}
**Fazer um teste**
1. Envie uma mensagem para o número a partir de outro celular.
2. Envie uma resposta pelo Vambe, respeitando as regras do WhatsApp para conversas abertas e modelos.
{% hint style="info" %}
Se a mensagem chega ao canal, mas o assistente não responde, o problema pode não ser a conexão. Verifique se o canal está associado a um funil e se existe um assistente ativo na primeira etapa correspondente.
{% endhint %}
{% endstep %}
{% endstepper %}
***
## 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.
{% stepper %}
{% step %}
**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.
{% hint style="warning" %}
A função Dual não corresponde a uma conta pessoal do WhatsApp. Ela deve ser usada com o WhatsApp Business.
{% endhint %}
{% endstep %}
{% step %}
**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.
{% endstep %}
{% step %}
**Iniciar a reconexão pelo Vambe**
1. Entre em **Canais**.
2. Localize o canal Dual desconectado.
3. Selecione a opção de reconexão que o Vambe mostrar.
4. Aguarde até que o código QR apareça.
{% hint style="warning" %}
Não use uma captura de tela antiga. O código QR pode mudar e deve ser escaneado diretamente da tela ativa do Vambe.
{% endhint %}
{% endstep %}
{% step %}
**Escanear o código QR**
No app WhatsApp Business:
1. Abra **Configurações** ou o menu de opções.
2. Entre em **Dispositivos vinculados**.
3. Selecione **Vincular um dispositivo**.
4. Autorize a ação se o app solicitar.
5. Escaneie o código QR que aparece no Vambe.
Se o código expirar, gere um novo e escaneie novamente.
{% endstep %}
{% step %}
**Confirmar a vinculação**
1. Aguarde o Vambe confirmar a conexão.
2. Verifique se o canal aparece ativo.
3. Confira se o celular continua mostrando a vinculação correspondente.
4. Confirme se o canal continua conectado ao funil correto.
{% endstep %}
{% step %}
**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.
{% hint style="info" %}
Em uma conexão Dual, pelo celular é possível responder usando o app, mas no Vambe aplicam-se as regras do WhatsApp API, incluindo a janela de atendimento de 24 horas. Quando essa janela está fechada, pode ser necessário usar um modelo aprovado para iniciar ou retomar a conversa pelo Vambe.
{% endhint %}
{% endstep %}
{% endstepper %}
***
## 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.
{% hint style="danger" %}
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.
{% endhint %}
**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.
{% hint style="danger" %}
**Nunca envie:** senhas, códigos de verificação, tokens, códigos QR, nem dados de acesso à Meta.
{% endhint %}
***
### 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.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://academy.vambe.ai/canal/canal-pt-br/conexao-de-canais-da-vambe/guia-de-reconexao-whatsapp-api-e-whatsapp-api-dual.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
