Webhooks
Próximamente
El soporte para webhooks está planificado para el Q2 de 2026. Esta página documentará los topics, la verificación de firma y la semántica de reintento.
Topics planificados
| Topic | Cuándo se dispara |
|---|---|
product.synced | Un producto se sincroniza desde la plataforma a Clione |
product.enriched | El enriquecimiento de un producto termina (éxito o fallo) |
product.manually_edited | Un usuario sobrescribe campos de IA desde el Edit del dashboard |
product.rolled_back | Un usuario restaura una versión pasada del enriquecimiento |
faq.submitted | Un storefront envía una FAQ vía el formulario público |
faq.approved / faq.rejected | Un admin revisa una FAQ enviada |
enrichment.bulk_completed | Termina un re-enriquecimiento masivo |
Verificación de firma (planificado)
Todos los webhooks se firmarán con HMAC-SHA256 usando un secreto por tenant (rotable desde el dashboard). Cabeceras:
X-Clione-Signature— HMACX-Clione-Event— nombre del topicX-Clione-Timestamp— epoch ms, rechaza cualquier cosa con más de 5 min
Política de reintento (planificado)
- En respuesta no-2xx: backoff exponencial (1s, 5s, 30s, 2m, 10m, 1h, 6h)
- Tras 7 fallos, marca el endpoint como degradado y notifica al admin del tenant
- Dead-letter queue para replay manual desde el dashboard
Hasta que lleguen los webhooks, puedes hacer polling a GET /api/v1/{platform}/products?updated_since=<ISO> para detectar cambios.