Entrada del registro de cambios publicada

Se activa cuando una entrada del registro de cambios se publica: en su primera publicación o al publicarse después de haber sido retirada. Publicar cambios en una entrada que ya está activa no vuelve a activar el evento, por lo que es seguro enviar un correo a tus usuarios desde aquí (comprueba primero data.public). Usa data.id para deduplicar si solo quieres enviar un correo por entrada.

POST changelog_entry.published

Token Bearer

curl 'https://api.ferndesk.com/v1/changelog_entry.published' \
  --request POST \
  --header 'webhook-id: whevt_01JXYC5R2K9M' \
  --header 'webhook-timestamp: 1752096000' \
  --header 'webhook-signature: v1,K5oT8v...base64...' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": "whevt_01JXYC5R2K9M",
  "type": "changelog_entry.published",
  "created_at": "2026-07-09T18:25:43.511Z",
  "data": {
    "id": "art_01JXY9AZK4KV",
    "title": "Faster search",
    "slug": "faster-search",
    "url": "https://docs.example.com/faster-search-A1B2C3",
    "date": "2026-09-30",
    "tags": [
      "new"
    ],
    "announce": true,
    "public": true,
    "content_html": "<p>Search results now load twice as fast.</p>",
    "content_markdown": "Search results now load twice as fast.",
    "published_at": "2026-09-30T14:02:11.000Z",
    "published_by_member_id": "mem_01JXYB8W4Q2H",
    "source": "editor",
    "changelog": {
      "id": "col_01JXYA6ABN52",
      "title": "Changelog",
      "url": "https://docs.example.com/changelog-C0L123"
    }
  }
}'

Esta respuesta no tiene cuerpo.

Entrega confirmada; cualquier otra respuesta se reintenta con retroceso progresivo.

Cabeceras

· 3

webhook-id string obligatorio

id del sobre, único por evento.

webhook-timestamp string obligatorio

Segundos Unix en los que se firmó la solicitud; rechaza valores obsoletos.

webhook-signature string obligatorio

Tokens separados por espacios v1, —puede haber varios durante la rotación de secretos— calculados como se describe en Verificación de firmas.

Cuerpo

obligatorio application/json

id string obligatorio

Identificador del evento, repetido en el encabezado webhook-id.

type string · enumeración obligatorio

Tipo de evento incluido en esta entrega.

valores

changelog_entry.published

created_at string obligatorio

Cuándo se creó el evento.

data object obligatorio

La entrada tal como se publicó, con el contenido representado como HTML y Markdown para que puedas enviarlo sin otra llamada a la API.

Cabeceras

Cuerpo

Respuestas