Este guia ajuda você a migrar uma caixa de entrada existente do WhatsApp Cloud para a configuração manual no Chatwoot. 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 Chatwoot 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.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCUFZCNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--1f606325708a807b616377c294d8f6ab773405c4/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.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCRFJDNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--a289d00dec522df84ce9008ea0fdb583f32bdd77/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.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCRkZDNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--a530ad1de8ee93a4cb598179012b8bd3e7fecfca/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.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCSUJDNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--84077f3925813b62827752465f321f3f7850b7cc/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.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCS0pDNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--8a8ee0aa597971b88d6b962b88b3590f73f8aae8/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.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTnRONHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--cb19f0f9ed989a0fa8a59f8aeed546ba7daa5b05/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.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCUFpENHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--6d166ce9f67c24dd28dc4584f38ad4cd42eba7d2/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.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCR1JPNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--ea20129b52437bce02873cb8b19e369f3dc1f8d9/new-ui-add-or-use-number.png)

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

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTDVENHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--52d9b1ad6ec3ab149aea026c3422be5b5ec92963/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.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCSXhGNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--06635673d9dca75d676567697983cc9c3b1dd7bc/create-business-portfolio.png)

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCRXhGNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--2d87c35170f160b0d364c77df3e0813651d013fb/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 Chatwoot.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTlZHNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--99eb8165e60d568bb5987af12c8c1f0fa4bb3a99/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.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCRlJINHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--2d69164afa5b86f0c022c56a8e44f40fdf8281ba/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 Chatwoot 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 Chatwoot, selecione-o.

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

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCT1JJNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--1c0d8becbf722cab74bf2309dfe1f9943c097f4e/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 `Chatwoot WhatsApp`.

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

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

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCSkpMNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--52471a7d920c432a30fe0da42721f9af4e8491c6/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.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCRTlNNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--3fc13f84c0551ec2ebb5d567885d6827c8c1c9df/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.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCSGRNNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--d7d7bf129b54cfb283abaeb0b456a8b2f82b6323/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.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCS3RNNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--4882df87fe944d64630f8cefcf2bcc3093b660b9/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.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTVpNNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--6a69a730f132fcc05663f8bef110e817b6f54d35/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 Chatwoot.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCT2hNNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--3dadfaa25557bb093bb7af3713c2f5264befda82/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.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCRllnMndVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--0fed8e7f92b6a0dacb1a1ca68422eeec6a431a47/CleanShot%202026-07-13%20at%2014.28.42@2x.png)

O Chatwoot 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.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCT01nMndVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--9e1d089787f62140ca6ee62fb27f44417f083d5c/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.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCRkFrMndVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--3554a80c878cdecba4de08b8c42ed6cb1a5a98fd/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.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCSTBrMndVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--365e188d56d91c2b5adf3f3030e484f0e71d9614/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 Chatwoot 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.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCRThsMndVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--57a16743b6aad7c8870c8e50e96c37ef93e271a7/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 Chatwoot, 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 Chatwoot. Podemos te ajudar a verificar os detalhes necessários da Meta e auxiliar na migração.