Come creare lead o casi in Salesforce con Flow Builder

Uccello

2 dic 2021

Flow Builder

1 min read

Come creare lead o casi in Salesforce con Flow Builder

Punti Chiave

    • Il Bird’s Flow Builder consente un'integrazione senza soluzione di continuità con Salesforce, abilitando la creazione automatica di lead e casi attraverso più canali di comunicazione.

    • L'integrazione supporta WhatsApp, Instagram, Telegram, WeChat, LINE, Messenger, Google Business Chat, Viber e altro ancora.

    • Con la connettività Salesforce, le aziende possono arricchire i record CRM, centralizzare le conversazioni di supporto e costruire logiche di funnel automatizzate end-to-end.

    • I casi d'uso principali includono:

      • Creare lead Salesforce direttamente dai canali di messaggistica

      • Creare casi Salesforce per i team di supporto

      • Smistare, contrassegnare e arricchire i dati dei clienti nei flussi

    • L'integrazione richiede:

      • Un account amministratore di Bird

      • Un'organizzazione Salesforce con accesso da amministratore

    • La configurazione inizia configurando un App Connessa Salesforce con OAuth abilitato, scope appropriati e impostazioni di autorizzazione rilassate.

    • Gli scope OAuth richiesti includono:

      • Accesso e gestione dei tuoi dati (api)

      • Accesso web (web)

      • Tokens di aggiornamento (offline_access)

    • Dopo aver creato l'App Connessa, gli utenti devono recuperare la loro Chiave del Consumatore e Segreto del Consumatore per le credenziali di Flow Builder.

    • I token OAuth vengono generati tramite Salesforce utilizzando un passaggio di autorizzazione del browser, seguito dal recupero dei token di accesso e aggiornamento tramite cURL o Postman.

    • Il token di aggiornamento garantisce un'autenticazione continua anche quando i token di accesso scadono.

    • Un errore di integrazione comune — “REST API non è abilitato per questa Organizzazione” — può essere risolto abilitando l'accesso API sotto le autorizzazioni amministrative del profilo utente.

    • Una volta configurate le credenziali Salesforce, gli utenti possono importare un modello di Flow Builder per creare lead o casi tramite WhatsApp, Viber, SMS e altri canali.

    • Gli endpoint API consentono a Flow Builder di inviare dati negli oggetti Salesforce come Lead o Case utilizzando le mappature dei campi definite nel Gestore Oggetti di Salesforce.

    • Gli utenti possono personalizzare i flussi per attivare azioni Salesforce basate sul comportamento del canale, sulle risposte dei clienti, sui tag o sulle fasi del funnel.

    • Il flusso restituisce gli ID record di Salesforce (ad es., ID Caso) per il follow-up, la reportistica o lo smistamento.

    • Dopo la configurazione, le aziende possono generare automaticamente voci Salesforce in tempo reale da qualsiasi canale supportato da Bird.

Punti salienti del Q&A

  • Cosa ti consente di fare l'integrazione di Salesforce con Flow Builder?

    Consente la creazione automatica di lead e casi in Salesforce da qualsiasi canale di comunicazione supportato connesso a Bird.

  • Quali canali possono inviare dati a Salesforce?

    WhatsApp, Instagram, Telegram, WeChat, LINE, Messenger, Google Business Chat, Viber, SMS e altro ancora.

  • Quali sono i principali casi d'uso?

    Creare lead di Salesforce, creare casi di supporto, arricchire profili e costruire funnel di vendita automatizzati collegati al CRM.

  • Quali permessi di Salesforce sono necessari?

    Accesso da amministratore, insieme a un'app connessa configurata con OAuth, accesso API e restrizioni IP/token allentate.

  • Quali ambiti OAuth devono essere aggiunti?

    Accesso API, accesso web e refresh_token/accesso_offline.

  • quali credenziali sono necessarie a Bird per autenticarsi con Salesforce?

    La Chiave del Consumatore e il Segreto del Consumatore dell'App Connessa, oltre a un token di accesso e a un token di aggiornamento.

  • Perché è necessario un token di aggiornamento?

    Poiché i token di accesso di Salesforce scadono, il token di aggiornamento viene utilizzato per ottenere automaticamente nuovi token.

  • Cosa causa l'errore "L'API REST non è abilitata per questa organizzazione"?

    L'accesso all'API è disabilitato nel profilo Salesforce dell'utente. Abilitare API Abilitato risolve il problema.

  • Come sono mappati gli oggetti Salesforce come Lead o Case in Flow Builder?

    Fornendo i nomi dei campi dal Manager degli Oggetti di Salesforce (ad es., Cognome, Telefono, Azienda).

  • Puoi usare WhatsApp per creare contatti in Salesforce?

    Sì — WhatsApp può inserire dati strutturati nei campi Lead di Salesforce attraverso il Flow Builder.

  • È possibile utilizzare Viber per creare casi in Salesforce?

    Sì — I messaggi di Viber possono attivare la creazione di casi con dettagli inviati tramite le API di Salesforce.

  • Il flusso restituisce gli ID di Salesforce?

    Sì — Salesforce risponde con ID oggetti (ad es., ID Caso), che possono essere memorizzati o utilizzati in ulteriori automazioni.

Bird offre molte integrazioni dirette che ti permettono di collegare le tue comunicazioni agli strumenti e alle piattaforme già utilizzate nella tua azienda.

