Webhooks

Entérate de publicaciones, tours completados y respuestas

Cueston envía un POST firmado a tu servidor cuando pasa algo en tu espacio de trabajo o en tu app. Elige qué eventos recibe cada endpoint.

Empezar gratisLee la documentación
Un evento content.published
{
  "id": "evt_…",
  "type": "content.published",
  "createdAt": "2026-10-26T09:30:00.000Z",
  "workspaceId": 42,
  "data": {
    "contentType": "tour",
    "contentId": 318,
    "name": "Invoice flow",
    "environment": "production",
    "version": 7,
    "versionId": 1290,
    "publishedBy": { "userId": 12, "email": "ada@acme.com" },
    "rollback": false
  }
}

Más de 200 empresas SaaS en crecimiento confían en nosotros

  • FreshTricks
  • Geek Dynamic
  • Kiteframe
  • Morrowbit
  • Ochreline
  • Tandemly

Lo que obtienes

  • Solicitudes firmadas

    Cada solicitud trae un encabezado Cueston-Signature: un HMAC-SHA256 con marca de tiempo, para que rechaces solicitudes falsas o repetidas.

  • Reintentos incluidos

    Una entrega fallida se reintenta a los 1 minuto, 5 minutos, 30 minutos, 2 horas y 12 horas.

  • Un registro que puedes reenviar

    Cada endpoint guarda 30 días de entregas. Reenvía cualquiera con el mismo id de evento.

Cómo funciona

De la idea a la guía en vivo, sin esperar un release.

  1. Agrega un endpoint

    En Configuración → Integraciones → Webhooks, agrega una URL https y elige los eventos. O usa POST /api/webhooks.

  2. Guarda el secreto de firma

    El secreto whsec_… se muestra una sola vez. Guárdalo en tu servidor.

  3. Verifica y responde

    Comprueba la firma sobre el cuerpo sin procesar y responde con cualquier 2xx en menos de 10 segundos. Haz el trabajo lento después.

  4. Envía un evento de prueba

    Enviar evento de prueba entrega un webhook.test firmado al instante y te muestra el resultado.

Qué incluye

Eventos de publicación
content.published (también al revertir) y content.unpublished, para tours, tooltips, banners, checklists, encuestas y anuncios.
Eventos de revisión
publish_request.created, publish_request.approved y publish_request.rejected.
Eventos de usuarios finales
guidance.completed, guidance.dismissed con el paso y el motivo, y survey.answered con cada respuesta y la puntuación NPS.
Eventos del equipo
member.joined, con el origen: invitación, inicio de sesión único o SCIM.
Rotación de secretos sin cortes
Tras rotar el secreto, las solicitudes llevan firmas del secreto nuevo y del anterior durante 24 horas mientras despliegas.

Preguntas

El `id` del evento es el mismo en reintentos y reenvíos. Úsalo para ignorar duplicados.

Míralo en tu propio producto

Agenda un recorrido corto de Cueston en tu app, o empieza gratis y crea el primero hoy.

Agenda una demoEmpezar gratis