Aggiorna le impostazioni del centro assistenza con l'API Notiondesk

L'API Notiondesk consente di modificare le impostazioni del centro assistenza tramite codice: indicizzazione nei motori di ricerca, titolo e descrizione della pagina in ogni lingua, ottimizzazione AI, modulo di contatto e registro delle modifiche. Utilizzala per applicare la stessa configurazione a più centri assistenza o per tenere le impostazioni sotto controllo di versione.

Le lingue e la traduzione automatica hanno un articolo dedicato: Gestisci lingue e traduzione automatica con l'API Notiondesk . Colori, caratteri e layout sono descritti in Personalizza il branding e i temi del centro assistenza con l'API Notiondesk .

Come funzionano gli aggiornamenti delle impostazioni

Ogni percorso in questa pagina segue le stesse regole:

• Invia solo i dati modificati. Un campo lasciato vuoto manterrà il suo valore corrente.

• La risposta è 204 No Content , senza corpo, anche quando non è cambiato nulla. Leggi il nuovo stato con GET /sites/{site_id}, come descritto in Consulta i tuoi centri di assistenza con l'API Notiondesk .

• Invia valori booleani JSON. Solo true o false: i valori 0 e "false" vengono letti come true.

• I campi sconosciuti vengono rifiutati con il codice 400 validation_error e non cambia nulla.

• I tentativi di ripetizione sono sicuri con un Idempotency-Key. Vedi Gestione degli errori API, dei limiti di frequenza e dei tentativi di ripetizione .

Indicizzazione nei motori di ricerca, titoli e descrizioni delle pagine

curl -i -X PATCH "https://api.notiondesk.so/sites/c74781f6-1aea-4e17-ab23-bbb8b4d174b6/settings/content" \
  -H "Authorization: Bearer $NOTIONDESK_API_KEY" \
  -H "nd-version: 2026-10-16" \
  -H "Content-Type: application/json" \
  -d '{"seo_indexing_enabled": true, "items": [{"locale": "fr", "page_title": "Centre d aide Example", "page_description": "Toutes les réponses sur Example"}]}'

Ogni oggetto in items:

Un oggetto modifica solo i campi che contiene e una lingua che si omette da items mantiene il suo titolo e la sua descrizione. items non può aggiungere o rimuovere una lingua.

Un errore in una lingua lo specifica nel percorso del campo, ad esempio items[fr].page_title.

seo_indexing_enabled: false chiede ai motori di ricerca di interrompere l'indicizzazione dell'intero centro assistenza. Vedi Impedire ai motori di ricerca di eseguire la scansione e l'indicizzazione del centro assistenza .

ottimizzazione dell'IA

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

Il tuo piano deve includere l'ottimizzazione AI. Scopri a cosa serve ogni funzionalità in "Configurazione dell'ottimizzazione AI" nel tuo centro assistenza e in "Introduzione all'ottimizzazione GEO/AI" .

Modulo di contatto

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

• L'API attiva o disattiva il modulo, niente di più. Gli indirizzi che ricevono le richieste sono impostati nella dashboard. Un corpo con destination_emails risponde con un codice 400 validation_error e non cambia nulla.

• Il modulo rimane attivo solo se è memorizzato un indirizzo. Attivandolo per un centro assistenza senza indirizzo, viene visualizzato il messaggio di errore 400 validation_error per destination_emails. Impostare prima un indirizzo nella dashboard. Per disattivare il modulo non è necessario specificare un indirizzo.

• Il tuo piano deve includere opzioni di personalizzazione avanzate, fino alla possibilità di disattivare completamente il modulo.

Registro delle modifiche

curl -i -X PATCH "https://api.notiondesk.so/sites/c74781f6-1aea-4e17-ab23-bbb8b4d174b6/settings/changelog" \
  -H "Authorization: Bearer $NOTIONDESK_API_KEY" \
  -H "nd-version: 2026-10-16" \
  -H "Content-Type: application/json" \
  -d '{"enabled": true, "reactions_enabled": true, "changelog_categories": [{"category_id": "2984612035", "color": "blue_sky"}]}'

Ogni oggetto in changelog_categories ha un category_id obbligatorio, il id di una delle tue collezioni e un color facoltativo di massimo 255 caratteri.

changelog_categories Sostituisce l'intero set. Una raccolta che si esclude smette di essere una raccolta di registro delle modifiche e le rimuove tutte. Leggere dall'inizio quando si desidera aggiungere solo un elemento. Il set può contenere fino a 100 raccolte.[]changelog_categoriesGET /sites/{site_id}

Il tuo piano deve includere il registro delle modifiche. Se le iscrizioni via email sono attive ma il tuo piano non include più le notifiche email del registro delle modifiche, ogni richiesta a questa rotta risponde con 403 permission_denied finché non invia "email_subscriptions_enabled": false.

Per saperne di più, consulta le guide "Configurare i registri delle modifiche nel centro assistenza" e "Come abilitare le iscrizioni via email per i registri delle modifiche" .

Errori

Consultare la sezione "Errori API, limiti di frequenza e tentativi" dell'handle Notiondesk per informazioni sull'intestazione dell'errore e sugli altri codici.

Domande frequenti

Cosa succederà dopo?

• Personalizza il branding e i temi del centro assistenza con l'API Notiondesk

• Gestisci le integrazioni del centro assistenza con l'API Notiondesk

• Gestisci le lingue e la traduzione automatica con l'API Notiondesk