Utilizzando le integrazioni native di Flow Builder, connessioni personalizzate tramite richieste HTTP e webhook, puoi facilmente arricchire i profili cliente, abilitare un rapido coinvolgimento nelle vendite e generare lead più qualificati.

Oggi discuteremo della nostra integrazione con Salesforce. 

Cosa consente questa integrazione

Con questa integrazione puoi:

  • Aggiungere lead in Salesforce da diversi canali di comunicazione: WhatsApp, Instagram, Telegram, WeChat, LINE, Messenger, Google Business Chat, Viber, ecc. Quando utilizzi WhatsApp per la generazione di lead, implementare i fallback SMS assicura che nessun potenziale lead venga perso a causa di fallimenti nella consegna.

  • Creare casi in Salesforce per mantenere registrazioni e memorizzare dati chiave all'interno dei casi provenienti da tutti i tuoi canali

  • Implementare flessibilità e automazione della creazione di lead/casi in qualsiasi punto del tuo funnel di vendita

Capacità di integrazione di Salesforce a colpo d'occhio

Capacità

Descrizione

Creazione di lead

Creare lead Salesforce da canali di messaggistica

Creazione di casi

Creare casi Salesforce per flussi di lavoro di supporto

Supporto ai canali

WhatsApp, Viber, SMS, Instagram, Telegram, LINE, Messenger

Controllo dell'automazione

Attivare la creazione di lead o casi in qualsiasi passo del flusso

Arricchimento dei dati

Memorizzare dati strutturati dei canali nei record di Salesforce

Cosa costruirai in questa guida

In questa guida, imparerai come:

  1. Configurare correttamente il tuo Salesforce

  2. Collegare Salesforce con Bird

  3. Risoluzione dei problemi quando si connette Salesforce

  4. Creare un flusso in Flow Builder che invierà dati a Salesforce

  5. Collegare WhatsApp con Salesforce per inviare i tuoi lead

  6. Collegare Viber con Salesforce per inviare i tuoi casi

Requisiti

Prima di iniziare a costruire la logica in Flow Builder, devi avere i seguenti requisiti pronti:

  • Un account Bird: Assicurati di avere accesso come amministratore.

  • Un account Salesforce: Hai bisogno di "Accesso da amministratore"

Elenco di controllo dei prerequisiti

Requisito

Livello di accesso

Note

Account Bird

Amministratore

Richiesto per creare e pubblicare flussi

Account Salesforce

Amministratore

Necessario per l'accesso a Connected App e API

Bird offre molte integrazioni dirette che ti permettono di collegare le tue comunicazioni agli strumenti e alle piattaforme già utilizzate nella tua azienda.

Utilizzando le integrazioni native di Flow Builder, connessioni personalizzate tramite richieste HTTP e webhook, puoi facilmente arricchire i profili cliente, abilitare un rapido coinvolgimento nelle vendite e generare lead più qualificati.

Oggi discuteremo della nostra integrazione con Salesforce. 

Cosa consente questa integrazione

Con questa integrazione puoi:

  • Aggiungere lead in Salesforce da diversi canali di comunicazione: WhatsApp, Instagram, Telegram, WeChat, LINE, Messenger, Google Business Chat, Viber, ecc. Quando utilizzi WhatsApp per la generazione di lead, implementare i fallback SMS assicura che nessun potenziale lead venga perso a causa di fallimenti nella consegna.

  • Creare casi in Salesforce per mantenere registrazioni e memorizzare dati chiave all'interno dei casi provenienti da tutti i tuoi canali

  • Implementare flessibilità e automazione della creazione di lead/casi in qualsiasi punto del tuo funnel di vendita

Capacità di integrazione di Salesforce a colpo d'occhio

Capacità

Descrizione

Creazione di lead

Creare lead Salesforce da canali di messaggistica

Creazione di casi

Creare casi Salesforce per flussi di lavoro di supporto

Supporto ai canali

WhatsApp, Viber, SMS, Instagram, Telegram, LINE, Messenger

Controllo dell'automazione

Attivare la creazione di lead o casi in qualsiasi passo del flusso

Arricchimento dei dati

Memorizzare dati strutturati dei canali nei record di Salesforce

Cosa costruirai in questa guida

In questa guida, imparerai come:

  1. Configurare correttamente il tuo Salesforce

  2. Collegare Salesforce con Bird

  3. Risoluzione dei problemi quando si connette Salesforce

  4. Creare un flusso in Flow Builder che invierà dati a Salesforce

  5. Collegare WhatsApp con Salesforce per inviare i tuoi lead

  6. Collegare Viber con Salesforce per inviare i tuoi casi

Requisiti

Prima di iniziare a costruire la logica in Flow Builder, devi avere i seguenti requisiti pronti:

  • Un account Bird: Assicurati di avere accesso come amministratore.

  • Un account Salesforce: Hai bisogno di "Accesso da amministratore"

Elenco di controllo dei prerequisiti

Requisito

Livello di accesso

Note

Account Bird

Amministratore

Richiesto per creare e pubblicare flussi

Account Salesforce

Amministratore

Necessario per l'accesso a Connected App e API

Bird offre molte integrazioni dirette che ti permettono di collegare le tue comunicazioni agli strumenti e alle piattaforme già utilizzate nella tua azienda.

Utilizzando le integrazioni native di Flow Builder, connessioni personalizzate tramite richieste HTTP e webhook, puoi facilmente arricchire i profili cliente, abilitare un rapido coinvolgimento nelle vendite e generare lead più qualificati.

