Webhooks

Recibe un HTTP POST firmado cada vez que ocurre algo en un proyecto, sin necesidad de polling. Los webhooks alimentan los conectores de LLM Pulse para Zapier, Make y n8n y funcionan con cualquier backend personalizado. Disponible en el plan Scale o superior.

  • Tipos de evento: mention.created, competitor_mention.created, citation.created, prompt_execution.completed, sentiment.negative_detected (sentimiento de marca negativo o muy negativo), recommendation.completed, intelligence_task.completed.
  • Seguridad: cada entrega incluye X-LLMPulse-Event, X-LLMPulse-Delivery (id único) y X-LLMPulse-Signature (sha256=<hex>, HMAC-SHA256 del cuerpo en bruto calculado con el secreto de la suscripción). Verifica la firma para autenticar las entregas.
  • Entrega: una respuesta 2xx confirma el evento; cualquier otra se reintenta 5 veces con retroceso exponencial. Las suscripciones se desactivan automáticamente tras 20 entregas fallidas consecutivas.

POST/webhooks

Crea una suscripción. Idempotente: volver a enviar el mismo proyecto + evento + URL devuelve la suscripción existente. El secreto de firma (whsec_...) solo lo devuelve este endpoint; guárdalo para verificar las firmas de las entregas. Requiere una clave con ámbito read_write.

Cuerpo (JSON):
  • project_idobligatorio
  • event_typeobligatorio; consulta la lista de eventos anterior
  • target_urlobligatorio; URL HTTPS pública; se rechazan las IP privadas, localhost y los nombres de host internos

Máximo 100 suscripciones activas por cuenta.

GET/webhooks

Lista las suscripciones activas de la cuenta. Los elementos coinciden con la respuesta de creación, sin el secreto.

Parámetros:
  • project_idfiltro opcional
  • page
  • per_pagemáximo 100

DELETE/webhooks/:id

Elimina una suscripción. La URL de destino deja de recibir eventos de inmediato. Requiere una clave con ámbito read_write.

Ruta:
  • :idid de la suscripción

Devuelve ERR_NOT_FOUND para suscripciones que no pertenezcan a la cuenta.

GET/webhooks/sample/:event_type

Hasta 3 payloads de ejemplo por tipo de evento, generados a partir de los datos reales más recientes del proyecto (o una muestra estática si el proyecto aún no tiene datos). Lo usan editores de integraciones como el cargador de ejemplos de Zapier. También disponible como herramienta MCP get_webhook_sample.

Parámetros:
  • :event_typeruta
  • project_idobligatorio