Skip to main content

API do WhatsApp Business

Conecte-se à API oficial do WhatsApp Business da Meta para enviar campanhas personalizadas, automatizar conversas e gerenciar o relacionamento com os clientes em escala.

Pré-requisitos

Uma conta BeeCastly (o plano gratuito funciona)
Uma conta do Meta Business (business.facebook.com)
Um número de telefone comercial verificado (que ainda não esteja no WhatsApp)
Verificação da empresa concluída no Meta Business Manager

Guia de configuração

1Conecte o WhatsApp na BeeCastly

Acesse Configurações → Integrações → WhatsApp no seu painel BeeCastly.
Clique em "Conectar a API do WhatsApp Business". Você será redirecionado para o fluxo de cadastro incorporado da Meta.
Siga as instruções para selecionar sua conta Meta Business e seu número de telefone.
Depois de conectado, o ID da sua Conta do WhatsApp Business, o ID do Número de Telefone e o token de acesso são configurados automaticamente.

2Crie modelos de mensagem

O WhatsApp exige modelos pré-aprovados para mensagens enviadas (não é possível enviar mensagens livres fora da janela de 24 horas).
Vá em Campanhas → Modelos e clique em "Criar modelo".
Escolha uma categoria: Marketing, Utilidade ou Autenticação.
Escreva seu modelo com variáveis como {{1}}, {{2}} para personalização.
Envie para revisão da Meta. A aprovação costuma levar de 1 a 24 horas.

3Envie uma campanha de transmissão

Vá em Campanhas → Transmissões → Criar.
Selecione WhatsApp como canal.
Escolha seu modelo aprovado e o público (contatos, tags ou segmentos).
Associe as variáveis do modelo aos campos do contato (nome, telefone, campos personalizados).
Visualize a mensagem e clique em Enviar agora ou Agendar.

4Gerencie as conversas

Todas as mensagens recebidas no WhatsApp aparecem em Mensagens → WhatsApp.
Responda aos clientes direto da caixa de entrada — dentro da janela de 24 horas, você pode enviar mensagens livres.
Ative a Resposta automática com IA para que seu bot de IA cuide das dúvidas mais comuns automaticamente.
Atribua conversas a membros da equipe para atendimento manual.

Boas práticas

Mantenha uma classificação de qualidade alta

Mantenha ALTA a classificação de qualidade das suas mensagens evitando spam. Se os usuários bloquearem você ou denunciarem suas mensagens, a Meta pode restringir seus limites de envio.

Obtenha o consentimento de adesão

Sempre obtenha consentimento explícito antes de enviar mensagens de marketing. Use formulários, widgets no site ou coleta de consentimento presencial.

Use a resposta automática com IA com sabedoria

A resposta automática com IA funciona melhor quando você treina seu bot com artigos relevantes da base de conhecimento. Sempre ofereça um caminho para o cliente falar com um atendente humano.

Importante: janela de mensagens de 24 horas

A API do WhatsApp Business tem uma janela de mensagens de 24 horas. Você só pode enviar mensagens livres até 24 horas depois da última mensagem do cliente. Fora dessa janela, é obrigatório usar modelos aprovados.

API Examples

Use the BeeCastly REST API to send WhatsApp messages programmatically.

bash
curl -X POST https://api.beecastly.com/api/whatsapp/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+1234567890",
    "message": "Hello from BeeCastly!"
  }
javascript·send-message.js
const response = await fetch('https://api.beecastly.com/api/whatsapp/send', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    phone: '+1234567890',
    message: 'Hello from BeeCastly!',
  }),
});

const data = await response.json();
console.log(data);

Troubleshooting

Template not approved

If your template is rejected by Meta, check that it follows WhatsApp's guidelines: no promotional content in utility templates, proper formatting, and clear call-to-action buttons.

Messages not delivering

Ensure the recipient has opted in to receive messages. Check your WhatsApp Business Account health status in the Meta Business Manager.

Rate limits

WhatsApp Cloud API has rate limits. Start with small batches and scale gradually. Use the BeeCastly campaign scheduler to manage sending rates.

Frequently Asked Questions

How long does Meta verification take?
Meta Business verification typically takes 2-5 business days. Ensure your business documents are clear and match your Business Manager details.
Can I use my personal WhatsApp number?
No, you need a dedicated WhatsApp Business API number. This cannot be a personal WhatsApp or WhatsApp Business App number.
What is the cost per message?
WhatsApp charges per conversation (24-hour window), not per message. The first message in a conversation is charged; all subsequent messages within 24 hours are free.