Você pode gerenciar as conversas da sua conta empresarial do WhatsApp pelo Chatwoot. Para configurar, você tem duas opções para escolher seu provedor: 1. WhatsApp Cloud API 2. Twilio Explicaremos todos os procedimentos neste guia. ### **Pré-requisitos** 1. Você precisa de uma [**Conta de Desenvolvedor Meta**](https://developers.facebook.com/) para configurar a API do WhatsApp. Se ainda não tem uma conta de desenvolvedor, clique [**aqui**](https://business.facebook.com/business/loginpage/) para criar uma antes de prosseguir. 2. Um número de telefone válido ## **Usando o Whatsapp Cloud API** O [**WhatsApp Cloud API**](https://developers.facebook.com/docs/whatsapp/cloud-api/) está disponível para todas as empresas e desenvolvedores individuais. Como é hospedado na infraestrutura em nuvem da Meta, você não precisa mais usar provedores terceirizados como Twilio, Zendesk, 360Dialog ou MessageBird ([**Business Solution Providers**](https://www.facebook.com/business/partner-directory/search?solution_type=messaging)) para hospedar sua API do WhatsApp Business. ## **Configure seu Perfil Empresarial** Crie um perfil profissional do WhatsApp Business com o nome da sua empresa, descrição e informações de contato. Um perfil bem elaborado ajuda os clientes a reconhecerem e confiarem na sua marca ao interagir com você. Faça login em [**https://business.facebook.com**](https://business.facebook.com/) e clique no botão **criar portfólio** no menu suspenso em "Início" ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCS0l2TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--72176865da87c663b137ddf7e9fcc96a9895ed79/image.png) Preencha todos os campos obrigatórios para configurar seu portfólio empresarial. ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTDB2TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--b97272d17bfd653a869efa3463beb3c4e21c2b32/image.png) Depois de criar seu portfólio empresarial, é hora de criar seu aplicativo do Facebook. ## **Configure seu Aplicativo do Facebook** Faça login em [**https://developers.facebook.com/**](https://developers.facebook.com/) e clique no botão **Criar Aplicativo**. ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTmt2TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--98e9e282f223ba6c1925a9f6d2a7aed9ef6e558e/image.png) Preencha os campos obrigatórios ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCUEF2TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--c3a7a0ccb782a47ec460a8bfcf30cdee6d4902c1/app-2.png) Clique em "Outro" entre as opções ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQUF3TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--ae78ade6835e127f19708f3c51595393cf0755fb/app-3.png) Escolha "Business" como o tipo do seu aplicativo ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQkV3TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--653dc0f0c7137a07fb8605394443b7ce46ac518b/app-4.png) Digite seu e-mail de contato e selecione seu portfólio empresarial no menu suspenso. ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQnd3TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--97420cad25fb464103e356169eeea2b8ee2f882e/app-6.png) ## **Adicionar Whatsapp ao seu aplicativo** Após criar seu aplicativo, você será direcionado ao painel do aplicativo. Lá, clique em **"Adicionar Produto"** e escolha **WhatsApp** na lista de produtos disponíveis. Clique no botão "Configurar" para o WhatsApp ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQ1V3TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--8edbe733b323ed31919bd51914049fa87056c77d/app-7.png) ***Nota:** Antes de prosseguir, verifique sua empresa com a Meta. Você precisará enviar documentação para verificação, o que é obrigatório para acesso completo à API.* ## **Configure um Token de Acesso Permanente para o WhatsApp Cloud API** Você precisará criar um **Usuário do Sistema** e gerar um token permanente para manter o acesso seguro e ininterrupto. Faça login na sua conta de desenvolvedor do Facebook, selecione seu aplicativo do WhatsApp e vá até a [**página de configurações do negócio**](https://business.facebook.com/settings). Clique em "Usuários do sistema" e adicione um novo usuário do sistema com o papel **Admin** ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCRDh3TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--2826694996496e22a3ecf00c12269e7b77a96278/SCR-20250318-tocl.png) Clique no botão "Adicionar Ativos", selecione o nome do seu aplicativo, escolha a opção "Controle Total" e clique em "Atribuir ativos." ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCRWt3TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--4513bf38a22f4f420c5894d64dbff22557732be0/assign-assets.png) Volte para a página de **usuários do sistema**, selecione seu novo usuário na lista e clique no botão "**Gerar novo token**". ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCRnN3TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--28256cc30c4ee638a5e5127fffaa61b5362eea9e/sys-1.png) Selecione seu aplicativo no menu suspenso ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCR3N3TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--85305f422e394fb1aef6c146e19f936c6cd092dd/sys-2.png) Selecione estes três níveis de permissão para seu token: * whatsapp_business_manage_events * whatsapp_business_management * whatsapp_business_messaging ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCSGt3TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--45b91aa4d3d4c4481a8ce37fc1468fd00386b0fb/sys-3.png) Copie e salve seu token ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCSUl3TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--9e96636a7551f8073f4c86108ab8fe3f83cfc5bf/sys-4.png) ## **Configure o WhatsApp Cloud API** Para criar uma nova conta empresarial Meta, selecione "**criar uma conta empresarial**" no menu suspenso. Se você já possui uma conta empresarial, pode selecioná-la nas opções existentes. Estou selecionando "**criar uma conta empresarial**". Clique no botão ***continuar***. ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCSXd3TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--103af678530aa76e8768d7a3d530dd4aef96377e/api-0.png) Cole seu token permanente aqui ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCSnd3TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--403311ae1ce0523a626d6b00dac00e4f74949e6a/api-1.png) Adicione seu número de telefone de produção ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCS013TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--cd7b500250f5adc96b90d8e7e3b8cc5bbdfb77a6/api-2.png)*Nota*: A Meta exige um número de telefone verificado para a configuração da API do WhatsApp. Você pode verificar seu número usando um OTP (senha única). ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTFF3TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--e3505e8fbd4c9400883212aed134a0e6c6743ef4/api-3.png) Depois de adicionar e verificar seu número de telefone, o próximo passo é configurar um webhook para receber mensagens recebidas. ## **Conectando sua Conta Chatwoot** Vamos conectar sua conta do Chatwoot à sua Cloud API do WhatsApp Copie seu WhatsApp Phone Number ID e Business Account ID nesta seção ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTVl3TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--5817b729bb5f9311f620914e1410c3cba09a988d/phid.png) Faça login na sua conta Chatwoot, vá em Configurações > Caixa de Entrada e selecione o canal WhatsApp ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTTR3TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--34b0791786e1b9185b78563057d4dd6d6d2eeef6/cw-1.png) Informe seu número de telefone, phone number ID e business ID do seu setup do WhatsApp API ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCT1V3TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--36b14c0dff0a29cb3de0a07be4a8fa42f649decb/cw-2.png) Adicione membros da equipe à sua caixa de entrada do WhatsApp ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCUFl3TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--aff01faf7c0ba58daf722b218a378ebdae62617d/cw-3.png) Copie a URL do webhook e o token de verificação do webhook fornecidos aqui ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQVl4TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--ebc9f3052573b38afdd96995bfd97af6e9ed75cc/cw-4.png) ## **Configure seu Webhook** Precisamos configurar o webhook do WhatsApp para receber mensagens de clientes enviadas para seu número empresarial. Sua URL de callback deve estar no formato [**https://app.chatwoot.com/webhooks/whatsapp/{phone_number}**](https://app.chatwoot.com/webhooks/whatsapp/%7Bphone_number%7D). Faça login na sua conta de desenvolvedor do Facebook e navegue até WhatsApp > Configuração Cole sua URL do webhook do Chatwoot e o token de verificação aqui, depois clique em "Verificar e Salvar" ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQmN4TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--3802889ac4ce26cd2264b6dab4267fd1cb6afe53/hk-1.png) Configure permissões do webhook assinando mensagens ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQ1V4TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--a8d5c4c957aa29875247a3b135eb2acf945fddcc/hk-2.png) Pronto—tudo certo! Agora você já pode começar a enviar mensagens do WhatsApp pelo Chatwoot. ### **Perguntas Frequentes** **Como configurar múltiplos números em um único aplicativo do Facebook?** O aplicativo do Facebook permite configurar apenas um endpoint de Webhook. Portanto, crie Caixas de Entrada no Chatwoot para todos os números necessários. Você precisará configurar a URL do Webhook fornecida para apenas uma dessas caixas de entrada no aplicativo do Facebook para que todas as outras funcionem. **Que tipo de modelos de Whatsapp são suportados pelo Chatwoot?** Confira a [**documentação**](https://www.chatwoot.com/hc/user-guide/articles/1754940076-whatsapp-templates) para mais detalhes sobre modelos. **Quais tipos de mídia são suportados?** ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCRHZuSWdJPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--469bfec94ea6ac0381da7d5223e83312dbaf5ca9/image.png)