Collegare origini dati esterne all’account Zendesk

Puoi collegare una fonte knowledge esterna al tuo account Zendesk per rendere i contenuti disponibili ovunque vengano usati contenuti esterni. Ogni connettore Knowledge dispone di una pagina di autenticazione specifica per il connettore che puoi configurare prima della connessione. Una volta effettuata la connessione, puoi usare la pagina Connessione per gestire la connessione. Qualsiasi aggiornamento o aggiunta a tali elementi verrà importato in Zendesk durante la prossima sincronizzazione.

Qual è il mio piano?

Tutte le suite

Team, Growth, Professional, Enterprise o Enterprise Plus

Support con

Knowledge Professional o Enterprise

Riepilogo: ◀▼

Puoi collegare fonti knowledge esterne al tuo account in modo che agenti e amministratori possano cercare e usare i contenuti di altri sistemi nelle esperienze di knowledge base. Usa connettori dedicati, se disponibili, o il connettore universale per le origini API REST. Puoi sincronizzare fino a 50 origini, gestire le connessioni in un secondo momento e mappare i campi API come titolo, corpo, URL e impostazioni locali per contenuti esterni ricercabili.

La possibilità di collegare contenuti esterni al tuo account Zendesk è disponibile per tutti i piani. Tuttavia, i limiti di memorizzazione per i dati esterni variano in base al piano. Consulta Gestione dello spazio di memorizzazione dati nell’account Zendesk .

Puoi collegare una fonte knowledge esterna al tuo account Zendesk per rendere i contenuti disponibili ovunque vengano usati contenuti esterni . Ogni connettore Knowledge dispone di una pagina di autenticazione specifica per il connettore che puoi configurare prima della connessione. Una volta stabilita la connessione, puoi usare la pagina Connessione per gestire la connessione . Qualsiasi aggiornamento o aggiunta a tali elementi verrà importato in Zendesk durante la prossima sincronizzazione.

Zendesk fornisce connettori knowledge dedicati per le origini knowledge esterne supportate. Se non è disponibile un connettore dedicato, il connettore universale offre un altro modo per acquisire knowledge da un’origine con un’API REST compatibile.

Puoi collegare fino a 50 origini di contenuti esterne al tuo account Zendesk e rendere i contenuti disponibili ovunque vengano usati contenuti esterni .

Questo articolo include i seguenti argomenti:

• Collegamento di contenuti esterni tramite un connettore knowledge dedicato
• Collegamento di contenuti esterni usando il connettore knowledge universale
• Informazioni di riferimento sull’autenticazione del connettore Knowledge

Articoli correlati:

• Informazioni sulla connessione di contenuti esterni a Zendesk per l'utilizzo nelle esperienze di knowledge base

Collegamento di contenuti esterni tramite un connettore knowledge dedicato

Puoi usare un connettore knowledge dedicato per collegare una fonte knowledge esterna al tuo account Zendesk e rendere i contenuti disponibili ovunque vengano usati contenuti esterni . Quando colleghi origini Knowledge esterne a Zendesk, le vedrai elencate come origine di ricerca esterna in Amministratore Knowledge.

Devi essere un amministratore Knowledge per configurare e gestire le connessioni ai contenuti esterni.

Per collegare contenuti esterni usando un connettore Knowledge dedicato

1. In Amministratore Knowledge, fai clic su Gestisci articoli ( ) nella barra laterale.
2. Fai clic su Contenuto esterno> Connessioni .
3. Nella sezione Origini disponibili , fai clic su Connetti in corrispondenza della fonte knowledge dedicata da connettere.
   Nota: Per usare il connettore universale, consulta Collegamento di contenuti esterni tramite il connettore universale della Knowledge .
4. Rivedi la messaggistica e fai clic su Continua per iniziare a configurare la connessione.
5. Inserisci le informazioni di autenticazione richieste per concedere a Zendesk l’autorizzazione ad accedere ai contenuti della fonte knowledge.

   I dettagli di autenticazione variano in base al connettore. Per informazioni specifiche sul connettore che stai configurando, consulta Informazioni di riferimento sull’autenticazione del connettore Knowledge .

6. Fai clic su Sincronizza.

   Il connettore Knowledge viene aggiunto alla pagina Connessioni e inizia la sincronizzazione. Per gestire le connessioni esistenti, consulta Gestione delle connessioni knowledge esterne .

Collegamento di contenuti esterni usando il connettore knowledge universale