Oggi discuteremo della nostra integrazione con Salesforce. 

Cosa consente questa integrazione

Con questa integrazione puoi:

  • Aggiungere lead in Salesforce da diversi canali di comunicazione: WhatsApp, Instagram, Telegram, WeChat, LINE, Messenger, Google Business Chat, Viber, ecc. Quando utilizzi WhatsApp per la generazione di lead, implementare i fallback SMS assicura che nessun potenziale lead venga perso a causa di fallimenti nella consegna.

  • Creare casi in Salesforce per mantenere registrazioni e memorizzare dati chiave all'interno dei casi provenienti da tutti i tuoi canali

  • Implementare flessibilità e automazione della creazione di lead/casi in qualsiasi punto del tuo funnel di vendita

Capacità di integrazione di Salesforce a colpo d'occhio

Capacità

Descrizione

Creazione di lead

Creare lead Salesforce da canali di messaggistica

Creazione di casi

Creare casi Salesforce per flussi di lavoro di supporto

Supporto ai canali

WhatsApp, Viber, SMS, Instagram, Telegram, LINE, Messenger

Controllo dell'automazione

Attivare la creazione di lead o casi in qualsiasi passo del flusso

Arricchimento dei dati

Memorizzare dati strutturati dei canali nei record di Salesforce

Cosa costruirai in questa guida

In questa guida, imparerai come:

  1. Configurare correttamente il tuo Salesforce

  2. Collegare Salesforce con Bird

  3. Risoluzione dei problemi quando si connette Salesforce

  4. Creare un flusso in Flow Builder che invierà dati a Salesforce

  5. Collegare WhatsApp con Salesforce per inviare i tuoi lead

  6. Collegare Viber con Salesforce per inviare i tuoi casi

Requisiti

Prima di iniziare a costruire la logica in Flow Builder, devi avere i seguenti requisiti pronti:

  • Un account Bird: Assicurati di avere accesso come amministratore.

  • Un account Salesforce: Hai bisogno di "Accesso da amministratore"

Elenco di controllo dei prerequisiti

Requisito

Livello di accesso

Note

Account Bird

Amministratore

Richiesto per creare e pubblicare flussi

Account Salesforce

Amministratore

Necessario per l'accesso a Connected App e API

Passo 1: Configura un'app connessa di Salesforce

Per accedere alla sezione App collegate in Salesforce (Lighting Experience), segui questi passaggi:

  1. Accedi a Salesforce come amministratore

  2. Seleziona Setup dal menu a discesa dell'account (nell'angolo in alto a destra)

  3. Nel pannello a sinistra, vai su Gestore App > Nuova App collegata

Si prega di notare: se si verifica il problema di visualizzazione sottostante, si prega di fare clic su “Fai clic qui per aprire questa pagina in Salesforce Classic.”

App Manager setup

Crea un'App collegata

Nella pagina Nuova App collegata, compila i seguenti campi obbligatori sotto Informazioni di base:

  • Nome App collegata, ad es. Integrazione Bird.

  • Nome API, ad es. Bird_Integration

  • Email di contatto, ad es. xxx@contactemail.com

Configura le impostazioni OAuth

  1. Vai a API (Abilita impostazioni OAuth), e seleziona Abilita impostazioni OAuth.

    • Nella casella URL di Callback, inserisci https://login.salesforce.com/

    • Nella casella Scope OAuth selezionati, seleziona Accedi e gestisci i tuoi dati (api)

    • Fornisci accesso ai tuoi dati via Web (web)

    • Esegui richieste per tuo conto in qualsiasi momento (refresh_token, offline_access)

    • Fai clic su Aggiungi

Spiegazione degli scope OAuth

Scope OAuth

Perché è richiesto

api

Consente a Bird di leggere e scrivere oggetti Salesforce

web

Abilita l'autorizzazione OAuth basata su browser

offline_access

Consente i token di aggiornamento per accesso prolungato


  1. Fai clic sul pulsante Salva per salvare la nuova App collegata.


New Connected App page


  1. Nella lista delle App collegate (Apps > Gestore App), trova l'App che hai appena creato, e poi fai clic su Gestisci.

Aggiorna le politiche OAuth

  1. Nella pagina che si apre, fai clic sul pulsante Modifica

    • Sotto Politiche OAuth, seleziona Tutti gli utenti possono autorizzarsi autonomamente nella lista Utenti autorizzati

    • Nella Rilassamento IP, seleziona Rilassa restrizioni IP 

    • Nella Politica del Token di Aggiornamento, fai clic su Il token di aggiornamento è valido fino alla revoca. Sotto Politiche di sessione, seleziona il valore Timeout (24 ore), fai clic sul pulsante Salva

New Connected App page


  1. Torna alla lista delle App collegate (Apps > Gestore App), e fai clic sull'App che hai appena creato, e poi fai clic su Visualizza.

Recupera la Chiave e Secret del Consumatore

  1. Vai a API (Abilita impostazioni OAuth) e annota la Chiave del Consumatore e il Secret del Consumatore. Hai bisogno di questa chiave e secret per la configurazione delle credenziali nell'integrazione di Salesforce di MessageBird.

