Este guia ajuda você a migrar uma caixa de entrada existente do WhatsApp Cloud para a configuração manual no RockZap®. A migração mantém sua caixa de entrada existente intacta. Conversas, contatos, colaboradores, regras de roteamento, horários de atendimento, configurações de CSAT, configurações de bot e outras configurações da caixa de entrada são preservadas.

> ***Números do WhatsApp com suporte à Coexistência estão atualmente sob análise. Se o seu número do WhatsApp também é usado no WhatsApp Business App, entre em contato com o Suporte RockZap® antes de iniciar essa migração.***

Antes de iniciar a migração, reúna os detalhes necessários da API do WhatsApp Cloud da Meta: WABA ID, ID do Número de Telefone e um token de acesso permanente de usuário do sistema. Use as etapas abaixo para criar ou selecionar um app Meta, adicionar ou selecionar o número do WhatsApp e gerar o token.

## **Obtenha seus detalhes da API do WhatsApp Cloud na Meta**

Para concluir a migração, você precisará de três informações da Meta:

* **ID da Conta Comercial do WhatsApp**

* **ID do Número de Telefone**

* **Token de acesso permanente ou token de usuário do sistema**

Você pode obter o ID da Conta Comercial do WhatsApp e o ID do Número de Telefone no seu app Meta.

### **Crie ou selecione um app Meta**

