Tempo de leitura: ~10 minPara quem é: Quem usa ou vai usar a API Oficial
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?
Um número de WhatsApp ativo no aplicativo WhatsApp Business do celular. A coexistência exige a versão Business do aplicativo, atualizada.
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.
Uma conta ativa no BotConversa em um plano com API Oficial.
O celular do número em mãos: a validação chega por SMS, ligação ou notificação no aplicativo.
Como conecto?
No painel do BotConversa, vá em Configurações → WhatsApp.
Clique em Conectar número.
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.
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.
Selecione o Gerenciador de Negócios correto e confirme a empresa.
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.
Selecione o número, confirme que o método é coexistência e aguarde a validação da Meta. Pode levar alguns minutos.
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
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.