Per accedere alla sezione App collegate in Salesforce (Lighting Experience), segui questi passaggi:

  1. Accedi a Salesforce come amministratore

  2. Seleziona Setup dal menu a discesa dell'account (nell'angolo in alto a destra)

  3. Nel pannello a sinistra, vai su Gestore App > Nuova App collegata

Si prega di notare: se si verifica il problema di visualizzazione sottostante, si prega di fare clic su “Fai clic qui per aprire questa pagina in Salesforce Classic.”

App Manager setup

Crea un'App collegata

Nella pagina Nuova App collegata, compila i seguenti campi obbligatori sotto Informazioni di base:

  • Nome App collegata, ad es. Integrazione Bird.

  • Nome API, ad es. Bird_Integration

  • Email di contatto, ad es. xxx@contactemail.com

Configura le impostazioni OAuth

  1. Vai a API (Abilita impostazioni OAuth), e seleziona Abilita impostazioni OAuth.

    • Nella casella URL di Callback, inserisci https://login.salesforce.com/

    • Nella casella Scope OAuth selezionati, seleziona Accedi e gestisci i tuoi dati (api)

    • Fornisci accesso ai tuoi dati via Web (web)

    • Esegui richieste per tuo conto in qualsiasi momento (refresh_token, offline_access)

    • Fai clic su Aggiungi

Spiegazione degli scope OAuth

Scope OAuth

Perché è richiesto

api

Consente a Bird di leggere e scrivere oggetti Salesforce

web

Abilita l'autorizzazione OAuth basata su browser

offline_access

Consente i token di aggiornamento per accesso prolungato


  1. Fai clic sul pulsante Salva per salvare la nuova App collegata.


New Connected App page


  1. Nella lista delle App collegate (Apps > Gestore App), trova l'App che hai appena creato, e poi fai clic su Gestisci.

Aggiorna le politiche OAuth

  1. Nella pagina che si apre, fai clic sul pulsante Modifica

    • Sotto Politiche OAuth, seleziona Tutti gli utenti possono autorizzarsi autonomamente nella lista Utenti autorizzati

    • Nella Rilassamento IP, seleziona Rilassa restrizioni IP 

    • Nella Politica del Token di Aggiornamento, fai clic su Il token di aggiornamento è valido fino alla revoca. Sotto Politiche di sessione, seleziona il valore Timeout (24 ore), fai clic sul pulsante Salva

New Connected App page


  1. Torna alla lista delle App collegate (Apps > Gestore App), e fai clic sull'App che hai appena creato, e poi fai clic su Visualizza.

Recupera la Chiave e Secret del Consumatore

  1. Vai a API (Abilita impostazioni OAuth) e annota la Chiave del Consumatore e il Secret del Consumatore. Hai bisogno di questa chiave e secret per la configurazione delle credenziali nell'integrazione di Salesforce di MessageBird.

Per accedere alla sezione App collegate in Salesforce (Lighting Experience), segui questi passaggi:

  1. Accedi a Salesforce come amministratore

  2. Seleziona Setup dal menu a discesa dell'account (nell'angolo in alto a destra)

  3. Nel pannello a sinistra, vai su Gestore App > Nuova App collegata

Si prega di notare: se si verifica il problema di visualizzazione sottostante, si prega di fare clic su “Fai clic qui per aprire questa pagina in Salesforce Classic.”

App Manager setup

Crea un'App collegata

Nella pagina Nuova App collegata, compila i seguenti campi obbligatori sotto Informazioni di base:

  • Nome App collegata, ad es. Integrazione Bird.

  • Nome API, ad es. Bird_Integration

  • Email di contatto, ad es. xxx@contactemail.com

Configura le impostazioni OAuth

  1. Vai a API (Abilita impostazioni OAuth), e seleziona Abilita impostazioni OAuth.

    • Nella casella URL di Callback, inserisci https://login.salesforce.com/

    • Nella casella Scope OAuth selezionati, seleziona Accedi e gestisci i tuoi dati (api)

    • Fornisci accesso ai tuoi dati via Web (web)

    • Esegui richieste per tuo conto in qualsiasi momento (refresh_token, offline_access)

    • Fai clic su Aggiungi

Spiegazione degli scope OAuth

Scope OAuth

Perché è richiesto

api

Consente a Bird di leggere e scrivere oggetti Salesforce

web

Abilita l'autorizzazione OAuth basata su browser

offline_access

Consente i token di aggiornamento per accesso prolungato


  1. Fai clic sul pulsante Salva per salvare la nuova App collegata.


New Connected App page


  1. Nella lista delle App collegate (Apps > Gestore App), trova l'App che hai appena creato, e poi fai clic su Gestisci.

Aggiorna le politiche OAuth

  1. Nella pagina che si apre, fai clic sul pulsante Modifica

    • Sotto Politiche OAuth, seleziona Tutti gli utenti possono autorizzarsi autonomamente nella lista Utenti autorizzati

    • Nella Rilassamento IP, seleziona Rilassa restrizioni IP 

    • Nella Politica del Token di Aggiornamento, fai clic su Il token di aggiornamento è valido fino alla revoca. Sotto Politiche di sessione, seleziona il valore Timeout (24 ore), fai clic sul pulsante Salva

New Connected App page


  1. Torna alla lista delle App collegate (Apps > Gestore App), e fai clic sull'App che hai appena creato, e poi fai clic su Visualizza.

