Introduzione
Connettere Salesforce in modo che l'assistente IA e gli agenti possano effettuare ricerche negli oggetti Salesforce selezionati nel momento in cui un utente pone una domanda.
Si tratta di un connettore live. Nessun dato di Salesforce viene copiato, indicizzato o archiviato in Docebo. Quando un utente pone una domanda, Docebo effettua la ricerca in quel momento negli oggetti Salesforce resi disponibili, utilizzando l'account Salesforce dell'utente stesso.
Come funzionano i permessi per Salesforce: ogni collega connette il proprio account Salesforce la prima volta che pone una domanda. Ogni ricerca viene quindi eseguita come quell'utente, perciò Salesforce applica le proprie regole di accesso e l'utente vede solo i record che Salesforce gli consente di vedere. L'account Salesforce di ciascun utente deve disporre del permesso API Enabled (vedere Impostazioni obbligatorie).
1. Prerequisiti nel sistema sorgente
Ruolo obbligatorio
È necessario un amministratore Salesforce in grado di creare un'app client esterna.
Impostazioni obbligatorie
Ogni persona che porrà domande sui dati Salesforce deve disporre di un utente Salesforce con il permesso API Enabled. Il profilo Amministratore del sistema e la maggior parte dei profili standard lo includono.
Per verificarlo, aprire Profiles in Salesforce, fare clic sul profilo dell'utente e cercare API Enabled tra i relativi permessi. Anche un set di autorizzazioni può concederlo.
2. Preparazione nel sistema sorgente
Creare un'app client esterna in Salesforce e copiarne il Consumer Key e il Consumer Secret in Docebo.
Si dispone già di un'app? Riutilizzarla. Aprirla in External Client App Manager e controllare le impostazioni delle sezioni Attivare OAuth e aggiungere l'URL di callback, Richiedere il secret e creare l'app e Consentire agli utenti di connettersi: l'URL di callback, i quattro ambiti, Require secret for Web Server Flow e Relax IP restrictions. Quindi proseguire con Copiare il Consumer Key e il Consumer Secret.
Aprire la pagina New External Client App
- In Docebo, nella scheda Autorizza, fare clic su Apri la pagina New External Client App. Salesforce si apre in una nuova scheda.
- Se Salesforce lo richiede, accedere con un account amministratore Salesforce.
- Viene visualizzato il modulo New External Client App. Tenere aperta questa finestra.
Se il link non apre il modulo: in Salesforce, fare clic sull'icona a forma di ingranaggio in alto a destra, quindi su Setup. Digitare External Client App Manager in Quick Find, aprirlo e fare clic su New External Client App.
Assegnare un nome all'app
In Basic Information:
- External Client App Name: digitare un nome, ad esempio "Docebo AI knowledge".
- API Name: viene compilato automaticamente da Salesforce.
- Contact Email: digitare il proprio indirizzo email.
- Distribution State: lasciare Local.
Non fare ancora clic su Create.
Attivare OAuth e aggiungere l'URL di callback
- Scorrere verso il basso e fare clic su API (Enable OAuth Settings) per espandere la sezione.
- Selezionare Enable OAuth.
- Incollare l'URL di callback in Callback URL. Deve corrispondere esattamente. Segue questo schema: https://[YOUR-DOCEBO-PLATFORM-URL]/knowledge/v1/integrations/connections/callback, ad esempio https://demo.docebosaas.com/knowledge/v1/integrations/connections/callback.
- In OAuth Scopes, selezionare ciascuno dei quattro ambiti indicati di seguito in Available OAuth Scopes e spostarlo in Selected OAuth Scopes con il pulsante a forma di freccia.
| Ambito | Codice |
|---|---|
| Manage user data via APIs | api |
| Perform requests at any time | refresh_token, offline_access |
| Access unique user identifiers | openid |
| Access the identity URL service | id, profile, email, address, phone |
Richiedere il secret e creare l'app
- Scorrere verso il basso fino a Security.
- Selezionare Require secret for Web Server Flow e Require secret for Refresh Token Flow.
- Lasciare invariato tutto il resto. Le caselle selezionate in grigio sono impostate da Salesforce e non possono essere modificate.
- Fare clic su Create in fondo alla pagina.
Consentire agli utenti di connettersi
Salesforce mostra ora la pagina della nuova app.
- Nella scheda Policies, fare clic su Edit.
- Fare clic su OAuth Policies per espandere la sezione.
- In App Authorization, impostare IP Relaxation su Relax IP restrictions.
- Lasciare Permitted Users su All users can self-authorize e il criterio del token di aggiornamento su 30 days.
- Fare clic su Save.
Copiare il Consumer Key e il Consumer Secret
- Aprire la scheda Settings dell'app e fare clic su OAuth Settings per espandere la sezione.
- Fare clic su Consumer Key and Secret. Salesforce apre una nuova scheda.
- Salesforce invia un codice di verifica via email. Digitarlo e fare clic su Verify.
- Fare clic su Copy accanto a Consumer Key e incollarlo in Consumer key in Docebo.
- Fare clic su Copy accanto a Consumer Secret e incollarlo in Consumer secret in Docebo.
3. Azioni obbligatorie in Docebo
| Informazioni da inserire | Dove trovarle |
|---|---|
| Consumer key | Salesforce → app creata → Settings → OAuth Settings → Consumer Key and Secret |
| Consumer secret | Salesforce → app creata → Settings → OAuth Settings → Consumer Key and Secret |
Autorizzare il connettore
- Andare in Componenti aggiuntivi e integrazioni → Connettori di conoscenze → Crea → Salesforce. Questo menu è visibile solo ai Superadmin. Nella scheda Quadro generale, controllare gli elementi oggetto della ricerca e selezionare Inizia.
Nella scheda Configurazione, indicare a Docebo quale org Salesforce utilizzare. Aprire Salesforce in un'altra scheda del browser ed effettuare l'accesso, copiare l'intero indirizzo dalla barra degli indirizzi e incollarlo in Incolla l'indirizzo Salesforce (consigliato). Va bene qualsiasi pagina di Salesforce, ad esempio la home page. Questo metodo funziona per ogni org, incluse quelle che bloccano la pagina di login standard. Docebo mostra quindi l'indirizzo da cui gli utenti effettueranno l'accesso. In alternativa, scegliere Usa la pagina di login predefinita (login.salesforce.com, per l'ambiente di produzione o la Developer Edition) oppure Usa la pagina di login della sandbox (test.salesforce.com). Selezionare Continua.
Nella scheda Autorizza, inserire il Consumer key e il Consumer secret (vedere la tabella sopra) e selezionare Autentica.
Accedere a Salesforce nella finestra che si apre e fare clic su Allow. Salesforce indica che l'app è sconosciuta o non approvata? Una nuova app può richiedere alcuni minuti per essere pronta. Attendere qualche minuto e fare di nuovo clic su Autentica. Si sta rinnovando l'autenticazione di un connettore già funzionante? Lasciare vuoti Consumer key e Consumer secret e verranno utilizzati quelli salvati.
Nella scheda Oggetti, selezionare gli oggetti Salesforce che contengono conoscenze pertinenti, ad esempio casi, account o articoli Knowledge. Utilizzare la casella di ricerca per trovare un oggetto e selezionare Annulla selezione per ricominciare. Quindi selezionare Salva. Nulla viene copiato o indicizzato. Questa operazione definisce solo quali oggetti possono essere aggiunti alle raccolte di conoscenze.