Como configurar um canal do WhatsApp (Fluxo manual)?

Pranav

Pranav

Última atualização em Jun 3, 2026

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 para configurar a API do WhatsApp. Se ainda não tem uma conta de desenvolvedor, clique aqui para criar uma antes de prosseguir.

  2. Um número de telefone válido

Usando o Whatsapp Cloud API

O 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) 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 e clique no botão criar portfólio no menu suspenso em "Início"

Preencha todos os campos obrigatórios para configurar seu portfólio empresarial.

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/ e clique no botão Criar Aplicativo.

Preencha os campos obrigatórios

Clique em "Outro" entre as opções

Escolha "Business" como o tipo do seu aplicativo

Digite seu e-mail de contato e selecione seu portfólio empresarial no menu suspenso.

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

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.

Clique em "Usuários do sistema" e adicione um novo usuário do sistema com o papel Admin

Clique no botão "Adicionar Ativos", selecione o nome do seu aplicativo, escolha a opção "Controle Total" e clique em "Atribuir ativos."

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".

Selecione seu aplicativo no menu suspenso

Selecione estes três níveis de permissão para seu token:

  • whatsapp_business_manage_events

  • whatsapp_business_management

  • whatsapp_business_messaging

Copie e salve seu token

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.

Cole seu token permanente aqui

Adicione seu número de telefone de produção

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).

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

Faça login na sua conta Chatwoot, vá em Configurações > Caixa de Entrada e selecione o canal WhatsApp

Informe seu número de telefone, phone number ID e business ID do seu setup do WhatsApp API

Adicione membros da equipe à sua caixa de entrada do WhatsApp

Copie a URL do webhook e o token de verificação do webhook fornecidos aqui

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}.

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"

Configure permissões do webhook assinando mensagens

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 para mais detalhes sobre modelos.

Quais tipos de mídia são suportados?