Skip to main content

API do WhatsApp Business

Conecte seu número de WhatsApp ao BeeCastly para conversar com clientes, deixar a IA responder por você e enviar transmissões. Você pode conectar escaneando um QR code ou pela Meta WhatsApp Cloud API oficial.

Pré-requisitos

Uma conta BeeCastly (o plano gratuito funciona)
Uma conta do Meta Business (business.facebook.com)
Para o método da Cloud API: uma conta Meta Business (business.facebook.com) e um número de telefone para registrar na Meta

Duas formas de conectar

Escaneie um QR code

Vincule o número que você já usa, inclusive um número do aplicativo WhatsApp Business, como no WhatsApp Web. É grátis e não precisa de aprovação da Meta. Ideal para respostas e respostas automáticas. Não use para transmissões em massa: o WhatsApp pode banir o número.

WhatsApp Cloud API (Meta)

A forma oficial da Meta. Precisa de uma conta Meta Business e de modelos de mensagem aprovados. É o método a usar para transmissões e campanhas.

Guia de configuração

1Conecte o WhatsApp na BeeCastly

Vá em Integrações → Canais → WhatsApp.
QR code: escolha WhatsApp QR. No celular, abra o WhatsApp → Aparelhos conectados → Conectar um aparelho e escaneie o código. Seu celular continua funcionando normalmente.
Cloud API: escolha WhatsApp Cloud API (Meta) e clique em Conectar com o Facebook. Escolha sua conta Meta Business e o número de telefone. Se preferir fazer manualmente, o Assistente passo a passo pede o Meta App ID, o WhatsApp Business Account ID, o Phone Number ID e o token de acesso.

2Crie modelos de mensagem

Na Cloud API, você só pode enviar texto livre dentro de 24 horas após a última mensagem do cliente. Fora dessa janela, você precisa de um modelo aprovado pela Meta.
Vá em Campanhas → Modelos e crie um modelo.
Escolha uma categoria: Marketing, Utility ou Authentication.
Adicione variáveis como {{1}} e {{2}} para nomes e outros detalhes.
Envie. A Meta analisa e o status é atualizado no BeeCastly.

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

As mensagens de WhatsApp recebidas caem em Mensagens → WhatsApp (e em Todas as mensagens).
Responda pela caixa de entrada, use Respostas rápidas para respostas que você envia com frequência e atribua conversas a membros da equipe.
Ative as respostas da IA para o seu chatbot responder perguntas comuns com base na sua Base de conhecimento e passar para uma pessoa quando necessário.

5Mais ferramentas do WhatsApp

Mensagens → Status Studio: publique status do WhatsApp.
Mensagens → Link wa.me: crie um link de conversa ou QR code para o seu site e cartazes.
Integrações → Canais → WhatsApp: edite o perfil do seu negócio e o catálogo de produtos (Cloud API).

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

Obtenha permissão clara antes de enviar mensagens de marketing, por exemplo com um formulário, um chat no site ou pessoalmente.

Use a resposta automática com IA com sabedoria

As respostas da IA funcionam melhor quando a sua Base de conhecimento tem seus preços, horários e políticas. Sempre deixe um jeito de os clientes falarem com uma pessoa.

Importante: a janela de 24 horas (Cloud API)

Na WhatsApp Cloud API, você só pode enviar texto livre dentro de 24 horas após a última mensagem do cliente. Fora dessa janela, você deve usar um modelo aprovado.

API Examples

Send a WhatsApp message from your own software with an API key. See the Messages API for details.

bash
curl -X POST https://beecastly.com/api/v1/messages/send \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"channel":"WHATSAPP","to":"+919876543210","content":"Hello from BeeCastly!"}'
javascript·send-message.js
const response = await fetch('https://beecastly.com/api/v1/messages/send', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    channel: 'WHATSAPP',
    to: '+919876543210',
    content: 'Hello from BeeCastly!',
  }),
});

const data = await response.json(); // { success: true, data: { messageId, status: "queued" } }

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

QR method: check that your phone is online and still shows BeeCastly under Linked devices. Cloud API: check that the customer has opted in and that your number's status is healthy in Meta Business Manager.

Rate limits

Meta limits how many people a new Cloud API number can message per day, and the limit grows as you send good-quality messages. Start with small broadcasts and schedule larger ones in Campaigns → Broadcasts.

Frequently Asked Questions

Can I use my WhatsApp Business App number?
Yes. With the QR method you link the number you already use, the same way WhatsApp Web works, and you keep using the app on your phone. For the Cloud API, you connect a number through Meta's sign-up steps.
Do I need Meta approval?
Not for the QR method. The Cloud API needs a Meta Business account, and Meta must approve your message templates before you can use them.
Which method should I use for broadcasts?
The Cloud API. Sending bulk messages over the QR method can get your number banned by WhatsApp, so use QR for replies and auto-replies to people who message you.
WhatsApp Guide - BeeCastly Documentation | BeeCastly