Como conectar o WhatsApp a um assistente pela Cloud API da Meta?
Você cria um app no painel de desenvolvedores da Meta, adiciona o produto WhatsApp, aponta o webhook para o sistema que escreve as respostas e inscreve o app na conta do WhatsApp Business. A partir daí, as mensagens chegam ao seu sistema e o assistente responde pela Cloud API dentro da janela de atendimento de 24 horas. O número, a conta da Meta e o histórico continuam sendo da empresa.
A maioria das primeiras configurações trava na configuração, não no assistente: um app que nunca foi inscrito na conta comercial, um número no formato errado ou um número de teste que não entrega para alguns países.
Como funciona
Criar o app na Meta
No painel de desenvolvedores da Meta, crie um app do tipo Business e adicione o produto WhatsApp. A Meta oferece um número de teste gratuito e permite cadastrar até cinco números que podem receber as respostas de teste.
Conectar o webhook
Informe a URL de retorno e um token de verificação e assine o campo messages. A partir daí, toda mensagem que o cliente envia é entregue ao seu sistema.
Inscrever o app na conta comercial
Chame POST /{WABA-ID}/subscribed_apps com o token do seu app. Sem esse passo, o webhook aparece como verificado, mas não recebe nada, e o painel não mostra o motivo.
Escrever as respostas
O sistema lê a mensagem, responde só com as informações da própria empresa (horários, preços, serviços, regras de agendamento) e envia a resposta com POST /{phone-number-id}/messages. O que ele não sabe, ou o que pede avaliação, vai para uma pessoa com um resumo curto.
Trocar o token temporário
O token de acesso do painel dura cerca de um dia. Para algo que precisa continuar funcionando, crie um usuário do sistema nas Configurações do Negócio e gere um token permanente com as permissões de mensagens e de gerenciamento do WhatsApp.
Passar para o número real e cadastrar o pagamento
Registre o número da própria empresa, cadastre uma forma de pagamento no Billing Hub e conclua a verificação da empresa na Meta quando ela pedir. É a verificação que aumenta quantas pessoas a empresa pode contatar primeiro por dia.
Quanto custa manter
A Meta cobra por mensagem entregue; as mensagens que os clientes enviam não são cobradas. O modelo que escreve as respostas é cobrado à parte pelo fornecedor dele. A Meta pode mudar as tarifas até uma vez por trimestre; confira a tabela do país de quem recebe.
| Item | Preço de tabela | Fonte |
|---|---|---|
| Mensagens que os clientes enviam para a empresa | Sem cobrança | Meta for Developers, Pricing on the WhatsApp Business Platform (updated 28 Sep 2026)Consultado em 1 de out. de 2026 |
| Respostas dentro da janela de 24 horas (mensagens de serviço) | Gratuitas até 30/09/2026. A partir de 01/10/2026, as primeiras 1.000 entregues no mês em cada número da empresa são gratuitas; depois disso, cobradas por mensagem entregue, com a mesma tarifa das mensagens de utilidade do país | Meta for Developers, Pricing on the WhatsApp Business Platform (updated 28 Sep 2026)Consultado em 1 de out. de 2026 |
| Mensagem de utilidade ou de serviço para um usuário no Brasil | US$ 0,0068 por mensagem entregue (tabela da Meta em vigor a partir de 01/10/2026, igual à de 01/07/2026) | Meta for Developers, Pricing on the WhatsApp Business Platform (updated 28 Sep 2026)Consultado em 1 de out. de 2026 |
| Modelos que a empresa envia primeiro (marketing, utilidade, autenticação) | Por mensagem entregue; a tarifa depende da categoria e do país de quem recebe | Meta for Developers, Pricing on the WhatsApp Business Platform (updated 28 Sep 2026)Consultado em 1 de out. de 2026 |
| Mensagens nas 72 horas depois de um anúncio de clique para o WhatsApp | Gratuitas (janela de ponto de entrada gratuito) | Meta for Developers, Pricing on the WhatsApp Business Platform (updated 28 Sep 2026)Consultado em 1 de out. de 2026 |
| O modelo que escreve as respostas | Cobrado pelo fornecedor do modelo conforme o uso, separado da cobrança de entrega da Meta | Meta for Developers, Upcoming pricing updates for Meta Business Agent, service and utility messages (updated 25 Aug 2026)Consultado em 28 de set. de 2026 |
Preços de tabela de terceiros, consultados na data indicada. Não são preços da Betterlane.
O que aprendemos montando
Da nossa clínica de demonstração fictícia, montada num número de teste da Meta em setembro de 2026. Não é um sistema de cliente.
- O webhook estava verificado, mas nada chegava
- A conta comercial de teste estava inscrita só no app de exemplo da própria Meta. Uma chamada a /subscribed_apps com o nosso app resolveu.
- Erro 131030: destinatário fora da lista permitida
- Os celulares brasileiros chegavam ao webhook sem o nono dígito (12 dígitos), enquanto a lista permitida guardava o número com ele (13 dígitos). As respostas falharam até a etapa de envio recolocar o 9.
- Erro 130497: envio bloqueado para um país
- Um número de teste de uma empresa não verificada não conseguia entregar para um número brasileiro. O assistente escreveu todas as respostas; a Meta recusou a entrega. Teste com um número de outro país ou use a conta verificada e o número real da empresa.
- O token venceu durante a noite
- O token do painel dura cerca de um dia. O token permanente de usuário do sistema é a primeira coisa a configurar em algo que precisa continuar respondendo.
Quando não vale a pena
- Se a empresa recebe poucas mensagens por semana, uma pessoa respondendo pelo app WhatsApp Business é mais simples e não exige configuração.
- Se as respostas dependem de informações que ninguém escreveu (preços, regras, disponibilidade), escreva primeiro: o assistente só responde com o que recebe.
- Se o objetivo é contatar pessoas que nunca escreveram para a empresa, isso é envio de modelos com consentimento, um projeto diferente de um assistente que responde.
Perguntas
Preciso de um provedor de soluções (BSP)?
Não. A Cloud API é hospedada pela Meta e pode ser usada diretamente pela empresa. Um provedor pode ajudar com cobrança e suporte, mas não é obrigatório.
O que muda em 1º de outubro de 2026?
A Meta passa a cobrar por mensagem entregue as mensagens de serviço, as respostas dentro da janela de 24 horas, que eram gratuitas desde novembro de 2024. Cada número da empresa tem 1.000 mensagens de serviço entregues gratuitas por mês, sem acumular para o mês seguinte; a Meta cobra as demais. Sem forma de pagamento cadastrada, a Meta entrega as 1.000 gratuitas e deixa de entregar mensagens de serviço depois disso.
O assistente pode responder dúvidas de saúde, jurídicas ou de pagamento?
Ele não deve decidir essas questões. Uma configuração cuidadosa responde só com o que a empresa aprovou e passa para uma pessoa, com um resumo, tudo o que for clínico, jurídico, financeiro ou fora do comum.
Quem fica com o número e as conversas?
A empresa. O app, a conta do WhatsApp Business, o número e o histórico devem ficar na conta da Meta da própria empresa, não na de quem implementa.
Quer um assistente assim no seu número e na sua conta da Meta?
Ver o serviço: Assistentes para WhatsAppFale com a genteTodos os guias
- O que um agente de voz deve atender, e o que precisa passar para uma pessoa?
- O que um chatbot faz no site de uma pequena empresa, e quando vale a pena?
- Como automatizar a caixa de suporte sem enviar uma resposta errada?
- n8n, Zapier ou Make: qual escolher para uma pequena empresa?
- Como extrair dados de centenas de PDFs?
- Como montar um relatório que se atualiza sozinho quando os dados mudam?
- Como um assistente interno responde com os documentos da empresa sem inventar?
- Como automatizar a produção de conteúdo sem perder o controle editorial?
- Como montar uma lista de prospects com fontes, sem comprar uma?
- O que um site de pequena empresa precisa para ser encontrado pelo Google e pelo ChatGPT?
- Quando uma empresa precisa de um portal do cliente em vez de e-mail?
- Quando vale tirar um processo da planilha e levar para uma ferramenta interna?
- Por que o meu fluxo do n8n roda duas vezes para a mesma coisa?
- Meu fluxo do n8n funcionava e agora falha com 401 ou 403. Por quê?
- Como saber quando um fluxo do n8n falha em silêncio?
- Quem conserta um fluxo do n8n quebrado, e o que o conserto cobre?
- O que um assistente de locação nunca pode fazer pelo Renters’ Rights Act?
- Quanto custa manter um assistente no WhatsApp no Reino Unido?
- Uma clínica em Dubai pode usar um chatbot com IA com dados de pacientes pela lei dos Emirados?
- Erro 131030 da API do WhatsApp: por que o destinatário não está na lista permitida?
- Quanto a Meta cobra por mensagem de WhatsApp no Brasil em 2026?
- O que é uma agência de IA?
- Até que horas as clínicas odontológicas atendem no Brasil?
- Mensagem fora do horário no WhatsApp da clínica: modelos, e o que ela não resolve
- Secretária virtual com IA para clínica odontológica: o que ela faz e o que não faz
- Melhores secretárias virtuais com IA para clínicas em 2026
- Como desviar as chamadas perdidas da empresa para uma linha de atendimento (todas as operadoras e sistemas dos EUA)
- Como desvio as chamadas perdidas da Verizon para uma linha de atendimento?
- Como desvio as chamadas perdidas da T-Mobile para uma linha de atendimento?
- Como desvio as chamadas perdidas da AT&T para uma linha de atendimento?
- Como desvio as chamadas perdidas no AT&T Phone for Business?
- Como desvio só as chamadas perdidas no iPhone?
- Como desvio as chamadas perdidas num Samsung Galaxy ou Android?
- O Google Voice consegue desviar chamadas para uma linha de atendimento?
- Como desvio as chamadas perdidas do RingCentral para uma linha de atendimento?
- Como desvio as chamadas perdidas do Comcast Business Voice para uma linha de atendimento?
- Como desvio as chamadas perdidas do Spectrum Business Voice para uma linha de atendimento?
- Como desvio as chamadas perdidas do Dialpad para uma linha de atendimento?
- Como desvio as chamadas perdidas do Quo (antigo OpenPhone) para uma linha de atendimento?
- Como mando as chamadas perdidas do Grasshopper para uma linha de atendimento?
- Como desvio as chamadas perdidas do Vonage Business para uma linha de atendimento?
- Como desvio as chamadas perdidas do Ooma Office para uma linha de atendimento?
- Os melhores recepcionistas com IA para encanadores, HVAC e eletricistas nos EUA em 2026