Un webhook es una URL de tu servidor a la que llamamos cuando pasa algo, para que tu código no tenga que preguntar una y otra vez.
Configurar uno
- En Desarrolladores, elige Webhooks y después Añadir endpoint.
- Escribe una URL HTTPS y elige los eventos que quieras, por ejemplo
question.completed. - Copia el secreto de firma. Se muestra una sola vez.
Eventos
Preguntas reservadas, completadas, incompletas, canceladas o rechazadas; créditos comprados, escasos o a punto de caducar; reclamaciones resueltas; y una conexión cerca de su tope.
Comprobar la firma
Cada envío lleva una cabecera x-50heads-signature con una marca de tiempo y un HMAC-SHA256 del cuerpo hecho con tu secreto. Compruébala antes de fiarte del contenido. La documentación de webhooks (en inglés) tiene código para copiar.
Reintentos
Responde con un estado 2xx en menos de diez segundos. Si no, reintentamos con esperas crecientes, ocho veces a lo largo de 24 horas. El registro Envíos muestra cada intento, y puedes repetir cualquier envío.
A veces un envío llega dos veces o desordenado. Usa el id del evento para ignorar los repetidos.