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 e selecione um app existente ou clique em Create App.
Se estiver criando um novo app, insira um nome para o app e um e-mail de contato, depois clique em Next.
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.
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.
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.
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.
Abra a configuração da API do WhatsApp
Depois que o app for criado ou selecionado:
-
Clique em Use cases na barra lateral.
-
Encontre Connect with customers through WhatsApp.
-
Clique em Customize.
-
Clique em API Setup.
Na nova interface do app Meta, vá para Basic setup → Step 2. Production setup e abra Register your WhatsApp phone number.
Em apps Meta antigos, abra WhatsApp → API setup na barra lateral esquerda.
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:
-
Insira o nome de exibição do seu negócio no WhatsApp e os detalhes do negócio.
-
Insira o número de telefone.
-
Escolha a verificação por SMS ou ligação telefônica.
-
Insira o código OTP da Meta para verificar o número.
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.
Na interface antiga do Meta, esses valores aparecem diretamente abaixo do seletor From em WhatsApp → API setup.
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
-
Abra as Configurações de Negócios da Meta.
-
Selecione o portfólio de negócios que possui sua Conta Comercial do WhatsApp.
-
Vá para Users → System users.
-
Se você já possui um usuário do sistema para o Chatwoot, selecione-o.
-
Se não tiver, clique em Add.
Crie um usuário do sistema
-
Insira um nome para o usuário do sistema, como
Chatwoot WhatsApp. -
Selecione Admin como a função do usuário do sistema.
-
Clique em Create system user.
Gere um token
-
Selecione o usuário do sistema.
-
Clique em Generate token.
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.
Defina a expiração do token
Selecione Never como expiração do token e clique em Next.
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.
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.
Mantenha este token privado. Qualquer pessoa com acesso a ele pode usar sua conexão da API do WhatsApp Cloud.
Inicie a migração
-
Vá para Settings → Inboxes.
-
Abra a caixa de entrada do WhatsApp conectada via cadastro incorporado.
-
Clique em Start manual migration.
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
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.
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.
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.
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.