O Trigger Notion sincroniza com a API Notiondesk

A API Notiondesk permite que você publique suas edições do Notion assim que estiverem prontas: sincronize uma central de ajuda inteira, uma coleção ou um artigo, a partir de um script, um pipeline de CI ou sua própria ferramenta. Você também pode ativar ou desativar a sincronização agendada. Seu conteúdo permanece no Notion; uma sincronização o lê novamente e publica as alterações.

Nunca sincronizou nada? Leia primeiro Como sincronizar sua central de ajuda com o Notion .

Com a tradução automática ativada, cada sincronização traduz o conteúdo alterado e cobra por isso como caracteres traduzidos. Consulte os preços e a cobrança da tradução automática por IA antes de automatizar as sincronizações.

Sincronize toda a central de ajuda.

Notiondesk lê novamente todos os artigos e coleções do Notion e publica as alterações. A rota responde 204 No Content assim que a sincronização é enfileirada, e a sincronização é executada em segundo plano.

Apenas uma sincronização do site é executada por vez. Enquanto uma sincronização da central de ajuda estiver na fila ou em execução, seja agendada, iniciada pelo painel de controle ou pela API, outro gatilho responderá com o código 409 conflict_error. Aguarde alguns minutos e tente novamente.

Conteúdo que não foi alterado desde a última sincronização não será traduzido novamente.

Sincronizar uma coleção

Use o atributo id da lista de coleções . O atributo Notiondesk lê a coleção e cada um de seus artigos do Notion novamente e, em seguida, publica apenas os artigos editados desde a última sincronização. Artigos inalterados não são traduzidos nem cobrados novamente.

Sincronizar um artigo

Use o id do artigo da lista de artigos .

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"

A sincronização de artigos importa novamente os arquivos do artigo hospedados no Notion: imagens, vídeos, arquivos de texto, áudio, PDFs e conteúdos incorporados carregados no Notion. Para um artigo que contenha qualquer um desses elementos, cada chamada publica uma nova revisão e, enquanto a tradução automática estiver ativada, traduz e cobra novamente por cada idioma traduzido automaticamente, mesmo quando o texto permanece inalterado. O Notiondesk mantém 50 revisões por tradução, portanto, chamadas repetidas removem as revisões mais antigas do histórico de restauração.

Como a sincronização de coleções e artigos difere da sincronização do site?

Cada sincronização concluída atualiza toda a central de ajuda. Inicie uma sincronização após cada edição no Notion, e não com base em um temporizador. Para atualizações regulares, use a sincronização agendada.

Confirme uma sincronização.

Um gatilho de sincronização retorna 204 quando a sincronização é enfileirada, não quando termina. Sincronizações iniciadas pela API não aparecem no status de sincronização , que lista apenas as execuções agendadas.

Para confirmar a sincronização, leia o conteúdo publicado:

1. Inicie a sincronização e anote a hora.

2. Leia o artigo editado com GET /sites/{site_id}/articles/{article_id} a cada 30 segundos.

3. Pare quando last_updated for posterior ao horário que você anotou, ou text mostrar sua edição.

4. Se sync_failed for true, sync_error_code explica o motivo. Corrija o artigo no Notion e sincronize novamente.

Ativar ou desativar a sincronização agendada

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}'

A rota responde a 204 No Content. Leia o novo estado em auto_sync_enabled da central de ajuda e o cronograma em seu status de sincronização.

• Envie os valores booleanos JSON true ou false. Os valores 0 e "false" são lidos como true.

• A frequência de sincronização não pode ser alterada pela API: o envio de auto_sync_frequency responde com 400 validation_error. Altere-a no painel de controle.

• Seu plano deve incluir sincronização agendada.

• Ativar a sincronização agendada permite que sincronizações não supervisionadas iniciem traduções cobradas enquanto a tradução automática estiver ativada.

Essa rota precisa do escopo sync, e não do write, porque ela decide quando as sincronizações não assistidas são executadas.

Erros

conflict_error e request_in_progress são erros diferentes com o mesmo status: ramificação em code. Consulte Erros de API, limites de taxa e novas tentativas de tratamento de Notiondesk .

Perguntas frequentes

O que vem a seguir?

• Automatize tarefas comuns da central de ajuda com a API Notiondesk

• Leia artigos, coleções e entradas do changelog com a API Notiondesk

• Gerencie idiomas e tradução automática com a API Notiondesk