Recupera la Chiave e Secret del Consumatore

  1. Vai a API (Abilita impostazioni OAuth) e annota la Chiave del Consumatore e il Secret del Consumatore. Hai bisogno di questa chiave e secret per la configurazione delle credenziali nell'integrazione di Salesforce di MessageBird.

Passo 2: Ottenere token da Salesforce per autorizzare l'accesso

Come funzionano i token OAuth di Salesforce

In Salesforce, i token di accesso hanno una vita limitata specificata dal timeout della sessione. Se un'applicazione utilizza un token di accesso scaduto, verrà visualizzato un errore “Sessione scaduta o non valida”. 

Utilizza un token di aggiornamento durante il processo di autorizzazione per ottenere un nuovo token di accesso. Utilizzare un nuovo token garantirà che il token di accesso sia sempre attivo.

Artifact OAuth di Salesforce

Artifact

Scopo

Durata

Chiave del consumatore

Identifica la tua app connessa

Statico

Segreto del consumatore

Autentica l'app connessa

Statico

Token di accesso

Autorizza le richieste API di Salesforce

Breve durata

Token di aggiornamento

Rinnova i token di accesso

Lunga durata

URL dell'istanza

URL di base dell'API di Salesforce

Statico

Ottieni l'URL della tua istanza

  1. Invia la seguente richiesta curl per ottenere l'URL dell'istanza. 

  • client_id = Chiave del consumatore

  • client_secret = Segreto del consumatore

  • username = nome utente di accesso Salesforce

  • password = password di accesso Salesforce

Terminal window showing a curl command to request an OAuth2 token


Se non sei pratico con curl, puoi utilizzare Postman per inviare la richiesta. Segui questi passaggi:

Postman dashboard

Autorizza l'app e recupera il codice

  1. Ottieni il tuo codice. Usa il tuo browser preferito, quindi inserisci il seguente URL di richiesta in una nuova scheda per ottenere il codice. 

  • <CONSUMER_KEY> deve essere sostituito con la Chiave del consumatore ottenuta nel passaggio precedente

  • <YOUR_INSTANCE> deve essere sostituito con il nome della tua istanza


Terminal window displaying a Salesforce OAuth 2.0 authorization URL template


Request URL in the browser

Quindi, inserisci l'URL della tua richiesta nel browser. Consenti l'accesso se compaiono avvisi. Vedrai quindi il browser reindirizzato a un URL simile a quello qui sotto. Puoi ottenere il codice utilizzando lo stesso URL.

  • https://login.salesforce.com/?code=XXXX

Scambia il codice per i token di accesso e aggiornamento

  1. Ottieni il token di accesso & il token di aggiornamento: invia la seguente richiesta curl per ottenere i token. 

  • <CODE> deve essere sostituito con il codice ottenuto nel passaggio precedente. 

  • <CONSUMER_KEY>

  • <CONSUMER_SECRET> deve essere sostituito con i segreti ottenuti dalla Connected App creata

Terminal screenshot showing a curl command to request an OAuth 2.0 access token


Puoi ottenere l'access_token e il refresh_token dalla risposta.

Screenshot of a JSON response from a Salesforce OAuth token request


Alternativa: utilizzo di Postman

Se non sei pratico con curl, puoi utilizzare Postman per inviare la richiesta. Segui questi passaggi:

Screenshot of a successful Salesforce OAuth 2.0 token request made using Postman

Come funzionano i token OAuth di Salesforce

In Salesforce, i token di accesso hanno una vita limitata specificata dal timeout della sessione. Se un'applicazione utilizza un token di accesso scaduto, verrà visualizzato un errore “Sessione scaduta o non valida”. 

Utilizza un token di aggiornamento durante il processo di autorizzazione per ottenere un nuovo token di accesso. Utilizzare un nuovo token garantirà che il token di accesso sia sempre attivo.

Artifact OAuth di Salesforce

Artifact

Scopo

Durata

Chiave del consumatore

Identifica la tua app connessa

Statico

Segreto del consumatore

Autentica l'app connessa

Statico

Token di accesso

Autorizza le richieste API di Salesforce

Breve durata

Token di aggiornamento

Rinnova i token di accesso

Lunga durata

URL dell'istanza

URL di base dell'API di Salesforce

Statico

Ottieni l'URL della tua istanza

  1. Invia la seguente richiesta curl per ottenere l'URL dell'istanza. 

  • client_id = Chiave del consumatore

  • client_secret = Segreto del consumatore

  • username = nome utente di accesso Salesforce

  • password = password di accesso Salesforce

Terminal window showing a curl command to request an OAuth2 token


Se non sei pratico con curl, puoi utilizzare Postman per inviare la richiesta. Segui questi passaggi:

Postman dashboard

Autorizza l'app e recupera il codice

  1. Ottieni il tuo codice. Usa il tuo browser preferito, quindi inserisci il seguente URL di richiesta in una nuova scheda per ottenere il codice. 

  • <CONSUMER_KEY> deve essere sostituito con la Chiave del consumatore ottenuta nel passaggio precedente

  • <YOUR_INSTANCE> deve essere sostituito con il nome della tua istanza


Terminal window displaying a Salesforce OAuth 2.0 authorization URL template


Request URL in the browser

Quindi, inserisci l'URL della tua richiesta nel browser. Consenti l'accesso se compaiono avvisi. Vedrai quindi il browser reindirizzato a un URL simile a quello qui sotto. Puoi ottenere il codice utilizzando lo stesso URL.

  • https://login.salesforce.com/?code=XXXX

