Connessione a servizi e API di terze parti (generici)

Per connettersi a servizi di terze parti con Connettore API

1. Nel riquadro di navigazione a sinistra, scegli i connettori nella sezione Gestisci. Verrai indirizzato a una pagina che mostra un elenco di connettori esistenti con alcuni dettagli su ciascuno.

2. Scegli + Crea connettore.

3. Scegli API Connector. Ora configura il tuo connettore compilando i seguenti campi.

4. Nome del connettore: fornisci un nome per il connettore.

5. Descrizione del connettore: fornisci una descrizione del connettore.

6. URL di base: il sito Web o l'host della connessione di terze parti. Ad esempio, www.slack.com.

7. Metodo di autenticazione: scegli il metodo di autenticazione con il servizio di destinazione.

   • Nessuno: accedi al servizio di destinazione senza autenticazione.

   • Di base: accedi al servizio di destinazione utilizzando un nome utente e una password ottenuti dal servizio a cui ti stai connettendo.

   • Bearer Token: accedi al servizio di destinazione utilizzando il valore Token di un token di autenticazione ottenuto dall'account utente del servizio o dalle impostazioni API.

   • OAuth 2.0: accedi al servizio di destinazione utilizzando il protocollo OAuth 2.0, che garantisce ad App Studio l'accesso al servizio e alle risorse senza condividere credenziali o identità. Per utilizzare il metodo di autenticazione OAuth 2.0, è necessario innanzitutto creare un'applicazione dal servizio a cui ci si connette che rappresenti App Studio per ottenere le informazioni necessarie. Con queste informazioni, compila i seguenti campi:

     1. Flusso delle credenziali del cliente: ideale per le interazioni da sistema a sistema in cui l'applicazione agisce per conto proprio senza l'interazione dell'utente. Ad esempio, un'app CRM che aggiorna automaticamente i record di Salesforce in base ai nuovi record aggiunti dagli utenti o un'app che recupera e visualizza i dati delle transazioni nei report.

        1. In Client ID, inserisci l'ID ottenuto dall'app OAuth creata nel servizio di destinazione.

        2. In Client secret, inserisci il segreto ottenuto dall'app OAuth creata nel servizio di destinazione.

        3. In Access token URL, inserisci l'URL del token ottenuto dall'app OAuth creata nel servizio di destinazione.

        4. Facoltativamente, in Scopes, inserisci gli ambiti dell'applicazione. Gli ambiti sono le autorizzazioni o i livelli di accesso richiesti dall'applicazione. Fai riferimento alla documentazione delle API del servizio di destinazione per comprenderne gli ambiti e configurare solo quelli di cui ha bisogno la tua app App Studio.

        Scegli Verifica connessione per testare l'autenticazione e la connessione.

     2. Flusso del codice di autorizzazione: ideale per le applicazioni che richiedono l'intervento per conto di un utente. Ad esempio, un'app di assistenza clienti in cui gli utenti accedono e visualizzano e aggiornano i ticket di assistenza o un'app di vendita in cui ogni membro del team accede per visualizzare e gestire i propri dati di vendita.

        1. In Client ID, inserisci l'ID ottenuto dall'app OAuth creata nel servizio di destinazione.

        2. In Client secret, inserisci il segreto ottenuto dall'app OAuth creata nel servizio di destinazione.

        3. In URL di autorizzazione, inserisci l'URL di autorizzazione dal servizio di destinazione.

        4. In Access token URL, inserisci l'URL del token ottenuto dall'app OAuth creata nel servizio di destinazione.

        5. Facoltativamente, in Scopes, inserisci gli ambiti dell'applicazione. Gli ambiti sono le autorizzazioni o i livelli di accesso richiesti dall'applicazione. Fai riferimento alla documentazione delle API del servizio di destinazione per comprenderne gli ambiti e configurare solo quelli di cui ha bisogno la tua app App Studio.

8. Intestazioni: aggiungi le intestazioni HTTP utilizzate per fornire metadati sulla richiesta o sulla risposta. Puoi aggiungere sia chiavi che valori o fornire solo una chiave a cui il generatore può fornire un valore nell'applicazione.

9. Parametri di interrogazione: aggiungi i parametri di query utilizzati per passare opzioni, filtri o dati come parte dell'URL della richiesta. Come per le intestazioni, potete fornire sia una chiave che un valore oppure fornire solo una chiave a cui il generatore può fornire un valore nell'applicazione.

10. Scegli Crea. Il connettore appena creato verrà visualizzato nell'elenco dei connettori.