## 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

1. Acesse o **Meta for Developers** e crie ou selecione um app, escolhendo o caso de uso **"Connect with customers through WhatsApp"**;
2. Selecione o portfólio de negócios dono da Conta do WhatsApp Business e finalize com **"Create app"**;
3. Abra **Use cases → Connect with customers through WhatsApp → Customize → API Setup** (em apps antigos: **WhatsApp → API setup**);
4. 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);
5. Copie o **Phone Number ID** e o **WABA ID** — costumam aparecer perto do número no campo **"From"**.

## Etapa 2 — Gerar o token permanente

1. Abra o **Meta Business Settings** e selecione o portfólio dono da Conta do WhatsApp Business;
2. Vá em **Users → System users** e selecione (ou crie, função **Admin**) um usuário do sistema;
3. Clique em **"Generate token"**, escolha o app da Etapa 1 e defina a expiração como **"Never"**;
4. 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

1. Na sua conta NexaOmni, vá em **Configurações → Caixas de entrada** e abra a caixa do WhatsApp conectada por cadastro incorporado;
2. Clique em **"Iniciar migração manual"** para abrir o assistente;
3. **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);
4. **Passo 2:** informe **WABA ID**, **Phone Number ID** e o número exibido;
5. **Passo 3:** cole o **token de acesso permanente** (com as três permissões acima);
6. **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](https://wa.me/552731991998).