Scambia il codice per i token di accesso e aggiornamento

  1. Ottieni il token di accesso & il token di aggiornamento: invia la seguente richiesta curl per ottenere i token. 

  • <CODE> deve essere sostituito con il codice ottenuto nel passaggio precedente. 

  • <CONSUMER_KEY>

  • <CONSUMER_SECRET> deve essere sostituito con i segreti ottenuti dalla Connected App creata

Terminal screenshot showing a curl command to request an OAuth 2.0 access token


Puoi ottenere l'access_token e il refresh_token dalla risposta.

Screenshot of a JSON response from a Salesforce OAuth token request


Alternativa: utilizzo di Postman

Se non sei pratico con curl, puoi utilizzare Postman per inviare la richiesta. Segui questi passaggi:

Screenshot of a successful Salesforce OAuth 2.0 token request made using Postman

Come funzionano i token OAuth di Salesforce

In Salesforce, i token di accesso hanno una vita limitata specificata dal timeout della sessione. Se un'applicazione utilizza un token di accesso scaduto, verrà visualizzato un errore “Sessione scaduta o non valida”. 

Utilizza un token di aggiornamento durante il processo di autorizzazione per ottenere un nuovo token di accesso. Utilizzare un nuovo token garantirà che il token di accesso sia sempre attivo.

Artifact OAuth di Salesforce

Artifact

Scopo

Durata

Chiave del consumatore

Identifica la tua app connessa

Statico

Segreto del consumatore

Autentica l'app connessa

Statico

Token di accesso

Autorizza le richieste API di Salesforce

Breve durata

Token di aggiornamento

Rinnova i token di accesso

Lunga durata

URL dell'istanza

URL di base dell'API di Salesforce

Statico

Ottieni l'URL della tua istanza

  1. Invia la seguente richiesta curl per ottenere l'URL dell'istanza. 

  • client_id = Chiave del consumatore

  • client_secret = Segreto del consumatore

  • username = nome utente di accesso Salesforce

  • password = password di accesso Salesforce

Terminal window showing a curl command to request an OAuth2 token


Se non sei pratico con curl, puoi utilizzare Postman per inviare la richiesta. Segui questi passaggi:

Postman dashboard

Autorizza l'app e recupera il codice

  1. Ottieni il tuo codice. Usa il tuo browser preferito, quindi inserisci il seguente URL di richiesta in una nuova scheda per ottenere il codice. 

  • <CONSUMER_KEY> deve essere sostituito con la Chiave del consumatore ottenuta nel passaggio precedente

  • <YOUR_INSTANCE> deve essere sostituito con il nome della tua istanza


Terminal window displaying a Salesforce OAuth 2.0 authorization URL template


Request URL in the browser

Quindi, inserisci l'URL della tua richiesta nel browser. Consenti l'accesso se compaiono avvisi. Vedrai quindi il browser reindirizzato a un URL simile a quello qui sotto. Puoi ottenere il codice utilizzando lo stesso URL.

  • https://login.salesforce.com/?code=XXXX

Scambia il codice per i token di accesso e aggiornamento

  1. Ottieni il token di accesso & il token di aggiornamento: invia la seguente richiesta curl per ottenere i token. 

  • <CODE> deve essere sostituito con il codice ottenuto nel passaggio precedente. 

  • <CONSUMER_KEY>

  • <CONSUMER_SECRET> deve essere sostituito con i segreti ottenuti dalla Connected App creata

Terminal screenshot showing a curl command to request an OAuth 2.0 access token


Puoi ottenere l'access_token e il refresh_token dalla risposta.

Screenshot of a JSON response from a Salesforce OAuth token request


Alternativa: utilizzo di Postman

Se non sei pratico con curl, puoi utilizzare Postman per inviare la richiesta. Segui questi passaggi:

Screenshot of a successful Salesforce OAuth 2.0 token request made using Postman

Risoluzione dei problemi della tua connessione Salesforce

Il errore più comune riscontrato durante l'integrazione di Salesforce con Bird e come risolverlo:

“L'API REST non è abilitata per questa organizzazione”

Quando stai cercando di inviare una richiesta all'API di Salesforce utilizzando le credenziali sopra indicate, a volte riceverai questo errore.

  • L'API REST non è abilitata per questa organizzazione.

Puoi risolvere questo errore seguendo i seguenti passaggi.

Fai clic su Impostazioni nell'angolo in alto a destra.

Setup menu highlighted


Vai su AMMINISTRAZIONE > Gestisci Utenti e fai clic su Profili.

Profiles view


Fai clic su Modifica sul profilo specifico che desideri aggiornare.

Scorri verso il basso e vai su Permessi Amministrativi e seleziona la casella API Abilitata.

Administrative permissions view

Non dimenticare di scorrere verso il basso e fare clic su Salva.

Il errore più comune riscontrato durante l'integrazione di Salesforce con Bird e come risolverlo:

“L'API REST non è abilitata per questa organizzazione”

Quando stai cercando di inviare una richiesta all'API di Salesforce utilizzando le credenziali sopra indicate, a volte riceverai questo errore.

  • L'API REST non è abilitata per questa organizzazione.

Puoi risolvere questo errore seguendo i seguenti passaggi.

Fai clic su Impostazioni nell'angolo in alto a destra.

Setup menu highlighted


Vai su AMMINISTRAZIONE > Gestisci Utenti e fai clic su Profili.

Profiles view