Acesse [**Meta for Developers**](https://developers.facebook.com/apps/) e selecione um app existente ou clique em **Create App**.

![](https://app.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBNGltRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--f1aca91fef95fb7ae50c498b74f6f11d47638f3f/choose-or-create-app.png)

\
Se estiver criando um novo app, insira um nome para o app e um e-mail de contato, depois clique em **Next**.

![](https://app.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBNG1tRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--0f8f5ef76a3ddf3ed8cfd95fbe90574d7e1f2cc0/create-app.png)

### **Escolha o caso de uso do WhatsApp**

Na tela de seleção de caso de uso, escolha **Connect with customers through WhatsApp** e clique em **Next**.

![](https://app.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBNHltRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--34298798e64e9830bd45e748fa1d1c642884c526/choose-whatsapp-use-case.png)

### **Escolha um portfólio de negócios**

Selecione o portfólio de negócios que possui ou possuirá sua Conta Comercial do WhatsApp.

Se você ainda não tiver um portfólio de negócios, poderá criar um nesta etapa ou continuar e criá-lo depois, se a Meta permitir.

![](https://app.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBNFdtRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--651f9698dff32663bb8653ce030e15cb4e2d000b/choose-portfolio.png)

### **Revise os requisitos de publicação**

A Meta pode mostrar requisitos de publicação para o app e caso de uso selecionados. Revise os requisitos e clique em **Next**.

![](https://app.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBNHVtRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--04ea05818686c9f6b207257fa233984ab1a9acd2/publishing-requirments.png)

### **Revise e crie o app**

Revise os detalhes do app, o caso de uso do WhatsApp selecionado e o portfólio de negócios conectado. Clique em **Create app** para finalizar.

![](https://app.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBNDJtRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--53a748563235e4d07e81217c03710c9a0bc05288/review.png)

### **Abra a configuração da API do WhatsApp**

Depois que o app for criado ou selecionado:

1. Clique em **Use cases** na barra lateral.

2. Encontre **Connect with customers through WhatsApp**.

3. Clique em **Customize**.

4. Clique em API Setup.

![](https://app.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBNGFtRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--d28e202e4877e4654b9a686374bb709e29d4487c/use-case.png)

Na nova interface do app Meta, vá para **Basic setup → Step 2. Production setup** e abra **Register your WhatsApp phone number**.

![](https://app.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBNXVtRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--c7ed8ac132641cddb45ca793ebb17d635ea3a4a3/new-ui-add-or-use-number.png)

Em apps Meta antigos, abra **WhatsApp → API setup** na barra lateral esquerda.

![](https://app.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBNUNtRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--e8c01bf489e7ea14896ba3c4cbc932f532262d25/old-ui-api.png)

### **Adicione ou selecione seu número do WhatsApp**

Na seção **Send and receive messages** ou **Register your WhatsApp phone number**, escolha um número existente no seletor **From**, ou clique em **Add phone number**.

\
Se estiver adicionando um novo número:

1. Insira o nome de exibição do seu negócio no WhatsApp e os detalhes do negócio.

2. Insira o número de telefone.

3. Escolha a verificação por SMS ou ligação telefônica.

4. Insira o código OTP da Meta para verificar o número.

![](https://app.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBNHFtRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--6173823bbd35b3ae6a53df0866fe6120340fc906/create-business-portfolio.png)

![](https://app.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBNUdtRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--84d812fc0b86937786b655c691d3351a5db19737/add-number.png)

### **Copie os IDs necessários**

Após adicionar ou selecionar o número, copie estes valores da página de configuração da API:

* **Phone Number ID**

* **WhatsApp Business Account ID**

Você precisará colar esses valores durante o fluxo de migração do RockZap®.

![](https://app.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBNCttRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--8e2f6cb4fd2d032c5283debcdb05c1d428266104/CleanShot-202026-07-16-20at-2012.38.30@2x.png)

Na interface antiga do Meta, esses valores aparecem diretamente abaixo do seletor **From** em **WhatsApp → API setup**.

![](https://app.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBNVNtRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--0417c7eccc8bce4645feeca21f7fb5468d631787/CleanShot-202026-07-16-20at-2012.39.36@2x.png)

> *A Meta altera esta interface com frequência. Se sua tela estiver diferente, procure pela página de configuração da API do WhatsApp e pelo número do remetente selecionado. O Phone Number ID e o WhatsApp Business Account ID geralmente são exibidos próximos ao telefone **From** selecionado.*

## **Configure um token de acesso permanente da API do WhatsApp Cloud**

Você também precisa de um token permanente de usuário do sistema com permissões do WhatsApp. Esse token permite que o RockZap® conecte-se ao seu número da API do WhatsApp Cloud, envie e receba mensagens e sincronize templates de mensagens.

### **Abra usuários do sistema nas Configurações de Negócios da Meta**

1. Abra as [**Configurações de Negócios da Meta**](https://business.facebook.com/settings).

2. Selecione o portfólio de negócios que possui sua Conta Comercial do WhatsApp.

3. Vá para **Users → System users**.

4. Se você já possui um usuário do sistema para o RockZap®, selecione-o.

5. Se não tiver, clique em **Add**.

![](https://app.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBNUttRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--3a50cbfacf5eb71712b568696f40dfd98ad0e029/CleanShot-202026-07-16-20at-2012.43.38@2x.png)

### **Crie um usuário do sistema**

1. Insira um nome para o usuário do sistema, como **`rockzap WhatsApp`**.

2. Selecione **Admin** como a função do usuário do sistema.

3. Clique em **Create system user**.

![](https://app.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBNGVtRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--cb2b6d822cab04aebe253f7876a7e8ab9977c899/CleanShot-202026-07-16-20at-2012.45.15@2x.png)

### **Gere um token**

1. Selecione o usuário do sistema.

2. Clique em **Generate token**.

![](https://app.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBNXFtRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--ed4dac543234de159a8f0240ef7a6b4bf35bda37/CleanShot-202026-07-16-20at-2012.43.38@2x-20copy.png)

### **Selecione o app Meta**

Escolha o app Meta que você criou ou selecionou anteriormente para a configuração da API do WhatsApp Cloud, depois clique em **Next**.

![](https://app.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBNU9tRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--7326b0e2b690e9c02dfed29098a072db54ba03d0/CleanShot-202026-07-16-20at-2012.45.37@2x.png)

### **Defina a expiração do token**

Selecione **Never** como expiração do token e clique em **Next**.

![](https://app.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBNVdtRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--ef8e5a29a9f9510d05747fe28c0d56a6501f96c3/CleanShot-202026-07-16-20at-2012.45.48@2x.png)

### **Atribua permissões**

Selecione as permissões necessárias do WhatsApp:

* **`whatsapp_business_messaging`**

* **`whatsapp_business_management`**

* **`whatsapp_business_manage_events`**

Em seguida, continue para gerar o token.

![](https://app.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBNWFtRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--579b8af151b0ab657590b915d37f3eef4dc83aac/CleanShot-202026-07-16-20at-2012.46.27@2x.png)

### **Copie o token**

Depois que a Meta criar o token, clique em **Copy** e armazene-o com segurança. Você irá colar este token na etapa **Access token** no fluxo de migração do RockZap®.

![](https://app.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBNXltRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--f625cd18c6e2d2a58a89b3cf18d9f8f240242f2a/CleanShot-202026-07-16-20at-2012.47.35@2x.png)

> *Mantenha este token privado. Qualquer pessoa com acesso a ele pode usar sua conexão da API do WhatsApp Cloud.*

## **Inicie a migração**

1. Vá para **Settings → Inboxes**.

2. Abra a caixa de entrada do WhatsApp conectada via cadastro incorporado.

3. Clique em **Start manual migration**.

![](https://app.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBNTJtRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--9ab619d515d0875d39164975ce2cadda39d82a60/CleanShot-202026-07-13-20at-2014.28.42@2x.png)

O RockZap® abrirá um fluxo guiado de migração.

## **Passo 1: Revise o que será alterado**

A primeira etapa explica o que será preservado e o que será atualizado.

Preservado:

* Conversas

* Contatos

* Colaboradores

* Roteamento

* Horário de atendimento

* Configurações da caixa de entrada

Atualizado:

* WABA ID

* Phone Number ID

* Access token

* Configuração do Webhook

![](https://app.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBNDZtRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--03d0836a29faef23db011373981fab134406601a/CleanShot-202026-07-13-20at-2014.30.08@2x.png)

Clique em **Continue**.

## **Passo 2: Insira os detalhes do negócio**

Insira os dados do ativo WhatsApp obtidos na Meta.

Campos:

* **WABA ID**: A Conta Comercial do WhatsApp que possui este número de telefone.

* **Phone Number ID**: O ID exclusivo da Meta para o número do WhatsApp conectado a esta caixa de entrada.

* **Display phone number**: O número do WhatsApp exibido para o cliente. Este não pode ser alterado durante a migração.

![](https://app.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBNWVtRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--ce7e2dd66b009f7f0f314b85935f589a99c99163/CleanShot-202026-07-13-20at-2014.35.38@2x.png)

Clique em **Continue**.

## **Passo 3: Adicione o token de acesso**

Cole um token de acesso permanente ou token de usuário do sistema com permissões do WhatsApp. O token deve incluir **whatsapp_business_messaging, whatsapp_business_management e whatsapp_business_manage_events**.

![](https://app.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBNW1tRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--829a6a23d899be5e1cc2ff23b8235aefdde6b7fe/CleanShot-202026-07-13-20at-2014.36.18@2x.png)

## **Passo 4: Revise e reconecte**

Revise a caixa de entrada, o número de telefone, o WABA ID e o Phone Number ID antes de aplicar as alterações.

O RockZap® verificará as credenciais com a Meta antes de aplicar as alterações. Se a verificação falhar, a configuração atual permanecerá inalterada.

![](https://app.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBNWltRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--0ab7453f5e5df58e91fa906adfd2d04b07211f67/CleanShot-202026-07-13-20at-2014.37.18@2x.png)

Clique em **Reconnect WhatsApp inbox** para concluir a migração.

## **Após a migração**

Após a migração ser concluída, a caixa de entrada permanece igual no RockZap® , mas a conexão do WhatsApp passa a usar a configuração manual da API do WhatsApp Cloud.

Você deve verificar:

* Mensagens recebidas

* Respostas enviadas

* Envio de mensagens de template

* Sincronização de template

* Entrega do webhook

## **Precisa de ajuda?**

Se você tiver dúvidas sobre qualquer etapa, entre em contato com o Suporte RockZap®. Podemos te ajudar a verificar os detalhes necessários da Meta e auxiliar na migração.