Puoi usare un connettore knowledge universale per collegare un’origine knowledge esterna a Zendesk quando un connettore knowledge dedicato non è disponibile per tale origine. Il connettore universale recupera i contenuti tramite l’API REST dell’origine e li rende disponibili in Zendesk come knowledge esterna.

Quando configuri un connettore universale, fornisci le informazioni necessarie a Zendesk per accedere all’API di origine, inclusi l’endpoint API e le credenziali. Zendesk invia una richiesta all’origine per convalidare la connessione e recuperare una risposta di esempio. I campi restituiti nella risposta sono quindi disponibili per essere mappati ai campi di contenuto esterno corrispondenti in Zendesk. Se l’origine restituisce record su più pagine, puoi anche configurare il modo in cui Zendesk recupera le pagine successive.

Il connettore universale è destinato a wiki e Knowledge base accessibili tramite API che soddisfano i seguenti requisiti API:

• Interfaccia: API REST
• Metodo di richiesta: GET
• Formato risposta: JSON
• Autenticazione: Chiave API
• Recupero record: Il contenuto e i metadati obbligatori devono essere disponibili in ciascun record recuperato
• Impaginazione: Impaginazione configurabile
• Sincronizzazione: Aggiornamento completo ogni 24 ore

Devi essere un amministratore Knowledge per configurare il connettore universale. Dovresti anche avere familiarità con l’API della fonte knowledge che stai collegando.

Per collegare contenuti esterni usando il connettore Knowledge universale

1. In Amministratore Knowledge, fai clic su Gestisci articoli ( ) nella barra laterale.
2. Fai clic su Contenuto esterno> Connessioni .
3. Nella sezione Origini disponibili , fai clic su Connettore universale .
4. Rivedi la messaggistica sulla sincronizzazione della knowledge con un’API e fai clic su Continua per iniziare a configurare la connessione.
   Nota: Il connettore universale usa le autorizzazioni associate alle credenziali API usate per configurare la connessione. Le autorizzazioni specifiche dell’origine per singoli utenti o record non vengono mantenute o applicate in Zendesk.
5. Inserisci le informazioni di autenticazione richieste per concedere a Zendesk l’autorizzazione ad accedere ai contenuti della fonte knowledge. Consulta Connettore universale nella tabella di riferimento dell’autenticazione del connettore Knowledge seguente.
6. Fai clic su Sincronizza.

   Il connettore Knowledge viene aggiunto alla pagina Connessioni e inizia la sincronizzazione. Per gestire le connessioni esistenti, consulta Gestione delle connessioni knowledge esterne .

Informazioni di riferimento sull’autenticazione del connettore Knowledge

La tabella seguente elenca i campi di autenticazione obbligatori per ciascun connettore. Quando accedi al sistema a cui ti stai collegando, accedi con un account utente che disponga delle autorizzazioni corrette per i contenuti da sincronizzare con Zendesk.