Fai clic su Modifica sul profilo specifico che desideri aggiornare.

Scorri verso il basso e vai su Permessi Amministrativi e seleziona la casella API Abilitata.

Administrative permissions view

Non dimenticare di scorrere verso il basso e fare clic su Salva.

Il errore più comune riscontrato durante l'integrazione di Salesforce con Bird e come risolverlo:

“L'API REST non è abilitata per questa organizzazione”

Quando stai cercando di inviare una richiesta all'API di Salesforce utilizzando le credenziali sopra indicate, a volte riceverai questo errore.

  • L'API REST non è abilitata per questa organizzazione.

Puoi risolvere questo errore seguendo i seguenti passaggi.

Fai clic su Impostazioni nell'angolo in alto a destra.

Setup menu highlighted


Vai su AMMINISTRAZIONE > Gestisci Utenti e fai clic su Profili.

Profiles view


Fai clic su Modifica sul profilo specifico che desideri aggiornare.

Scorri verso il basso e vai su Permessi Amministrativi e seleziona la casella API Abilitata.

Administrative permissions view

Non dimenticare di scorrere verso il basso e fare clic su Salva.

Passo 3: Crea un nuovo flusso in Flow Builder per creare lead o casi

Importa e pubblica il modello di flusso Salesforce

La configurazione di Salesforce è completata. Ora, iniziamo un nuovo flusso. Questo modello ti aiuterà a collegare il tuo canale di comunicazione preferito con Salesforce e a inviare nuovi lead o casi per il tuo team da seguire:

  1. Accedi al tuo Bird Dashboard e vai a Flow Builder

  2. Scarica il flusso di esempio che utilizzerai.

  3. Importa il flusso con la funzione di importazione. 


Import flow screen

Collega i canali che desideri utilizzare per creare lead/casi in Salesforce. Poi, puoi pubblicare questo flusso. 

Importa e pubblica il modello di flusso Salesforce

La configurazione di Salesforce è completata. Ora, iniziamo un nuovo flusso. Questo modello ti aiuterà a collegare il tuo canale di comunicazione preferito con Salesforce e a inviare nuovi lead o casi per il tuo team da seguire:

  1. Accedi al tuo Bird Dashboard e vai a Flow Builder

  2. Scarica il flusso di esempio che utilizzerai.

  3. Importa il flusso con la funzione di importazione. 


Import flow screen

Collega i canali che desideri utilizzare per creare lead/casi in Salesforce. Poi, puoi pubblicare questo flusso. 

Importa e pubblica il modello di flusso Salesforce

La configurazione di Salesforce è completata. Ora, iniziamo un nuovo flusso. Questo modello ti aiuterà a collegare il tuo canale di comunicazione preferito con Salesforce e a inviare nuovi lead o casi per il tuo team da seguire:

  1. Accedi al tuo Bird Dashboard e vai a Flow Builder

  2. Scarica il flusso di esempio che utilizzerai.

  3. Importa il flusso con la funzione di importazione. 


Import flow screen

Collega i canali che desideri utilizzare per creare lead/casi in Salesforce. Poi, puoi pubblicare questo flusso. 

Usa Salesforce con WhatsApp e Viber

Questo flusso di template ti permetterà di connettere i tuoi canali preferiti (WhatsApp, Viber, SMS, ecc.) con Salesforce. I seguenti esempi mostreranno come collegare Salesforce per creare lead su:

Mappatura dei canali agli oggetti Salesforce

Canale

Oggetto Salesforce

Caso d’uso principale

WhatsApp

Lead

Coinvolgimento di vendita e lead inbound

Viber

Caso

Supporto clienti e tracciamento dei problemi

SMS

Lead o Caso

Canale di fallback o di entrata

Altri canali

Configurabile

Dipende dalla logica del flusso

Tieni presente che puoi cambiare il canale o il caso d'uso a seconda delle tue necessità.

Import a flow view


Dovresti essere in grado di vedere il tuo flusso sullo schermo.

Flow illustration


Prepara l'autenticazione per i flussi di canale

Recupera il tuo token di accesso prima di attivare il tuo flusso. 

Il punto finale dell'API è il seguente:

  • client_id = Chiave consumatore

  • client_secret = Segreto consumatore, 

  • Per il refresh_token, fare riferimento al passo 2.3.

Screenshot of a URL used to request a new Salesforce access token using a refresh token


Flow illustration

Questo flusso di template ti permetterà di connettere i tuoi canali preferiti (WhatsApp, Viber, SMS, ecc.) con Salesforce. I seguenti esempi mostreranno come collegare Salesforce per creare lead su:

Mappatura dei canali agli oggetti Salesforce

Canale

Oggetto Salesforce

Caso d’uso principale

WhatsApp

Lead

Coinvolgimento di vendita e lead inbound

Viber

Caso

Supporto clienti e tracciamento dei problemi

SMS

Lead o Caso

Canale di fallback o di entrata

Altri canali

Configurabile

Dipende dalla logica del flusso

Tieni presente che puoi cambiare il canale o il caso d'uso a seconda delle tue necessità.

Import a flow view


Dovresti essere in grado di vedere il tuo flusso sullo schermo.

Flow illustration


Prepara l'autenticazione per i flussi di canale

Recupera il tuo token di accesso prima di attivare il tuo flusso. 

