Sobre este guia
Este guia mostra como migrar uma caixa de entrada do WhatsApp conectada por cadastro incorporado (embedded signup) para a configuração manual da API do WhatsApp Cloud. A migração preserva a caixa existente — conversas, contatos, colaboradores, regras de distribuição, horário de atendimento, CSAT e configurações de bot continuam intactos.
Antes de começar (Coexistência): se o seu número também é usado no aplicativo WhatsApp Business, fale com o nosso suporte antes de iniciar — números com Coexistência ainda estão em avaliação.
Pré-requisitos
Reúna estes três dados da API do WhatsApp Cloud na Meta:
- ID da Conta do WhatsApp Business (WABA ID) — a conta dona do número;
- ID do número de telefone (Phone Number ID) — identificador único do seu número na Meta;
- Token de acesso permanente — token de usuário do sistema (system user) com permissões do WhatsApp.
Etapa 1 — Obter os dados na Meta
- Acesse o Meta for Developers e crie ou selecione um app, escolhendo o caso de uso "Connect with customers through WhatsApp";
- Selecione o portfólio de negócios dono da Conta do WhatsApp Business e finalize com "Create app";
- Abra Use cases → Connect with customers through WhatsApp → Customize → API Setup (em apps antigos: WhatsApp → API setup);
- Em "Send and receive messages", escolha um número existente ou clique em "Add phone number" (para número novo: nome de exibição, dados da empresa, verificação por SMS/ligação e código OTP);
- Copie o Phone Number ID e o WABA ID — costumam aparecer perto do número no campo "From".
Etapa 2 — Gerar o token permanente
- Abra o Meta Business Settings e selecione o portfólio dono da Conta do WhatsApp Business;
- Vá em Users → System users e selecione (ou crie, função Admin) um usuário do sistema;
- Clique em "Generate token", escolha o app da Etapa 1 e defina a expiração como "Never";
- Marque as permissões whatsapp_business_messaging, whatsapp_business_management e whatsapp_business_manage_events, gere e copie o token.
Mantenha o token em segredo. Qualquer pessoa com acesso a ele pode usar a sua conexão. Não compartilhe e não salve em repositórios.
Etapa 3 — Migrar na plataforma
- Na sua conta NexaOmni, vá em Configurações → Caixas de entrada e abra a caixa do WhatsApp conectada por cadastro incorporado;
- Clique em "Iniciar migração manual" para abrir o assistente;
- Passo 1: revise o que é preservado (conversas, contatos, colaboradores, regras, horário, configurações) e o que é atualizado (WABA ID, Phone Number ID, token, webhook);
- Passo 2: informe WABA ID, Phone Number ID e o número exibido;
- Passo 3: cole o token de acesso permanente (com as três permissões acima);
- Passo 4: revise e clique em "Reconectar caixa de entrada do WhatsApp". As credenciais são verificadas junto à Meta antes de aplicar — se falhar, a configuração atual permanece intacta.
Depois da migração
A caixa continua a mesma; só a conexão passa a usar a configuração manual da API. Confirme que estão funcionando: recebimento de mensagens, envio de respostas, envio e sincronização de templates e entrega de webhooks.
Ficou com dúvida em alguma etapa? Fale com o nosso suporte.