Connettore	Dettagli di autenticazione e connessione
Amazon S3	Nella scheda Autentica, configura quanto segue: ID chiave di accesso e chiave di accesso segreta : Credenziali AWS IAM che concedono l’accesso a livello di codice al bucket Amazon S3 da sincronizzare. Le chiavi di accesso AWS vengono generate tramite la console AWS Identity and Access Management (IAM). Per maggiori informazioni, consulta Guida per gli sviluppatori AWS . Regione AWS : Regione AWS in cui è memorizzato il bucket. Nella scheda Definisci ambito, configura quanto segue: Nome bucket : Nome del bucket Amazon S3 da sincronizzare. Il connettore sincronizzerà tutti i tipi di file supportati (.docs, .xlsx e .md), le cartelle e le sottocartelle in un bucket.
Box	Accedi a Box con un account utente che disponga delle autorizzazioni corrette per i contenuti da sincronizzare con Zendesk. Configura quanto segue: Cartelle principali : Cartella principale da sincronizzare con l’account Zendesk. Puoi selezionare solo le cartelle di livello superiore nella directory principale; non è possibile selezionare sottocartelle o singoli file nella directory principale. Quando selezioni una cartella principale, la sincronizzazione include automaticamente tutte le sottocartelle e i tipi di file supportati (docx, .xlsx, .html e .md) in quella cartella. Quando configuri una connessione Box, selezioni le cartelle principali che risiedono nella directory principale della Knowledge base Box. Quando il connettore si sincronizza, tutti i contenuti supportati all’interno della cartella principale (inclusi le sottocartelle e i file supportati) verranno sincronizzati con il tuo account Zendesk.
Confluence	Accedi a Confluence con un account utente che disponga delle autorizzazioni corrette per i contenuti da sincronizzare con Zendesk. Configura quanto segue: Sito Confluence : Sito Confluence che vuoi collegare. Spazi : Spazi che vuoi collegare. Nel menu a discesa vengono visualizzati solo i primi 20 spazi (mostrati in ordine alfabetico). Per selezionare uno spazio che non appare nel menu, inizia a digitare il nome dello spazio nella casella di ricerca, quindi selezionalo quando viene visualizzato. Per rimuovere uno spazio, fai clic sulla X nel tag dello spazio. Non sono consentite connessioni agli spazi personali in Confluence.
Contentful	Nella scheda Autentica, configura quanto segue: ID spazio di contenuti : Identificatore dello spazio Contentful che vuoi collegare a Zendesk. Per ulteriori informazioni su come trovare l’ID Contentful Space, consulta il centro assistenza Contentful . Chiave API: ( API Content Delivery - token di accesso in Contentful) Credenziale che concede l’accesso a livello di codice alla lettura dei contenuti memorizzati nel tuo spazio Contentful. Nella scheda Aggiungi URL pubblico, configura quanto segue: Formato URL* (obbligatorio) : Formato URL per la pagina pubblica che ospita i contenuti di Contentful. Il formato URL può essere: un campo contenente l’URL completo, ad esempiofields.url una stringa URL con uno o più segnaposto, comehttps://zendesk.com/{fields.slug} I segnaposto possono fare riferimento ai campi di immissione (fields.<fieldId> ) e i metadati delle voci (sys.<key> ), comesys.id . Il connettore Knowledge importa solo i contenuti che possono essere associati a un URL. Se non è possibile creare l’URL nel formato URL perché mancano i campi obbligatori, il record viene saltato durante la sincronizzazione dei contenuti.
Document360	Nella scheda Autentica, configura quanto segue: Seleziona server : Seleziona la regione del server in cui è ospitato il tuo account Document360 (UE, USA o privato). Se selezioni Privato, ti verrà chiesto anche di inserire il sottodominio per il tuo account di hosting privato Document360. Token API: Inserisci il token API creato nell’account Document360 per questa connessione. Nella scheda Definisci ambito, configura quanto segue: Spazio di lavoro : Seleziona lo spazio di lavoro pubblico da sincronizzare. Lingue : Seleziona la lingua della Knowledge base da sincronizzare. Questa connessione sincronizzerà solo i contenuti di Document360 nella lingua specificata qui. Devi creare una nuova connessione per ogni lingua. Categorie : Seleziona le categorie da sincronizzare. Ogni categoria o sottocategoria selezionata apparirà come tag nel campo Categorie. Quando selezioni una categoria, sincronizzi solo i contenuti che risiedono a livello di categoria; non stai sincronizzando le sottocategorie all’interno di quella categoria. Devi selezionare sia le categorie che le sottocategorie che contengono il contenuto da sincronizzare. Ogni volta che crei una connessione, devi fornire un token API univoco. Quando crei token API in Document360 da usare con Zendesk, assicurati di specificare GET come metodo HTTP consentito. Per maggiori informazioni, consulta la documentazione di Document360 .
Dropbox	Accedi a Dropbox con un account utente che disponga delle autorizzazioni corrette per i contenuti che vuoi sincronizzare in Zendesk (.docs, .xlsx, .html e .md.) Seleziona la cartella principale da sincronizzare con l’account Zendesk. Puoi selezionare solo le cartelle di livello superiore nella directory principale; non è possibile selezionare sottocartelle o singoli file nella directory principale. Quando selezioni una cartella principale, la sincronizzazione include automaticamente tutte le sottocartelle e i tipi di file supportati in quella cartella.
Freshdesk	Configura quanto segue: Dominio : Dominio Freshdesk attuale. Questo è il sottodominio scelto al momento della creazione dell’account (ad esempio, tuaazienda.freshdesk.com). Chiave API : Chiave API Freshdesk che consente a Zendesk di comunicare direttamente con il tuo account Freshdesk. Zendesk importa solo i contenuti dalle impostazioni locali predefinite.
Google Drive	Accedi a Google con un account utente che disponga delle autorizzazioni corrette per i contenuti che vuoi sincronizzare con Zendesk e consenti a Zendesk di accedere ai tuoi file Google Drive. Seleziona le unità da sincronizzare. Il connettore Google Drive supporta Documenti e Fogli Google. Inoltre, il connettore Google Drive sincronizza i contenuti del tuo Google Drive condiviso. I contenuti di Google Drive privati non sono sincronizzati. Puoi iscriverti al programma EAP per l’acquisizione di PDF per abilitare la sincronizzazione dei documenti PDF .
Guru	Nella scheda Autentica, configura quanto segue: Email : Indirizzo email usato per accedere al tuo account Guru. Devi essere un amministratore Guru per creare una connessione e puoi sincronizzare solo i contenuti a cui hai l’autorizzazione ad accedere in Guru. Token API: Token utente associato al tuo indirizzo email in Guru. Il token utente fornisce l’accesso in lettura e scrittura in Guru in base alle autorizzazioni dell’account esistenti. Fai clic su Gestisci> API Accedi sopra questo campo per accedere alla pagina in Guru in cui puoi generare il token utente. Per maggiori informazioni, consulta Utilizzo dell’API di Guru nel centro assistenza di Guru. Nella scheda Definisci ambito, configura quanto segue: Raccolta : Raccolta Guru che contiene il contenuto pubblicato da sincronizzare.
HubSpot	Accedi a HubSpot con un account utente che disponga delle autorizzazioni corrette per i contenuti da sincronizzare con Zendesk. Zendesk importa i post del blog pubblicati (sia interni che pubblici) da tutte le impostazioni locali.
Jira	Seleziona l’account JIRA da sincronizzare con l’account Zendesk. Inserisci le seguenti informazioni: Sito Jira : Inserisci il sito Jira da sincronizzare. Questo campo visualizza tutti i siti Jira a cui hai accesso. Ogni sito Jira è mappato a una singola connessione Jira . Se vuoi sincronizzare più siti, devi creare una nuova connessione per ciascun sito. Seleziona spazi : Inserisci lo spazio Jira da sincronizzare. Questo campo visualizza tutti gli spazi a cui hai accesso nel sito Jira selezionato. Ogni spazio selezionato viene visualizzato come tag nel campo Spazi. Puoi rimuovere gli spazi selezionati per errore facendo clic sull’icona X nel tag dello spazio. I contenuti sincronizzati includono quanto segue: Chiave problema Riepilogo Descrizione Stato Priorità Tipo Etichette Commenti
Notion	Seleziona lo spazio di lavoro Notion dall’elenco a discesa in alto a destra. Seleziona le pagine del tuo spazio team da sincronizzare, quindi consenti l’accesso a tali pagine. A causa delle limitazioni di Notion, puoi configurare una sola connessione Notion nel tuo account Zendesk. Per aggiungere o rimuovere contenuti da questa connessione, consulta Aggiunta o rimozione di contenuti dalla connessione Notion . Affinché le pagine possano essere sincronizzate con il tuo account Zendesk, devono avere contenuti all’interno del corpo della pagina.
Salesforce	Accedi a Salesforce con un account utente che disponga delle autorizzazioni corrette per i contenuti da sincronizzare con Zendesk. Zendesk importa la versione più recente degli articoli pubblicati (sia interni che pubblici) da tutte le impostazioni locali.
SharePoint	Accedi a Microsoft con un account utente che disponga delle autorizzazioni corrette per i contenuti da sincronizzare con Zendesk. Seleziona il sito di SharePoint dall’elenco a discesa. I tipi di file supportati sono docx, .xlsx e .md. Puoi iscriverti al programma EAP per l’acquisizione di PDF per abilitare la sincronizzazione dei documenti PDF .
Zendesk	Inserisci le informazioni richieste per tutte le connessioni (pubbliche e non pubbliche): URL Zendesk : URL del tuo account Zendesk Se vuoi sincronizzare contenuti non pubblici che richiedono l’accesso dell’utente, fai clic su Attiva , quindi seleziona una delle seguenti opzioni di autenticazione: OAuth 2.0 (consigliato) : Verifica le autorizzazioni, quindi fai clic su Consenti . Token email e API : Inserisci le informazioni nei campi seguenti, quindi fai clic su Continua . Email : Indirizzo email associato al tuo account Zendesk. Queste informazioni vengono combinate con il token API per accedere e sincronizzare i contenuti interni. Token API: Token API che puoi usare per sincronizzare articoli non pubblici con il tuo account Zendesk. Se lasci vuoto questo campo, verranno sincronizzati solo i contenuti visibili agli utenti anonimi. Seleziona le impostazioni locali (facoltative) per gli articoli da sincronizzare. Impostazioni locali degli articoli da sincronizzare. Se lasci vuoto questo campo, gli articoli associati a tutte le impostazioni locali verranno sincronizzati. Se non specifichi un token API con email e impostazioni locali, ogni connessione conterrà i contenuti disponibili pubblicamente in tutte le impostazioni locali per quel sottodominio. Tutti gli articoli pubblicati che soddisfano questi criteri vengono sincronizzati con la connessione. Se vuoi sincronizzare i contenuti da un altro sottodominio Zendesk, devi aggiungere una nuova connessione per quel sottodominio.
Connettore universale	Autenticazione Per configurare la connessione, inserisci le seguenti informazioni. Zendesk invierà una richiesta all’endpoint configurato per verificare che possa raggiungere l’origine ed eseguire l’autenticazione usando le credenziali fornite. Nome : Identificatore da assegnare alla connessione. URL API : Endpoint API per il contenuto di origine. Parametri di query : Coppia chiave-valore facoltativa aggiunta alla fine dell’URL API per controllare i dati restituiti nella risposta dell’endpoint. Puoi inserire fino a cinque parametri di query. Per configurare un parametro di query, seleziona la casella di spunta Parametri di query , quindi inserisci il parametro e il valore nei campi forniti. Chiave API: Chiave API per identificare e autenticare Zendesk quando si effettuano richieste all’API. Questa chiave viene in genere generata nelle impostazioni sviluppatore o API. Mappature campi Le mappature dei campi determinano il modo in cui i contenuti e i metadati restituiti dall’API di origine vengono memorizzati come contenuti esterni in Zendesk. Per definire l’aspetto dei dati in Zendesk, configura i seguenti campi di mappatura: Identificatore univoco : Identificatore obbligatorio per ciascun elemento Titolo : Intestazione articolo Corpo : Contenuto usato dalle funzionalità AI URL : URL del contenuto pubblico Ultimo aggiornamento: Quando il contenuto è stato modificato l’ultima volta Impostazioni locali : Lingua contenuto Impaginazione Durante la sincronizzazione, Zendesk segue la strategia di impaginazione configurata fino a quando non recupera tutti i record disponibili. Se l’API di origine restituisce record su più pagine, seleziona e configura una delle seguenti strategie di impaginazione che corrisponda all’API di origine: Cursore : Usa un identificatore o un token univoco per contrassegnare la posizione nel dataset. Quando l’opzione è selezionata, configura i seguenti valori: Parametro cursore (obbligatorio) : Il nome del parametro di query che l’API si aspetta alla richiesta successiva (ad esempio,cursor ,after , oppurepageToken ). Zendesk invia questo parametro con il valore del cursore della risposta precedente. La prima richiesta viene inviata senza questo parametro. Posizione del cursore nella risposta (obbligatorio) : Il percorso della notazione a punti al valore del cursore successivo nella risposta JSON (ad esempio,meta.next_cursor oppurepagination.next ). Rilevamento ultima pagina (facoltativo) : Il percorso con notazione a punti di un campo booleano che indica se esistono più pagine (ad esempio,meta.has_more ). Lascia vuoto se l’API segnala l’ultima pagina restituendo un cursore nullo o vuoto. Offset : Specifica il punto iniziale nel dataset e il numero massimo di record da includere in ciascuna pagina. Quando l’opzione è selezionata, configura i seguenti valori: Parametro pagina : Il parametro che Zendesk invia per richiedere la pagina successiva (in generepage ,offset , oppureskip . Valore prima pagina : Valore previsto dall’API. Selezionando il valore sbagliato, il primo batch viene saltato. Link successivo : Il server API fornisce l’URL completo e preformattato della pagina successiva direttamente nella sua risposta. Quando l’opzione è selezionata, configura i seguenti valori: Posizione del link successivo nella risposta : La posizione in cui l’URL della pagina successiva si trova nella risposta (in generenext ,next-page o all’interno di un oggetto link. Intestazione link successivo : Zendesk cerca ilnext parola chiave nelle intestazioni delle risposte. Nessuno : Zendesk recupera tutti i contenuti in un’unica richiesta.

Avvertenza sulla traduzione: questo articolo è stato tradotto usando un software di traduzione automatizzata per fornire una comprensione di base del contenuto. È stato fatto tutto il possibile per fornire una traduzione accurata, tuttavia Zendesk non garantisce l'accuratezza della traduzione.

Per qualsiasi dubbio sull'accuratezza delle informazioni contenute nell'articolo tradotto, fai riferimento alla versione inglese dell'articolo come versione ufficiale.