Guia completo da API do WhatsApp Business: como criar chatbots, enviar mensagens e fazer chamadas pelo mesmo número. Sem novas integrações, sem complicação.
Como integrar chatbots, mensagens e chamadas de voz no WhatsApp Business: um número, uma API, sem novas integrações.
O WhatsApp tem 2 bilhões de usuários no mundo. No Brasil, é o canal padrão de comunicação, pessoal e comercial. Se seus clientes estão no WhatsApp e sua empresa não está, você é invisível.
A API do WhatsApp Business (também chamada de WhatsApp Business Platform) permite enviar e receber mensagens e chamadas em escala pela API oficial, não pelo aplicativo WhatsApp Business limitado a um celular. É a base para automação, chatbots e integração com qualquer sistema.
Este guia mostra o que é a API do WhatsApp Business, como ela viabiliza chatbots e automação, e como conectá-la à sua infraestrutura de telefonia e mensagens já existente.
A API do WhatsApp Business é a interface oficial da Meta para empresas enviarem e receberem mensagens e chamadas do WhatsApp de forma programável. Diferente do aplicativo WhatsApp Business (limitado a um dispositivo e um usuário), a API suporta:
Related articles
Você não acessa a API diretamente pela Meta. A conexão é feita por meio de um Business Solution Provider (BSP) como a Telnyx, que cuida da integração, do provisionamento de números e da verificação comercial junto à Meta.
A API do WhatsApp Business é o que torna chatbots possíveis nesse canal. Sem ela, você fica restrito ao aplicativo. Com a API, cada mensagem recebida dispara um webhook que seu chatbot pode processar e responder em tempo real.
Para mensagens iniciadas pela empresa (fora da janela de 24h), a API exige templates aprovados pela Meta para autenticação (códigos OTP), utilidade (atualizações de pedidos), marketing (promoções) e serviço (suporte ao cliente). Seu chatbot envia esses templates automaticamente com base em gatilhos do seu sistema (novo pedido, consulta agendada, carrinho abandonado).
Dentro da janela de 24 horas após o cliente enviar uma mensagem, a API permite responder com texto livre. É aqui que chatbots com IA brilham: respostas naturais, contexto da conversa e escalonamento para um humano quando necessário. O webhook da API entrega cada mensagem ao seu chatbot, que responde instantaneamente.
Com a Telnyx, o mesmo agente de voz com IA que atende chamadas telefônicas pode atender conversas no WhatsApp. A API unifica mensagens e chamadas no mesmo número. O agente transcreve, interpreta e responde em tempo real, seja por texto ou por chamada de voz dentro do WhatsApp.
| App WhatsApp Business | API WhatsApp Business | |
|---|---|---|
| Usuários | Pequenas empresas e autônomos | Empresas de qualquer porte |
| Usuários simultâneos | 1 aparelho, 1 usuário | Ilimitados |
| Automação | Respostas rápidas básicas | Chatbots e agentes de IA completos |
| Chamadas | Apenas manuais | Programáveis (entrada e saída) |
| Integração | Nenhuma | Webhooks, API e conectores de CRM |
| Templates | Não | Sim — autenticação, utilidade, marketing e serviço |
| Escalabilidade | Dezenas de conversas | Milhares simultaneamente |
| Custo | Gratuito | Preço por conversa |
Se você já ultrapassou os limites do aplicativo, é hora de migrar para a API.
Crie ou vincule uma WhatsApp Business Account (WABA) por meio do embedded signup da Meta sem precisar acessar o Meta Business Manager separadamente.
O embedded signup é um fluxo integrado que permite criar e verificar uma WABA diretamente pelo portal do provedor (como o Mission Control Portal da Telnyx). Durante o processo, a Meta solicita:
Prazo de aprovação: a verificação comercial geralmente leva de 2 a 5 dias úteis. Empresas com documentação completa e consistente podem ser aprovadas em menos de 24 horas.
Motivos comuns de rejeição:
Se a verificação for negada, você pode reenviar com a documentação corrigida. Provedores como a Telnyx oferecem suporte durante todo o processo para minimizar atrasos.
Registre um número de telefone para o WhatsApp Business. Com a Telnyx, você usa um número existente ou provisiona um novo. A Meta envia um código de verificação para confirmar a propriedade.
Envie templates de mensagens (para saída), receba mensagens de entrada e faça ou receba chamadas de voz pelo WhatsApp, tudo pelo mesmo número e API.
Formatos pré-aprovados para autenticação (códigos OTP), utilidade (atualizações de pedidos, lembretes de consulta), marketing (promoções, anúncios) e serviço (suporte ao cliente). Os templates precisam de aprovação da Meta, que você envia diretamente pelo portal Telnyx.
Para criar um template, defina o nome, a categoria (autenticação, utilidade, marketing ou serviço), o idioma e o conteúdo do corpo. A Meta analisa cada template antes de aprovar. O processo leva de alguns minutos até 24 horas.
Critérios de aprovação da Meta:
Recursos dos templates:
{{1}}, {{2}} etc. para personalizar dinamicamente (nome do cliente, número do pedido)Exemplo: enviando um template com variável
Para disparar um template de confirmação de pedido com o nome do cliente e o número do pedido, faça uma chamada POST à API do WhatsApp Business:
Os valores em parameters substituem {{1}} e {{2}} no corpo do template aprovado. Resultado: "Olá Maria, seu pedido 12345 foi confirmado."
Se um template for rejeitado, você pode editá-lo e reenviar, ou abrir um recurso (appeal) pelo Meta Business Manager se considerar que a rejeição foi incorreta. Boa prática: teste com poucos templates primeiro, valide a aprovação e escale.
Dentro de 24 horas após um cliente te enviar uma mensagem, você pode responder com texto livre. Depois que a janela fecha, use templates aprovados para comunicações outbound. Chatbots gerenciam essa transição automaticamente: mensagens livres durante a janela, templates para reengajamento.
Faça e receba chamadas de voz para usuários do WhatsApp diretamente pela sua conexão SIP, Voice API ou TeXML existente. A mesma lógica de chamada, em um novo canal. Chamadas no WhatsApp funcionam com agentes de voz com IA: um agente de IA pode atender uma chamada do WhatsApp da mesma forma que atende uma chamada PSTN.
Acompanhe cada mensagem: enviada → entregue → lida. Notificações via webhook mantêm seu sistema atualizado em tempo real para auditoria, SLAs e automação de follow-up.
A API do WhatsApp Business é orientada a eventos. Toda interação — mensagem recebida, status de entrega, leitura — é comunicada via webhook para o seu servidor. O fluxo técnico é:
Exemplo de payload recebido pelo webhook:
Quando um cliente envia uma mensagem, a Meta entrega um POST como este ao seu endpoint:
Seu backend lê o campo messages[0].text.body para identificar o conteúdo da mensagem e messages[0].from para saber quem enviou. A partir daí, sua lógica de chatbot decide a resposta.
Boas práticas para webhooks:
Exemplo: validando a assinatura HMAC
Antes de processar qualquer webhook, confirme que o payload veio mesmo da Meta. O cabeçalho X-Hub-Signature-256 traz um hash HMAC SHA-256 que você recalcula com seu app secret:
Use crypto.timingSafeEqual em vez de comparação direta com === para evitar ataques de timing. Webhooks com assinatura inválida devem ser descartados imediatamente.
Essa arquitetura permite que chatbots, CRMs e sistemas de helpdesk se integrem de forma nativa — cada mensagem é um evento processável por qualquer sistema.
Se o seu número pode receber um código de verificação, você pode registrá-lo para o WhatsApp Business. Sem precisar trocar de número ou operadora.
Envie confirmações de pedidos, atualizações de entrega e lembretes de consulta em um canal com mais de 90% de taxa de abertura. O cliente vê o nome comercial verificado e o template com a marca. A API envia automaticamente quando seu sistema dispara o gatilho.
Deixe que seus clientes te encontrem no WhatsApp para receber ajuda em tempo real. O chatbot responde com mensagens livres na janela de 24 horas e usa templates aprovados para follow-ups outbound. Escala para um humano quando o cliente precisa. Tudo gerenciado pela mesma API.
Envie códigos de verificação pelo WhatsApp em vez de SMS. Custo menor por verificação, maior entregabilidade e sem filtro de operadora, especialmente eficaz no Brasil e na Índia, onde o WhatsApp é o canal de mensagens principal.
Conecte mensagens do WhatsApp a agentes de voz com IA para atendimento automatizado, agendamento de consultas e qualificação de leads. O mesmo agente que atende chamadas telefônicas pode atender conversas no WhatsApp, a API unifica os dois canais.
Alcance leads no Brasil, México, Índia, Oriente Médio e Sudeste Asiático com templates de marketing aprovados pela Meta. Mensagens de marketing no WhatsApp têm taxas de abertura acima de 90% — muito superiores a email e SMS.
Helpdesks de TI, linhas de RH e diretórios de funcionários podem funcionar pelo WhatsApp. Agentes de IA atendem consultas internas automaticamente - seja por chamada, seja por mensagem.
O WhatsApp usa um modelo de preço por conversa. Uma "conversa" é uma sessão de 24 horas de mensagens entre uma empresa e um cliente. O preço varia por:
A Meta classifica cada conversa em uma de quatro categorias, e o preço muda conforme a categoria:
| Categoria | Exemplo | Custo relativo |
|---|---|---|
| Autenticação | Código OTP de login | Mais baixo |
| Utilidade | Confirmação de pedido, status de entrega | Baixo |
| Serviço | Atendimento ao cliente (iniciada pelo cliente) | Baixo |
| Marketing | Promoções, novidades, carrinho abandonado | Mais alto |
Como funciona a janela de 24 horas: quando um cliente envia uma mensagem para sua empresa, abre-se uma janela de 24 horas. Durante essa janela, você pode enviar quantas mensagens livres quiser — sem template, sem custo adicional por mensagem. Tudo conta como uma única conversa. Quando a janela fecha, você só pode iniciar nova comunicação enviando um template aprovado, o que abre uma nova conversa e gera nova cobrança.
Dicas de otimização de custo:
Com a Telnyx, custos de plataforma e taxas da Meta aparecem em uma única fatura. Sem cobranças separadas, sem reconciliação. Chamadas no WhatsApp têm preço por minuto sem taxas de setup ou assinatura mensal.
A maioria dos provedores de WhatsApp Business são apenas camadas de software puro: conectam à Meta, mas não possuem a telefonia subjacente. Isso significa contratos separados para PSTN, SMS e WhatsApp. Analytics separados. Compliance separado. O "Frankenstack".
A Telnyx opera sua própria rede de operadora. Mensagens no WhatsApp, chamadas no WhatsApp, voz PSTN e SMS funcionam no mesmo número e na mesma conexão. Uma stack. Um contrato. Uma API. Isso importa porque:
Leia a documentação de mensagens do WhatsApp ou o guia de setup de chamadas do WhatsApp para passos detalhados de integração.
Não. A Meta cobra por conversa e os provedores cobram taxas de plataforma. A Telnyx inclui tudo em uma única fatura sem assinatura mensal.
Sim, desde que o número possa receber um código de verificação. Com a Telnyx, você usa o mesmo número para PSTN, SMS e WhatsApp.
São a mesma coisa. "WhatsApp Business Platform" é a marca atual da Meta. "API do WhatsApp Business" é o termo mais usado em comunidades de desenvolvedores e empresas.
Sim. As chamadas no WhatsApp permitem que empresas façam e recebam chamadas de voz pelo app. Com a Telnyx, chamadas do WhatsApp são roteadas para sua conexão SIP, Voice API ou TeXML existente.
Sim. Mensagens e chamadas do WhatsApp podem ser roteadas para agentes de voz com IA para atendimento automatizado, agendamento e suporte — sem mudanças de código no seu fluxo de chamadas existente.
Sim. Com a Telnyx, chamadas do WhatsApp são roteadas para sua conexão SIP, Voice API ou TeXML existente. Sem mudanças na infraestrutura.