Como configurar um canal do WhatsApp (fluxo manual)?

Última atualização em 15 de setembro de 2025

Você pode gerenciar as conversas da sua conta comercial do WhatsApp a partir do Chatwoot. Para configurá-lo, você tem duas opções para escolher seu provedor:

1. API do WhatsApp Cloud

2. Twilio

Explicaremos todos os procedimentos deste guia.

Pré-requisitos

1. Você precisa de um Conta de desenvolvedor Meta para configurar a API do WhatsApp. Se você ainda não tem uma conta de desenvolvedor, clique em aqui para criar um antes de prosseguir

2. Um número de telefone válido

Usando a API do Whatsapp Cloud

API do WhatsApp Cloud está disponível para todas as empresas e desenvolvedores individuais. Como ele está hospedado na infraestrutura de nuvem da Meta, você não precisa mais usar provedores terceirizados como Twilio, Zendesk, 360Dialog ou MessageBird (Provedores de soluções de negócios) para hospedar sua API do WhatsApp Business.

Configure seu perfil comercial

Crie um perfil comercial profissional do WhatsApp com o nome, a descrição e as informações de contato da sua empresa. Um perfil bem elaborado ajuda os clientes a reconhecer e confiar na sua marca quando interagem com você.

Entrar https://business.facebook.com e clique no criar portfólio botão no menu suspenso em Início

Preencha todos os campos obrigatórios para configurar seu portfólio de negócios.

Depois de criar seu portfólio de negócios, é hora de criar seu aplicativo do Facebook.

Configure seu aplicativo do Facebook

Entrar https://developers.facebook.com/ e clique no Criar aplicativo botão.

Preencha os campos obrigatórios

Clique em "Outros" nas opções

Escolha "Negócios" como seu tipo de aplicativo

Digite seu endereço de e-mail de contato e escolha seu portfólio de negócios no menu suspenso.

Adicione o Whatsapp ao seu aplicativo

Depois de criar seu aplicativo, você será direcionado para o painel do aplicativo. A partir daí, clique "Adicionar produto" e escolher WhatsApp da lista de produtos disponíveis.

Clique no botão "Configurar" para WhatsApp

Nota: Antes de prosseguir, verifique seu negócio com a Meta. Você precisará enviar documentação para verificação, necessária para acesso total à API.

Configure um token de acesso permanente à API do WhatsApp Cloud

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 WhatsApp e navegue até o Página de configurações de negócios.

Clique em "Usuários do sistema" e adicione um novo usuário do sistema com a função Administrador

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

Voltar para o usuários do sistema página, selecione o usuário do sistema recém-criado na lista e clique em "Gerar novo token" botão.

Selecione seu aplicativo no menu suspenso

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

• whatsapp_business_manage_eventos

• whatsapp_business_gestão

• mensagens_empresariais_do whatsapp

Copie e salve seu token

Configurar API do WhatsApp Cloud

Para criar uma nova conta comercial Meta, selecione "criar uma conta empresarial" do menu suspenso. Se você já possui uma conta comercial, pode selecioná-la entre as opções existentes. Estou selecionando "criar uma conta empresarial". Clique no continuar botão.

Cole seu token permanente aqui

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

Nota: O Meta requer um número de telefone verificado para configuração da API do WhatsApp. Você pode verificar seu número usando uma OTP (senha única).

Depois de adicionar e verificar seu número de telefone, o próximo passo é configurar um webhook para receber mensagens de entrada.

Conectando sua conta Chatwoot

Vamos conectar sua conta Chatwoot com sua API do WhatsApp Cloud

Copie seu ID de número de telefone do WhatsApp e ID de conta comercial desta seção

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

Insira seu número de telefone, ID do número de telefone e ID comercial na configuração da API do WhatsApp

Adicione membros da equipe à sua caixa de entrada do WhatsApp

Copie o 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 recebidas de clientes enviadas para o número da sua empresa.

Seu URL de retorno de chamada deve estar no formato de https://app.chatwoot.com/webhooks/whatsapp/{phone_number}.

Entre na sua conta de desenvolvedor do Facebook e navegue até WhatsApp > Configuração

Cole o URL do webhook do Chatwoot e o token de verificação aqui e clique em "Verificar e salvar"

Configure permissões de webhook assinando mensagens

É isso—você terminou! Agora você pode começar a enviar mensagens do WhatsApp através do Chatwoot.

Perguntas frequentes

Como configurar vários números em um único aplicativo do Facebook?

O aplicativo do Facebook permite configurar apenas um único endpoint do Webhook. Portanto, crie caixas de entrada no Chatwoot para todos os números, conforme necessário. Você precisará configurar a URL do Webhook fornecida para apenas uma dessas caixas de entrada no aplicativo do Facebook para que todas as outras caixas de entrada funcionem.

Que tipo de modelos do Whatsapp são suportados pelo Chatwoot?

Por favor, verifique o doutor para mais detalhes sobre modelos.

Quais são os tipos de mídia suportados?