Loading
Automatizzazione dei processi aziendali con il flusso Salesforce
Configurazione di un'azione di chiamata HTTP (beta)

Ti trovi qui:

  1. Guida di Salesforce
  2. Documenti
  3. Automazione dei processi aziendali

Configurazione di un'azione di chiamata HTTP (beta)

La chiamata HTTP guida l'utente nell'immissione dei dettagli relativi al servizio basato sul Web HTTP o all'endpoint API REST a cui si sta connettendo. Una volta completata la configurazione, si invoca l'azione in un flusso. Chiamata HTTP presuppone che si abbia familiarità con l'API che si desidera chiamare.

Versioni (Edition) richieste

Disponibile in: Lightning Experience
Visualizzare le versioni supportate.
Autorizzazioni utente richieste
Per aprire, modificare, creare, attivare o disattivare un flusso utilizzando tutti i tipi di flusso, gli elementi e le funzioni disponibili in Flow Builder, inclusi Einstein e Agentforce per Flusso: Gestisci flusso
Per creare una credenziale esterna, una credenziale denominata e un'azione di chiamata HTTP: Personalizza applicazioni

Prima di configurare un'azione di chiamata HTTP:

  • Creare una credenziale esterna e una credenziale denominata in modo che il servizio esterno possa connettersi all'API. Vedere Linee guida per l'autenticazione delle azioni di chiamata HTTP.
  • Preparare una risposta API di esempio in formato JSON. Se nella documentazione dell'API non è presente un esempio, è possibile utilizzare una piattaforma API di terze parti per recuperare una risposta.
  • Iniziare con un'API ben documentata. Se dettagli come i requisiti o le definizioni dei campi sono imprecisi o non sono aggiornati, potrebbe essere necessario dedicare tempo al debug.
  1. Aprire la visualizzazione elenco Flussi.
    • Da Imposta, nella casella Ricerca veloce, immettere Flussi e quindi selezionare Flussi.
    • Dall'app Automation, selezionare la scheda Flussi.
    • Dalla scheda Flussi di qualsiasi app Lightning, fare clic sul menu delle azioni e selezionare Apri flusso.
  2. Aprire un flusso esistente in cui si desidera utilizzare la chiamata o crearne uno.
  3. Aggiungere un elemento Azione al flusso e fare clic su Crea chiamata HTTP.
  4. Configurare il servizio esterno che connette Salesforce all'API basata su HTTP.
    1. Immettere un nome per il servizio esterno, ad esempio ConnectToMaps. Il nome deve iniziare con una lettera e contenere solo caratteri alfanumerici senza spazi.
    2. Per riferimento, immettere una descrizione del collegamento al servizio esterno.
    3. Selezionare la credenziale denominata creata per questo servizio esterno.
      L'URL associato alla credenziale viene compilato automaticamente.
    4. Fare clic su Avanti.
  5. Configurare l'azione invocabile utilizzabile in Flow Builder o in Salesforce.
    1. Per Etichetta, immettere l'azione eseguita dalla chiamata, ad esempio Connetti a Maps.
    2. Selezionare l'operazione o il metodo richiesto dall'API che si sta chiamando.
      In generale, GET recupera dati esterni. Il resto dei metodi modifica i dati in un sistema esterno. La funzionalità dipende dall'API.
    3. Immettere una descrizione dell'API che esegue l'operazione e inserire un link al documento API in modo da potervi fare riferimento se si modifica la chiamata.
  6. Aggiungere l'endpoint URL per la richiesta.
    L'URL di base mostra l'URL della credenziale denominata per il servizio esterno. Se non è possibile visualizzare l'intero URL, fare clic sul campo.
    1. Immettere il percorso URL dell'endpoint che inizia con una barra (/) e non contiene un punto interrogativo (?).
      I caratteri supportati per un percorso URL includono caratteri alfanumerici, caratteri di sottolineatura, barra e parentesi graffe.
    2. Se sono presenti variabili di percorso, posizionarle tra parentesi graffe e selezionare il tipo di dati della variabile. Le di variabili percorso possono contenere solo caratteri alfanumerici e di sottolineatura.
    3. Immettere la descrizione della variabile, inclusi i dettagli di utilizzo.
  7. Aggiungere le chiavi dei parametri di query se presenti nell'API che si sta chiamando. Quando si utilizza questa azione in un flusso, si inseriscono valori per le chiavi definite.
    1. Fare clic su + Aggiungi chiave.
    2. Immettere il valore della chiave e selezionare il tipi di dati.
    3. Per richiedere un valore quando l'azione viene invocata in un flusso, selezionare Obbligatorio.
    4. Immettere la descrizione della chiave del parametro di query, inclusi i dettagli di utilizzo.
  8. Per POST, PUT, PATCH e DELETE, specificare un corpo della richiesta API di esempio. Salesforce genera una struttura di dati dalla richiesta di esempio.
    1. Fare clic su Nuovo.
    2. Incollare una richiesta JSON di esempio.
    3. Fare clic su Esamina e verificare che la struttura di dati Apex sia corretta.
    4. Per apportare modifiche, modificare il testo nella richiesta JSON di esempio o selezionare i tipi di dati dalla struttura di dati.
    5. Fare clic su Review (Rivedi).
    6. Fare clic su Chiudi.
  9. Fornire il corpo della risposta API di esempio. Salesforce genera una struttura di dati dalla risposta di esempio.
    1. Fare clic su Nuovo.
    2. Incollare una risposta JSON di esempio.
    3. Fare clic su Esamina e verificare che la struttura di dati Apex sia corretta.
    4. Per apportare modifiche, modificare il testo nella risposta JSON di esempio o selezionare i tipi di dati dalla struttura di dati.
    5. Fare clic su Review (Rivedi).
    6. Fare clic su Chiudi.
  10. Fare clic su Salva.
    Flow Builder crea l'azione e il servizio esterno. L'azione è disponibile nella finestra Azioni nel flusso.
  11. Per POST, PUT, PATCH e DELETE, impostare il corpo del flusso creando una risorsa e selezionando la classe Apex per il corpo del server esterno.
    1. Per il corpo, selezionare Nuova risorsa.
    2. Immettere un nome API per la nuova risorsa.
    3. Immettere una descrizione che descriva la variabile e come viene utilizzata.
      Il tipo di dati e la classe Apex vengono impostati automaticamente. La classe Apex per l'azione di chiamata HTTP utilizza questa convenzione di denominazione: ExternalServiceName__HTTP Callout Label_IN_body. Ad esempio, se il nome del servizio esterno è MyCustomES e l'etichetta della nuova chiamata HTTP è Get Accounts (Ottieni account), la classe Apex è MyCustomES_Getx20Accounts_IN_body, dove x20 rappresenta uno spazio nell'etichetta.
    4. Fare clic su Chiudi.
    5. Per il corpo, selezionare la variabile definita da Apex creata.
    6. Fare clic su Chiudi.

Per trasformare i dati tra Salesforce e il sistema esterno nel flusso, utilizzare l'elemento Trasforma. Per i metodi POST, PUT, PATCH e DELETE, aggiungere un elemento Assegnazione prima dell'azione di chiamata HTTP. Nell'elemento Assegnazione, assegnare valori a ciascuno dei campi della variabile definita da Apex. L'azione di chiamata HTTP fa riferimento alla variabile definita da Apex come input per creare i dati nel server esterno.

Flow Builder crea automaticamente classi Apex dalle strutture di dati dedotte per memorizzare i dati trasferiti tra Salesforce e il server esterno. La convenzione di denominazione delle classi Apex per le azioni di chiamata HTTP che utilizzano il metodo GET è ExternalServiceName__HTTP Callout Label_OUT_2XX. Ad esempio, se il nome del servizio esterno è MyCustomES e l'etichetta della nuova chiamata HTTP è Get Accounts (Ottieni account), la classe Apex è MyCustomES_Getx20Accounts_OUT_2XX. Per eliminare una classe Apex, eliminare il servizio esterno associato alla classe Apex. Per ulteriori informazioni, vedere Eliminazione di un servizio esterno.

Vedere anche:

 
Caricamento
Salesforce Help | Article