Conectando o WhatsApp por coexistência

Ao final desta aula o seu número estará conectado pela API Oficial da Meta, com o aplicativo do celular funcionando normalmente. Se a sua conta é da API não oficial (conexão por QR Code), esta aula não é a sua: siga Conectando o WhatsApp por QR Code. Se você ainda está na não oficial e quer mudar, faça antes a migração para a API Oficial, que é um caminho sem volta.

O que é o método de coexistência?

É o modo em que o mesmo número roda ao mesmo tempo em três lugares:

• No BotConversa, pela API Oficial da Meta, com robô, Inbox, modelos de mensagem e transmissões;
• No aplicativo do WhatsApp Business do celular e no WhatsApp Web;
• Com os atendentes humanos, do jeito que já trabalham hoje.

Na prática, você adiciona automação sem interromper a operação, que é o medo de quem usa o WhatsApp o dia inteiro e não pode "sair do ar" para migrar. Sem a coexistência, a conexão à API Oficial desconecta o aplicativo do celular.

O que preciso ter antes de começar?

1. Um número de WhatsApp ativo no aplicativo WhatsApp Business do celular. A coexistência exige a versão Business do aplicativo, atualizada.
2. Acesso de administrador ao negócio da empresa no Gerenciador de Negócios da Meta (business.facebook.com). Se você não é administrador, a conexão falha por falta de permissão.
3. Uma conta ativa no BotConversa em um plano com API Oficial.
4. O celular do número em mãos: a validação chega por SMS, ligação ou notificação no aplicativo.

Como conecto?

1. No painel do BotConversa, vá em Configurações → WhatsApp.
2. Clique em Conectar número.
3. Ao iniciar, selecione a opção de API Oficial com coexistência e confirme que quer manter o uso do aplicativo no celular. Escolher o método sem coexistência desconecta o celular.
4. Clique em Continuar com o Facebook e entre com o perfil que administra o Gerenciador de Negócios. Conceda todas as permissões pedidas: negar uma delas é a causa mais comum de erro.
5. Selecione o Gerenciador de Negócios correto e confirme a empresa.
6. Selecione a conta do WhatsApp Business (WABA) existente ou crie uma nova, preenchendo nome da empresa, categoria e fuso horário. Se estiver criando, o passo a passo com telas está em Criando uma conta do WhatsApp Business.
7. Selecione o número, confirme que o método é coexistência e aguarde a validação da Meta. Pode levar alguns minutos.
8. Volte ao painel do BotConversa. O status deve aparecer como Conectado, com o nome de exibição e os limites de mensagens na aba Conta.

Como confirmo que deu certo?

Faça os quatro testes, nesta ordem:

• De outro número, envie uma mensagem para o WhatsApp conectado e confira se ela aparece no Inbox.
• Responda pelo Inbox e veja a resposta chegar no outro celular.
• Abra o aplicativo no celular e confirme que a conversa está lá também, com o histórico intacto.
• Se já tem um fluxo, dispare-o e veja o robô responder. Se ainda não tem, isso é normal: o primeiro fluxo é a aula 10.

Quais erros são comuns e como resolvo?

Sintoma	Causa provável	O que fazer
O número não aparece para seleção	Número não vinculado ao Gerenciador de Negócios ou falta de permissão de administrador	Confira as permissões no Gerenciador de Negócios e se o número está ativo e verificado no aplicativo.
O número vem de outra ferramenta e a conexão é recusada	O vínculo da coexistência continua registrado na Meta, mesmo após sair da plataforma antiga	Desvincule o número pelo aplicativo do celular: Trazendo um número de outra ferramenta.
Erro de permissões ao conectar	Login com um perfil sem acesso administrativo	Refaça o login com um usuário administrador do Gerenciador de Negócios e aceite todas as permissões.
O WhatsApp parou de funcionar no celular	Método sem coexistência selecionado	Refaça a conexão escolhendo explicitamente a opção com coexistência.
Erro de linha de crédito ou moeda	A conta do WhatsApp Business está em outra moeda (por exemplo, USD)	Siga Erro de moeda na conexão com a Meta; o procedimento muda conforme você usa ou não coexistência.
Não conecta a forma de pagamento	Fuso ou método de pagamento inconsistente na conta da Meta	Veja Método de pagamento da conta WABA.
Conectou, mas mensagens do robô não saem	Contato fora da janela de 24 horas sem modelo aprovado	Use um modelo de mensagem aprovado; a aula 8 explica a janela e os modelos.

Outros erros e as mensagens exatas da Meta estão em Erros comuns da API Oficial. Se travar em uma etapa, anote a mensagem antes de tentar de novo: é o que o suporte vai pedir.

O que muda depois de conectar?

• A janela de 24 horas passa a valer. Fora dela, o robô e o Inbox só enviam por modelo de mensagem aprovado pela Meta. Veja Janela de 24 horas e modelos de mensagem.
• As mensagens enviadas pela API têm custo. Fora da janela, cada modelo é cobrado conforme a categoria. A partir de 1º de outubro de 2026, as mensagens enviadas dentro da janela pela API (robô, Inbox e modelos de utilidade) também passam a ser cobradas. Os valores e o que muda estão em Cobrança dentro da janela de 24h.
• O que sai pelo aplicativo do celular não é cobrado como mensagem da API. Na coexistência, o atendente que responde pelo aplicativo continua sem custo por mensagem; a cobrança vale para o que passa pelo BotConversa.
• Os limites de envio começam baixos e crescem com o uso saudável. Veja Limites de mensagens do WhatsApp.