API de WhatsApp con webhooks: cómo enviar y recibir mensajes

Respuesta corta: una API de WhatsApp funciona en dos sentidos. Para enviar, tu sistema hace un POST autenticado con el destinatario y el mensaje. Para recibir, registras una URL de webhook y la plataforma hace un POST en ella con cada mensaje entrante o cambio de estado (enviado, entregado, leído).

Cómo funciona el envío

En Zapini, genera un token de API en el panel y llama al endpoint de envío de la instancia (número):

curl -X POST https://zapini.app/api/v1/instances/{id}/send-message \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"recipient": "+5215512345678", "message": "¡Hola! Tu pedido salió a reparto."}'

Los campos exactos, archivos, notas de voz y plantillas de la Cloud API están en la documentación para desarrolladores.

Cómo funciona la recepción (webhooks)

1. Registra la URL pública de tu sistema como webhook de la instancia.
2. En cada evento, la plataforma envía un JSON con tipo de evento, remitente, contenido e ID del mensaje.
3. Tu endpoint responde 200 rápido y procesa en una cola.

Buenas prácticas

• Responde rápido: devuelve 200 y procesa después; los webhooks lentos generan reintentos.
• Idempotencia: usa el ID del mensaje para no procesar dos veces el mismo evento.
• Seguridad: HTTPS, token secreto en el webhook y nunca expongas el token de API en el front-end.
• Límites: respeta las reglas de WhatsApp; los envíos masivos sin consentimiento provocan bloqueos.

Sin código: Zapier, Make y n8n

¿Quieres enviar webhooks en Zaps? Usa el disparador Webhooks by Zapier (o su equivalente en Make/n8n) como URL de webhook de la instancia para recibir mensajes, y una acción de petición HTTP para llamar al endpoint de envío. Así conectas WhatsApp con hojas de cálculo, ERPs y correo sin programar.

Casos de uso comunes

• Confirmación de pedidos y seguimiento de entregas;
• Recordatorios de citas y de pago;
• Leads del sitio web directo al WhatsApp del vendedor;
• Sincronizar conversaciones con el CRM (mira cómo).

Preguntas frecuentes

¿Necesito la API oficial de Meta para usar la API?

No. En Zapini la API funciona con números conectados por código QR o por la Cloud API oficial. Para plantillas y alto volumen se recomienda la Cloud API.

¿Cuál es la diferencia entre API y webhook?

Tu sistema llama a la API (pides algo). La plataforma llama al webhook (te avisa que algo pasó).

¿Puedo recibir la confirmación de lectura?

Sí. Los eventos de estado indican cuándo el mensaje fue enviado, entregado y leído.

Pruébalo en la práctica

Zapini reúne WhatsApp (código QR o la Cloud API oficial), agentes de IA, CRM Kanban, flujos y API en una sola plataforma. Crea tu cuenta y configura tu primer flujo hoy.