Trigger Notion se sincroniza con la API Notiondesk

La API Notiondesk te permite publicar tus ediciones de Notion en el momento en que estén listas: sincroniza un centro de ayuda completo, una colección o un artículo, desde un script, una canalización de CI o tu propia herramienta. También puedes activar o desactivar la sincronización programada. Tu contenido permanece en Notion; la sincronización lo vuelve a leer y publica los cambios.

¿Eres nuevo en la sincronización? Primero, lee Cómo sincronizar tu centro de ayuda con Notion .

Mientras la traducción automática esté activada, cada sincronización traduce el contenido que modifica y lo factura como caracteres traducidos. Consulta los precios y la facturación de la traducción automática con IA antes de automatizar las sincronizaciones.

Sincroniza todo un centro de ayuda

Notiondesk lee todos los artículos y colecciones de Notion nuevamente y publica los cambios. La ruta responde a 204 No Content tan pronto como se pone en cola la sincronización, y la sincronización se ejecuta en segundo plano.

Solo se ejecuta una sincronización del sitio a la vez. Mientras se ejecuta o se pone en cola una sincronización del centro de ayuda, ya sea programada, iniciada desde el panel de control o a través de la API, otro activador responde con el código 409 conflict_error. Espere unos minutos y vuelva a intentarlo.

El contenido que no ha cambiado desde su última sincronización no se vuelve a traducir.

Sincronizar una colección

Utilice la colección id de la lista de colecciones . Notiondesk vuelve a leer la colección y cada uno de sus artículos desde Notion, y luego publica solo los artículos editados desde su última sincronización. Los artículos sin cambios no se traducen ni se facturan de nuevo.

Sincronizar un artículo

Utilice el id del artículo de la lista de artículos .

curl -i -X POST "https://api.notiondesk.so/sites/c74781f6-1aea-4e17-ab23-bbb8b4d174b6/sync" \
  -H "Authorization: Bearer $NOTIONDESK_API_KEY" \
  -H "nd-version: 2026-10-16" \
  -H "Idempotency-Key: 9b2e4c1a-sync-after-notion-edit"

curl -i -X POST "https://api.notiondesk.so/sites/c74781f6-1aea-4e17-ab23-bbb8b4d174b6/categories/1761493027/sync" \
  -H "Authorization: Bearer $NOTIONDESK_API_KEY" \
  -H "nd-version: 2026-10-16" \
  -H "Idempotency-Key: 2c8e5b7d-sync-billing"

curl -i -X POST "https://api.notiondesk.so/sites/c74781f6-1aea-4e17-ab23-bbb8b4d174b6/articles/1761580412/sync" \
  -H "Authorization: Bearer $NOTIONDESK_API_KEY" \
  -H "nd-version: 2026-10-16" \
  -H "Idempotency-Key: 4d7a0f3e-sync-getting-started"

La sincronización de un artículo importa nuevamente los archivos del artículo alojados en Notion: imágenes, videos, archivos, audio, PDF y contenido incrustado. Para un artículo que contiene alguno de estos archivos, cada llamada publica una nueva revisión y, mientras la traducción automática esté activada, traduce y factura nuevamente cada idioma traducido automáticamente, incluso si el texto permanece sin cambios. Notiondesk conserva 50 revisiones por traducción, por lo que las llamadas repetidas eliminan las revisiones más antiguas del historial de restauración.

En qué se diferencian las sincronizaciones de colecciones y artículos de la sincronización de un sitio web.

Cada sincronización completa actualiza todo el centro de ayuda. Sincroniza una vez después de cada edición en Notion, no con un temporizador. Para actualizaciones periódicas, usa la sincronización programada.

Confirmar una sincronización

Un disparador de sincronización responde a 204 cuando la sincronización se pone en cola, no cuando finaliza. Las sincronizaciones iniciadas a través de la API no aparecen en el estado de sincronización , que solo muestra las ejecuciones programadas.

Para confirmar la sincronización, lea el contenido que publica:

1. Activa la sincronización y anota la hora.

2. Lee el artículo editado con GET /sites/{site_id}/articles/{article_id} cada 30 segundos.

3. Detente cuando last_updated sea posterior a la hora que anotaste, o cuando text muestre tu edición.

4. Si sync_failed es true, sync_error_code explica el motivo. Corrige el artículo en Notion y vuelve a sincronizar.

Activar o desactivar la sincronización programada

curl -i -X PATCH "https://api.notiondesk.so/sites/c74781f6-1aea-4e17-ab23-bbb8b4d174b6/settings/auto-sync" \
  -H "Authorization: Bearer $NOTIONDESK_API_KEY" \
  -H "nd-version: 2026-10-16" \
  -H "Content-Type: application/json" \
  -d '{"auto_sync_enabled": true}'

La ruta responde a 204 No Content. Lea el nuevo estado en auto_sync_enabled del centro de ayuda y el horario en su estado de sincronización.

• Envía los valores booleanos JSON true o false. Los valores 0 y "false" se leen como true.

• La frecuencia de sincronización no se puede cambiar a través de la API: al enviar auto_sync_frequency se obtiene el código 400 validation_error. Cámbiela en el panel de control.

• Tu plan debe incluir la sincronización programada.

• Al activar la sincronización programada, las sincronizaciones desatendidas inician la traducción facturada mientras la traducción automática está activada.

Esta ruta necesita el ámbito sync, no write, porque decide cuándo se ejecutan las sincronizaciones desatendidas.

Errores

conflict_error y request_in_progress son errores diferentes con el mismo estado: bifurcación en code. Consulte Manejo de errores de API, límites de velocidad y reintentos de Notiondesk .

Preguntas frecuentes

¿Qué sigue?

• Automatice las tareas comunes del centro de ayuda con la API Notiondesk.

• Lee artículos, colecciones y entradas del registro de cambios con la API Notiondesk

• Gestiona idiomas y traducción automática con la API Notiondesk