Configuración de Webhooks
Los webhooks son herramientas que permiten enviar y recibir mensajes automáticamente en distintas plataformas como WhatsApp, redes sociales, comercio electrónico, etc. Son útiles para:
- Sincronizar datos.
- Enviar notificaciones en tiempo real.
- Automatizar procesos.
Un webhook funciona como un puente entre aplicaciones: cuando ocurre un evento (como recibir un mensaje en WhatsApp), una aplicación (el proveedor) envía automáticamente una solicitud HTTP POST a una URL específica (el punto final) configurada por otra aplicación (el consumidor), incluyendo los datos relevantes al cuerpo de la solicitud (el mensaje).
Establece Webhook Url
Configura tu webhook para recibir mensajes de usuarios.
POST https://api.jelou.ai/v1/bots/:botId/webhook/
Parámetros de la ruta
| Nombre | Tipo | Descripción |
|---|---|---|
| botId | string | ID del bot |
Cuerpo de la solicitud
| Nombre | Tipo | Descripción | Obligatorio |
|---|---|---|---|
| webhookUrl | string | URL del webhook / endpoint donde los mensajes serán reenviados. | Sí |
Respuestas
✅ 200: Tu webhookUrl ha sido actualizada exitosamente
{
"message": [
{
"webhookUrl": "<url>"
}
],
"status": "success"
}
❌ 500: Error al configurar los ajustes.
{
"message": ["Couldn't set setting"],
"status": "failed"
}
El servidor intentará nuevamente enviar la solicitud a tu servidor 3 veces si no recibe un código de estado 200 como respuesta.