A integração por Coexistência (CoEx) conecta um número de WhatsApp Business à OmniChat sem exigir migração para a Cloud API — as conversas são espelhadas na plataforma em tempo real.
Quando usar essa integração
Use quando o número já opera no WhatsApp Business e a migração para a Cloud API não é possível ou desejável.
Pré-requisitos
Acesso de Administrador no portfólio de negócios da Meta onde o número será incluído
Acesso de Administrador na OmniChat — deve ser no mesmo dispositivo que acessará a Meta
Acesso ao dispositivo ou ao WhatsApp Web do número que será conectado
⚠️ O número precisa estar no WhatsApp Business. Não é possível integrar números no WhatsApp Messenger (versão de consumidores). Se ainda usar o Messenger, converta-o para o WhatsApp Business antes de iniciar.
Visão geral do processo
Etapa | Onde | O que fazer |
1 | OmniChat | Configurar a integração em Configurações > Integrações |
2 | Meta | Autorizar a conexão, selecionar portfólio e número |
3 | Dispositivo | Confirmar conexão via QR Code ou código de acesso |
4 | Meta / OmniChat | Finalizar e aguardar redirecionamento automático |
ℹ️ As telas iniciais e de conclusão da Meta podem variar por conta, mas as etapas internas são idênticas.
Etapa 1 — Integração na OmniChat
No menu lateral, acesse Configurações > Integrações.
Selecione a aba Apps / Chats e clique em + no card WhatsApp Business Coexistence.
Clique em Adicionar novo número.
Confirme as permissões nas duas etapas:
— Etapa 1 — Acesso à conta: autoriza o compartilhamento de dados com a Meta.
— Etapa 2 — Integração do número: confirma as limitações pós-integração (mensagens temporárias, view once, localização em tempo real, lista de transmissão e edição de mensagens ficam indisponíveis).Identifique a integração com um nome.
⚠️ Ao clicar em Próximo na segunda etapa, um modal da Meta será aberto. Não feche a tela da OmniChat e não use outra aba. Todo o processo deve ser concluído antes de iniciar outra integração.
Etapa 2 — Integração na Meta
No modal da Meta, clique em Continuar e selecione o portfólio de negócios desejado. Um novo WABA será criado nesse portfólio.
Na seleção de conta, escolha sempre Conectar um app do WhatsApp Business — mesmo que WABAs da Cloud API já estejam listados.
Digite o número de WhatsApp Business (com DDI e DDD). Se o número não estiver cadastrado no WhatsApp Business, um erro será exibido — nesse caso, converta o número e reinicie.
Escolha como conectar o dispositivo:
Método | Quando usar |
QR Code | Quem está integrando tem acesso físico ao dispositivo ou ao WhatsApp Web |
Código de acesso | O responsável pelo dispositivo está em outro local; o código é enviado para ele inserir no app |
⚠️ O código de acesso expira em aproximadamente 60 segundos.
Etapa 3 — Acesso do dispositivo
O dispositivo receberá uma mensagem do Facebook Business com o botão Connect. Use sempre a última mensagem disponível.
Toque em Connect e confirme clicando em Conectar à Plataforma comercial.
Escolha como compartilhar o histórico:
Opção | Efeito |
Compartilhar todas as conversas (recomendado) | Importa até 180 dias de histórico |
Não compartilhar conversas | Novas conversas iniciadas do zero |
Se optou pelo código de acesso, insira o código exibido no modal da Meta. Aguarde o carregamento (até 45 segundos) e toque em OK.
Etapa 4 — Conclusão na Meta e na OmniChat
Verifique o Nome da conta e selecione o Fuso horário correto. Clique em Avançar.
Revise as permissões que serão concedidas à OmniChat e clique em Confirmar.
Aguarde a tela de carregamento finalizar. ⚠️ Não feche o modal nem a tela da OmniChat.
Clique no botão exibido (Continuar para a configuração de recursos ou Concluir). Não clique no X para fechar.
A OmniChat redirecionará automaticamente para a lista de integrações CoEx.
Erros comuns
Erro | Solução |
Número não encontrado | O número não está no WhatsApp Business. Converta-o primeiro. |
Código de acesso expirado | Clique em Recarregar o código de acesso no modal da Meta. |
Modal fechado antes da conclusão | Reinicie o processo do início. |
Número não aparece na lista da OmniChat | Aguarde e recarregue a página. Se persistir, contate o suporte. |
Visualizando as conversas integradas
Após a integração, todas as conversas do número aparecerão na tela de Conversas.
Dois formatos de relatório estão disponíveis: CSV (todas as conversas) e PDF com insights de IA para apoio à gestão.
✅ Integração concluída! Em caso de dúvidas, contate o suporte informando o número de telefone e o portfólio de negócios da Meta utilizado.