Il punto finale dell'API è il seguente:

  • client_id = Chiave consumatore

  • client_secret = Segreto consumatore, 

  • Per il refresh_token, fare riferimento al passo 2.3.

Screenshot of a URL used to request a new Salesforce access token using a refresh token


Flow illustration

Questo flusso di template ti permetterà di connettere i tuoi canali preferiti (WhatsApp, Viber, SMS, ecc.) con Salesforce. I seguenti esempi mostreranno come collegare Salesforce per creare lead su:

Mappatura dei canali agli oggetti Salesforce

Canale

Oggetto Salesforce

Caso d’uso principale

WhatsApp

Lead

Coinvolgimento di vendita e lead inbound

Viber

Caso

Supporto clienti e tracciamento dei problemi

SMS

Lead o Caso

Canale di fallback o di entrata

Altri canali

Configurabile

Dipende dalla logica del flusso

Tieni presente che puoi cambiare il canale o il caso d'uso a seconda delle tue necessità.

Import a flow view


Dovresti essere in grado di vedere il tuo flusso sullo schermo.

Flow illustration


Prepara l'autenticazione per i flussi di canale

Recupera il tuo token di accesso prima di attivare il tuo flusso. 

Il punto finale dell'API è il seguente:

  • client_id = Chiave consumatore

  • client_secret = Segreto consumatore, 

  • Per il refresh_token, fare riferimento al passo 2.3.

Screenshot of a URL used to request a new Salesforce access token using a refresh token


Flow illustration

Crea un lead in Salesforce con WhatsApp

Sostituisci https://XXXX.my.salesforce.com con l'URL della tua istanza. Telefono, Cognome, Azienda, Fonte del lead, Descrizione sono i nomi dei campi di Salesforce. 

Puoi trovarli sotto Impostazioni > Gestione oggetti > Lead > Campi & Relazione. 


Screenshot of a JSON payload for creating a Salesforce Lead using the REST API.


Create a Lead into SF

Sostituisci https://XXXX.my.salesforce.com con l'URL della tua istanza. Telefono, Cognome, Azienda, Fonte del lead, Descrizione sono i nomi dei campi di Salesforce. 

Puoi trovarli sotto Impostazioni > Gestione oggetti > Lead > Campi & Relazione. 


Screenshot of a JSON payload for creating a Salesforce Lead using the REST API.


Create a Lead into SF

Sostituisci https://XXXX.my.salesforce.com con l'URL della tua istanza. Telefono, Cognome, Azienda, Fonte del lead, Descrizione sono i nomi dei campi di Salesforce. 

Puoi trovarli sotto Impostazioni > Gestione oggetti > Lead > Campi & Relazione. 


Screenshot of a JSON payload for creating a Salesforce Lead using the REST API.


Create a Lead into SF

Crea un caso in Salesforce con Viber

Sostituisci https://XXXX.my.salesforce.com con l'URL della tua istanza. Telefono, Cognome, Azienda, FonteLead, Descrizione sono i nomi dei campi di Salesforce. Puoi trovarli in Impostazioni > Gestione oggetti > Lead > Campi & Relazione.

La variabile di output ID è l'ID ID restituito da Salesforce.  

Screenshot of a JSON payload for creating a new Salesforce Case via REST API

Congratulazioni! 

Hai appena collegato con successo Salesforce a WhatsApp e/o Viber per creare lead e casi per il tuo team per favorire un coinvolgimento più rapido e generare lead più qualificati.

Se hai domande sul tuo nuovo flusso o sulla nostra integrazione con Salesforce, ti preghiamo di contattarci via email al nostro support email.

Sostituisci https://XXXX.my.salesforce.com con l'URL della tua istanza. Telefono, Cognome, Azienda, FonteLead, Descrizione sono i nomi dei campi di Salesforce. Puoi trovarli in Impostazioni > Gestione oggetti > Lead > Campi & Relazione.

La variabile di output ID è l'ID ID restituito da Salesforce.  

Screenshot of a JSON payload for creating a new Salesforce Case via REST API

Congratulazioni! 

Hai appena collegato con successo Salesforce a WhatsApp e/o Viber per creare lead e casi per il tuo team per favorire un coinvolgimento più rapido e generare lead più qualificati.

Se hai domande sul tuo nuovo flusso o sulla nostra integrazione con Salesforce, ti preghiamo di contattarci via email al nostro support email.

Sostituisci https://XXXX.my.salesforce.com con l'URL della tua istanza. Telefono, Cognome, Azienda, FonteLead, Descrizione sono i nomi dei campi di Salesforce. Puoi trovarli in Impostazioni > Gestione oggetti > Lead > Campi & Relazione.

La variabile di output ID è l'ID ID restituito da Salesforce.  

Screenshot of a JSON payload for creating a new Salesforce Case via REST API

Congratulazioni! 

Hai appena collegato con successo Salesforce a WhatsApp e/o Viber per creare lead e casi per il tuo team per favorire un coinvolgimento più rapido e generare lead più qualificati.

Se hai domande sul tuo nuovo flusso o sulla nostra integrazione con Salesforce, ti preghiamo di contattarci via email al nostro support email.

Altre notizie

Leggi di più da questa categoria

A person is standing at a desk while typing on a laptop.

La piattaforma completa nativa dell'IA che si espande con la tua azienda.

© 2025 Uccello

A person is standing at a desk while typing on a laptop.

La piattaforma completa nativa dell'IA che si espande con la tua azienda.

© 2025 Uccello