A API oficial do WhatsApp — a Meta Cloud API — serve a um propósito específico na plataforma: enviar templates de mensagem aprovados pela Meta e disparar campanhas, ou seja, mensagens proativas e mensagens fora da janela de atendimento de 24 horas.
Para o atendimento do dia a dia (conversas de mão dupla iniciadas pelo cliente), o canal recomendado é o WhatsApp Web, que conecta por QR Code e não exige credenciais do Meta Business. Use a API oficial apenas quando precisar alcançar o cliente primeiro. Veja Conectar o WhatsApp Web (QR Code).
Um mesmo número não pode usar os dois métodos ao mesmo tempo: WhatsApp Web e Meta Cloud API são formas de conexão diferentes. Escolha uma por número.
Quando usar cada método
- Templates de mensagem e campanhas (mensagens proativas, notificações, retomada de contato fora das 24h): Meta Cloud API (API oficial). Os templates precisam ser aprovados pela Meta antes do envio.
- Atendimento diário de mão dupla (o cliente inicia a conversa): WhatsApp Web. Veja Conectar o WhatsApp Web (QR Code).
Antes de começar
Para usar a API oficial você precisa providenciar, do lado da Meta:
- Uma conta de desenvolvedor Meta (developers.facebook.com) e uma conta Meta Business ativa.
- Um número de telefone válido, pronto para produção e que ainda não esteja em uso no WhatsApp Web.
Como a Cloud API é hospedada na própria infraestrutura da Meta, você não precisa de provedores terceirizados para hospedar sua API do WhatsApp Business.
Os passos abaixo são feitos no painel da Meta; consulte o guia oficial para começar com o WhatsApp se alguma tela do console deles mudar. Este artigo cobre onde a API oficial se conecta à plataforma.
Configuração
Passo 1: Criar o portfólio de negócios
Crie um perfil comercial 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.
Entre em business.facebook.com e, no menu Início, clique em Criar portfólio. Preencha todos os campos obrigatórios.
Passo 2: Criar o aplicativo do Facebook
Entre em developers.facebook.com e clique em Criar aplicativo. Preencha os campos obrigatórios, escolha o tipo Negócios e selecione o seu portfólio de negócios no menu suspenso.
Passo 3: Adicionar o produto WhatsApp
No painel do aplicativo, clique em Adicionar produto e escolha WhatsApp na lista, clicando em Configurar.
Observação: antes de prosseguir, verifique sua empresa com a Meta. É preciso enviar a documentação para verificação, necessária para o acesso total à API.
Passo 4: Gerar um token de acesso permanente
Para manter o acesso seguro e ininterrupto, crie um usuário do sistema e gere um token permanente.
- Nas Configurações comerciais (business.facebook.com/settings), clique em Usuários do sistema e adicione um novo usuário com a função Admin.
- Clique em Adicionar ativos, selecione o nome do seu aplicativo, escolha Controle total e clique em Atribuir ativos.
- Volte a Usuários do sistema, selecione o usuário recém-criado e clique em Gerar novo token.
- Selecione o seu aplicativo no menu suspenso e conceda as permissões de mensagens e de gerenciamento do WhatsApp Business (
whatsapp_business_messagingewhatsapp_business_management), além da permissão de eventos do WhatsApp Business. - Copie e guarde o token — ele é exibido apenas uma vez.
Passo 5: Configurar a Cloud API e o número
Selecione Criar uma conta empresarial (ou escolha uma existente), clique em Continuar e adicione o seu número de telefone pronto para produção.
Observação: a Meta exige um número verificado. Você pode verificá-lo por meio de uma senha de uso único (OTP) enviada ao número.
Passo 6: Conectar a caixa de entrada da API oficial
Com a Cloud API configurada, copie o ID do número de telefone e o ID da conta comercial exibidos no painel da Meta. Em seguida, na plataforma:
- Acesse Configurações → Caixas de Entrada → Adicionar caixa de entrada.
- Escolha WhatsApp e selecione Cloud do WhatsApp.
- Se a tela Configuração rápida com Meta aparecer, clique em fluxo de configuração manual para usar as credenciais deste guia. Como alternativa, você pode concluir a configuração rápida entrando na Meta e seguindo o assistente.
- No fluxo manual, informe o número de telefone, o ID do número de telefone e o ID da conta comercial obtidos na Meta.
- Em Chave de API, cole o token permanente gerado no Passo 4.
- Use Adicionar agentes para incluir os agentes que vão atender esta caixa de entrada.
- Conclua a criação. A plataforma exibirá uma URL de webhook e um token de verificação — copie os dois para o próximo passo.
Passo 7: Configurar o webhook
O webhook permite que as mensagens enviadas ao seu número comercial cheguem à plataforma.
- Na conta de desenvolvedor, vá em WhatsApp → Configuração.
- Cole a URL de webhook e o token de verificação copiados no passo anterior e clique em Verificar e salvar.
- Nas permissões do webhook, assine o campo mensagens (
messages).
Pronto! A caixa de entrada da API oficial está conectada.
Templates de mensagem e campanhas
Depois que a caixa da API oficial estiver conectada, os templates de mensagem aprovados pela Meta ficam disponíveis para envio, e você pode usá-los em campanhas para alcançar contatos de forma proativa ou fora da janela de 24 horas.
Lembre-se: novos templates precisam ser criados e aprovados pela Meta antes de aparecerem para uso.
Perguntas frequentes
Como configurar vários números em um único aplicativo do Facebook?
O aplicativo do Facebook permite apenas um endpoint de webhook. Crie uma caixa de entrada na plataforma para cada número necessário, mas configure a URL de webhook em apenas uma delas no aplicativo do Facebook — as demais caixas de entrada funcionarão a partir dessa mesma configuração.
Que tipos de template são suportados?
O seletor trabalha com os templates aprovados e devolvidos pela Meta, incluindo texto e os componentes compatíveis exibidos na prévia, como cabeçalhos de mídia e botões. A disponibilidade de cada componente depende da categoria e da estrutura aprovadas pela Meta; faça um envio de teste antes de programar uma campanha ampla.
Artigos relacionados
- Conectar o WhatsApp Web (QR Code) — o canal do dia a dia para atendimento de mão dupla, sem credenciais do Meta Business.