👉 Solicita tu acceso aquí por WhatsApp y recibe la mejor solución en minutos.
En el ecosistema digital actual, WhatsApp Business API se ha convertido en una herramienta clave para empresas que buscan automatizar la comunicación con sus clientes. Entre sus funcionalidades más útiles se encuentra la posibilidad de configurar webhooks, los cuales permiten recibir notificaciones en tiempo real sobre los eventos que ocurren en tu cuenta de WhatsApp, como mensajes entrantes, estados de entrega y confirmaciones de lectura.
En este artículo te explicaré qué es un webhook, cómo configurarlo en la API de WhatsApp y te mostraré ejemplos paso a paso para que lo integres en tu aplicación.
¿Qué es un Webhook?
Un webhook es un mecanismo que permite a una aplicación enviar datos automáticamente a otra aplicación en tiempo real, sin necesidad de que el receptor haga consultas periódicas.
En el caso de WhatsApp API, un webhook sirve para que tu servidor reciba información sobre eventos como:
- Recepción de un mensaje nuevo.
- Confirmación de entrega o lectura.
- Cambios en el estado de un mensaje (enviado, entregado, leído, fallido).
- Notificaciones sobre plantillas de mensajes.
Con un webhook bien configurado, tu sistema puede reaccionar automáticamente a estos eventos, por ejemplo: responder a un cliente, guardar conversaciones en tu CRM o activar flujos de soporte.
Requisitos previos
Antes de configurar un webhook, necesitas:
- Una cuenta activa de WhatsApp Business API (puedes obtenerla en WhatzMeAPI).
- Un servidor con HTTPS válido (SSL/TLS).
- Acceso al panel de configuración de la API o la posibilidad de usar endpoints para establecer la URL del webhook.
- Conocimientos básicos de programación (Node.js, PHP, Python o Java).
Paso 1: Crear el endpoint en tu servidor
El primer paso es tener un endpoint en tu backend que reciba las solicitudes POST enviadas por WhatsApp.
Ejemplo en Node.js (Express):
const express = require("express");
const bodyParser = require("body-parser");
const app = express();
app.use(bodyParser.json());
app.post("/webhook", (req, res) => {
console.log("Evento recibido:", JSON.stringify(req.body, null, 2));
res.sendStatus(200); // Confirmar recepción
});
app.listen(3000, () => {
console.log("Servidor escuchando en puerto 3000");
});
Paso 2: Registrar el Webhook en WhatsApp API
Con tu endpoint listo, ahora debes registrarlo en la API.
Ejemplo usando cURL:
curl -X POST https://api.whatzmeapi.com/basic/webhook \
-H "Content-Type: application/json" \
-H "Authorization: Bearer TU_TOKEN_API" \
-d '{
"url": "https://tuservidor.com/webhook",
"events": ["messages", "statuses"]
}'
En este ejemplo:
"url"es tu endpoint HTTPS donde recibirás notificaciones."events"define qué eventos quieres escuchar (mensajes, estados, etc.).
Paso 3: Validar la configuración
Una vez configurado, WhatsApp enviará un evento de prueba a tu endpoint para confirmar que la URL funciona.
En tu consola deberías ver algo como:
{
"messages": [
{
"from": "5215551234567",
"id": "ABGGFlA5FpafAgo6ZtWd",
"timestamp": "1694644800",
"text": { "body": "Hola, quiero información" },
"type": "text"
}
]
}
Buenas prácticas al usar Webhooks
- Usa siempre HTTPS para mayor seguridad.
- Registra y almacena los eventos en una base de datos.
- Implementa un sistema de reintentos en caso de que tu servidor falle.
- Filtra eventos para evitar procesar duplicados.
- Nunca expongas tu token de API en el código público.
Conclusión
La configuración de webhooks en WhatsApp API es fundamental para automatizar la interacción con tus clientes y mejorar la eficiencia de tus procesos de comunicación. Con pasos sencillos puedes:
- Recibir mensajes en tiempo real.
- Monitorear estados de entrega y lectura.
- Automatizar respuestas y flujos de soporte.
👉 Da el siguiente paso y visita www.whatzmeapi.com para comenzar hoy mismo. 🚀
