Como configurar um canal do WhatsApp (Fluxo manual)?

A

Antonio Milesi

Última atualização em Jul 17, 2026

Visão geral do fluxo manual do WhatsApp Cloud API: criar o aplicativo Meta com token permanente, verificar o número de telefone, criar a caixa de entrada com os IDs do número e do negócio e ativar o webhook.

Você pode gerenciar as conversas da sua conta empresarial do WhatsApp pela plataforma, conectando a WhatsApp Cloud API da Meta pelo fluxo manual. Este guia detalha cada etapa; para a visão geral do canal — incluindo templates e campanhas — veja WhatsApp via API oficial (Meta Cloud).

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"

Meta Business Suite com o menu Início aberto e o botão de criar portfólio em destaque

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

Formulário de criação do portfólio empresarial na Meta com os campos obrigatórios

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.

Painel de desenvolvedor da Meta com o botão Criar Aplicativo em destaque

Preencha os campos obrigatórios

Formulário de detalhes do aplicativo com os campos obrigatórios preenchidos

Clique em "Outro" entre as opções

Seleção de caso de uso do aplicativo com a opção Outro marcada

Escolha "Business" como o tipo do seu aplicativo

Seleção do tipo de aplicativo com a opção Business marcada

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

Formulário final de criação do aplicativo com e-mail de contato e portfólio empresarial selecionados

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

Painel do aplicativo com o produto WhatsApp e o botão Configurar em destaque

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

Configurações do negócio na Meta, seção Usuários do sistema, criando um usuário com 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."

Janela Atribuir ativos com o aplicativo selecionado e a opção de controle total ativada

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

Página de usuários do sistema com o botão Gerar novo token em destaque

Selecione seu aplicativo no menu suspenso

Janela de geração de token com o aplicativo selecionado 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

Lista de permissões do token com as três permissões do WhatsApp Business marcadas

Copie e salve seu token

Janela exibindo o token de acesso gerado com o botão de copiar

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.

Configuração da Cloud API com a opção de criar uma conta empresarial selecionada

Cole seu token permanente aqui

Campo para colar o token de acesso permanente na configuração da Cloud API

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

Tela para adicionar o número de telefone de produção do WhatsApp

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

Tela de verificação do número de telefone por código OTP

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

Conectando sua Conta

Vamos conectar sua conta da plataforma à sua Cloud API do WhatsApp

Copie seu WhatsApp Phone Number ID e Business Account ID nesta seção

Painel da API do WhatsApp exibindo o Phone Number ID e o Business Account ID

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

Criação de caixa de entrada na plataforma com o canal WhatsApp selecionado

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

Formulário da caixa de entrada com número de telefone, Phone Number ID e Business Account ID

Adicione membros da equipe à sua caixa de entrada do WhatsApp

Tela de seleção de agentes para a nova caixa de entrada do WhatsApp

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

Tela final da criação da caixa de entrada exibindo a URL de webhook e o token de verificação

Configure seu Webhook

Precisamos configurar o webhook do WhatsApp para receber mensagens de clientes enviadas para seu número empresarial.

Use exatamente a URL de webhook e o token de verificação que a plataforma exibiu na criação da caixa de entrada (passo anterior).

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

Cole sua URL do webhook e o token de verificação aqui, depois clique em "Verificar e Salvar"

Configuração do webhook no aplicativo Meta com os campos de URL de callback e token de verificação

Configure permissões do webhook assinando mensagens

Campos de webhook do WhatsApp com a assinatura do campo de mensagens ativada

Pronto—tudo certo! Agora você já pode começar a enviar mensagens do WhatsApp pela plataforma.

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 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?

Confira a seção de templates em WhatsApp via API oficial (Meta Cloud) para mais detalhes sobre modelos.

Quais tipos de mídia são suportados?

Tabela dos tipos de mídia suportados pelo canal WhatsApp, com formatos e limites de tamanho