Skip to main content

API de WhatsApp Business

Conéctate a la API oficial de WhatsApp Business de Meta para enviar campañas personalizadas, automatizar conversaciones y gestionar la interacción con tus clientes a gran escala.

Requisitos previos

Una cuenta de BeeCastly (el plan gratuito sirve)
Una cuenta de Meta Business (business.facebook.com)
Un número de teléfono de empresa verificado (que no esté ya en WhatsApp)
Verificación del negocio completada en Meta Business Manager

Guía de configuración

1Conecta WhatsApp en BeeCastly

Ve a Configuración → Integraciones → WhatsApp en tu panel de BeeCastly.
Haz clic en "Conectar la API de WhatsApp Business". Se te redirigirá al flujo de registro integrado de Meta.
Sigue las indicaciones para seleccionar tu cuenta de Meta Business y tu número de teléfono.
Una vez conectado, el ID de tu cuenta de WhatsApp Business, el ID del número de teléfono y el token de acceso se configuran automáticamente.

2Crea plantillas de mensajes

WhatsApp exige plantillas aprobadas previamente para los mensajes salientes (no puedes enviar mensajes de formato libre fuera de la ventana de 24 horas).
Ve a Campañas → Plantillas y haz clic en "Crear plantilla".
Elige una categoría: Marketing, Utilidad o Autenticación.
Redacta tu plantilla con variables como {{1}}, {{2}} para personalizarla.
Envíala a revisión de Meta. La aprobación suele tardar entre 1 y 24 horas.

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

Todos los mensajes entrantes de WhatsApp aparecen en Mensajes → WhatsApp.
Responde a tus clientes directamente desde la bandeja de entrada: dentro de la ventana de 24 horas puedes enviar mensajes de formato libre.
Activa la respuesta automática con IA para que tu bot atienda las consultas habituales de forma automática.
Asigna conversaciones a miembros del equipo para gestionarlas manualmente.

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 siempre un consentimiento explícito antes de enviar mensajes de marketing. Usa formularios, widgets del sitio web o recogida de consentimiento en persona.

Usa la respuesta automática con IA con criterio

La respuesta automática con IA funciona mejor cuando has entrenado a tu bot con artículos relevantes de la base de conocimiento. Ofrece siempre una vía para que el cliente llegue a un agente humano.

Importante: ventana de mensajería de 24 horas

La API de WhatsApp Business tiene una ventana de mensajería de 24 horas. Solo puedes enviar mensajes de formato libre dentro de las 24 horas posteriores al último mensaje del cliente. Fuera de esa ventana, debes usar plantillas aprobadas.

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.