Skip to main content

API de WhatsApp Business

Conecta tu número de WhatsApp a BeeCastly para chatear con tus clientes, dejar que la IA responda por ti y enviar difusiones. Puedes conectarte escaneando un código QR o mediante la WhatsApp Cloud API oficial de Meta.

Requisitos previos

Una cuenta de BeeCastly (el plan gratuito sirve)
Una cuenta de Meta Business (business.facebook.com)
Para el método de Cloud API: una cuenta de Meta Business (business.facebook.com) y un número de teléfono para registrar en Meta

Dos formas de conectar

Escanea un código QR

Vincula el número que ya usas, incluido un número de la aplicación WhatsApp Business, igual que WhatsApp Web. Es gratis y no necesita aprobación de Meta. Ideal para respuestas y respuestas automáticas. No lo uses para difusiones masivas: WhatsApp puede bloquear el número.

WhatsApp Cloud API (Meta)

La forma oficial de Meta. Necesita una cuenta de Meta Business y plantillas de mensajes aprobadas. Este es el método que debes usar para difusiones y campañas.

Guía de configuración

1Conecta WhatsApp en BeeCastly

Ve a Integraciones → Canales → WhatsApp.
Código QR: elige WhatsApp QR. En tu teléfono, abre WhatsApp → Dispositivos vinculados → Vincular un dispositivo y escanea el código. Tu teléfono sigue funcionando con normalidad.
Cloud API: elige WhatsApp Cloud API (Meta) y haz clic en Conectar con Facebook. Elige tu cuenta de Meta Business y tu número de teléfono. Si prefieres hacerlo a mano, el Asistente paso a paso te pide tu ID de app de Meta, el ID de la cuenta de WhatsApp Business, el ID del número de teléfono y el token de acceso.

2Crea plantillas de mensajes

Con la Cloud API, solo puedes enviar texto libre dentro de las 24 horas posteriores al último mensaje del cliente. Fuera de esa ventana necesitas una plantilla aprobada por Meta.
Ve a Campañas → Plantillas y crea una plantilla.
Elige una categoría: Marketing, Utilidad o Autenticación.
Añade variables como {{1}} y {{2}} para nombres y otros datos.
Envíala. Meta la revisa y el estado se actualiza en BeeCastly.

3Envía una campaña de difusión

Ve a Campañas → Difusiones → Crear.
Selecciona WhatsApp como canal.
Elige tu plantilla aprobada y tu audiencia (contactos, etiquetas o segmentos).
Asigna las variables de la plantilla a los campos del contacto (nombre, teléfono, campos personalizados).
Previsualiza el mensaje y luego haz clic en Enviar ahora o Programar.

4Gestiona las conversaciones

Los mensajes entrantes de WhatsApp llegan a Mensajes → WhatsApp (y a Todos los mensajes).
Responde desde la bandeja, usa Respuestas rápidas para las respuestas que envías a menudo y asigna chats a miembros del equipo.
Activa las respuestas de IA para que tu chatbot responda preguntas frecuentes desde tu Base de conocimiento, y pasa el chat a una persona cuando haga falta.

5Más herramientas de WhatsApp

Mensajes → Status Studio: publica estados de WhatsApp.
Mensajes → Enlace wa.me: crea un enlace de clic para chatear o un código QR para tu sitio web y tus carteles.
Integraciones → Canales → WhatsApp: edita tu perfil de empresa y tu catálogo de productos (Cloud API).

Buenas prácticas

Mantén una alta calificación de calidad

Mantén ALTA la calificación de calidad de tus mensajes evitando el spam. Si los usuarios te bloquean o reportan tus mensajes, Meta puede restringir tus límites de envío.

Consigue el consentimiento de suscripción

Obtén un permiso claro antes de enviar mensajes de marketing, por ejemplo con un formulario, un chat del sitio web o en persona.

Usa la respuesta automática con IA con criterio

Las respuestas de IA funcionan mejor cuando tu Base de conocimiento tiene tus precios, horarios y políticas. Deja siempre una forma de que los clientes lleguen a una persona.

Importante: la ventana de 24 horas (Cloud API)

En la WhatsApp Cloud API solo puedes enviar texto libre dentro de las 24 horas posteriores al último mensaje del cliente. Fuera de esta ventana debes usar una plantilla aprobada.

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