Abre primero Webhooks en el panel: cada entrega muestra la respuesta HTTP o el error que obtuvimos. La mayoría de los problemas son uno de estos casos.
No se envía nada
El proyecto no tiene URL del webhook. Añádela en los ajustes del proyecto; solo enviamos a la dirección guardada en el proyecto.
Las entregas fallan
- No es una dirección https pública. Se rechazan http sin cifrar, las direcciones locales y las redes privadas.
- Redirecciones. No las seguimos. Usa la dirección final, con el www y la barra final correctos.
- Bloqueo por firewall o protección antibots. Deja pasar nuestras peticiones POST en esa ruta.
- Respuesta incorrecta. Solo cuenta un estado 2xx. Responde en pocos segundos y haz el trabajo lento después.
- Tu código falla. Revisa el registro de errores de tu servidor a la hora de la entrega fallida.
La firma no coincide
- Usa el secreto de firma del webhook, no el secreto de la API.
- Calcúlala sobre el cuerpo sin procesar, tal como llega, antes de parsearlo.
- Tras generar un nuevo secreto del webhook, actualiza tu servidor.
Reintentos y avisos
Las entregas fallidas se reintentan durante unos dos días. Tras tres fallos seguidos en eventos reales, el titular del proyecto recibe un único correo; el aviso se rearma tras la siguiente entrega correcta.
¿Ya está resuelto?
Pulsa Reenviar en las entregas fallidas, en Webhooks, o Enviar test.ping en la página del proyecto para comprobar el endpoint. ¿Sigues atascado? Contáctanos desde la página de contacto con el ID de la entrega.