Skip to main content

Gestión de Webhooks

Endpoints para administrar tus webhooks: listar, actualizar, probar, ver logs y eliminar.

Listar Webhooks

Obtén todos los webhooks configurados.
Response:

Actualizar Webhook

Modifica los eventos o estado de un webhook.

Probar Webhook

Envía un evento de prueba para verificar tu endpoint.
Response:
Usa el endpoint de test para verificar que tu servidor responde correctamente antes de activar el webhook.

Ver Logs

Obtén el historial de entregas de un webhook.
Response:

Eliminar Webhook


Política de Reintentos

Cuando tu endpoint falla, Whaapy reintenta automáticamente:
Máximo 3 reintentos con backoff exponencial. Timeout por request: 30 segundos.

Desactivación Automática

Si un webhook falla 10 veces consecutivas, se desactiva automáticamente para proteger ambos sistemas. Para reactivarlo:
Antes de reactivar, verifica que tu endpoint esté funcionando correctamente.

Mejores Prácticas

1. Responde Rápido

Tu endpoint debe responder en menos de 30 segundos. Procesa async si necesitas hacer trabajo pesado.

2. Implementa Idempotencia

Los webhooks pueden llegar más de una vez. Usa el timestamp y evento para detectar duplicados.
En producción, usa Redis o una base de datos en lugar de un Set en memoria.

3. Verifica la Firma

Siempre verifica la firma HMAC antes de procesar. Ver Seguridad.

4. Usa HTTPS

Los webhooks solo se envían a endpoints HTTPS. Para desarrollo local, usa:

5. Loggea para Debugging


Ejemplo Completo: Integración con CRM


Recursos Adicionales

Dashboard

Gestiona webhooks desde la UI

Eventos Disponibles

Lista completa de eventos