Integrazione CRM Salesforce

Introduzione

Integrazione CRM Salesforce

3CX offre l'integrazione con Salesforce tramite l'API 3CX per CRM con le seguenti caratteristiche:

  • ID chiamante a nome del contatto: Le chiamate in entrata avviano una ricerca del contatto in Salesforce.
  • Ricerca del contatto in Salesforce in base al nome, al numero o all'email se si cerca un nome nel 3CX Webclient.
  • Call & Chat Journalling: Le chiamate e le chat vengono registrate nella scheda contatti di Salesforce come record di chiamata del CRM.
  • Creare un nuovo contatto HubSpot dal client 3CX per le chiamate da nuovi numeri.
  • Click to Call: Avviare le chiamate direttamente da Salesforce tramite 3CX, utilizzando le estensioni del browser 3CX Click2Call per Google Chrome e Microsoft Edge.

Requisiti:

  • L'account Salesforce deve avere l'API REST abilitata. Controllare qui le edizioni di Salesforce in cui l'API è disponibile.
  • Gli account Salesforce con Account persona abilitati non sono supportati.

Passo 1: Configurare Salesforce

Configurazione Salesforce - Setup

Configurazione Salesforce - App connesse

  1. Accedere al proprio account Salesforce https://login.salesforce.com/ o creare un account per sviluppatori da qui https://developer.salesforce.com/signup.
  2. Cliccare su "Icona ingranaggio" > "Configurazione".
  3. Nella barra laterale, sotto la sezione PLATFORM TOOLS, selezionare "App > App Manager".
  4. Fare clic sul pulsante "Nuova app connessa" in alto a destra della pagina web.
  5. Inserire un nome per l'app, ad esempio CXPBX, un'email di contatto e premere Salva.

Salesforce - Scopi

  1. Scorrere fino a API (Abilita impostazioni OAuth) e attivare la casella di controllo "Abilita impostazioni OAuth".
  2. Per il campo Callback URL, inserire l'URL che si usa per accedere alla console di gestione 3CX, aggiungendo "/api/oauth2crm" alla fine, ad esempio: "https://my-pbx.example.com/api/oauth2crm". Poi dare i permessi come da immagine sopra. I permessi sono:
  • Accesso e gestione dei dati (api).
  • Accesso alle informazioni di base.
  • Accesso al tuo identificatore unico (openid).
  • Accesso completo.
  • Eseguire richieste per conto dell'utente in qualsiasi momento.
  • Fornite l'accesso ai tuoi dati via web.
  1. Premere “Salva”.

Salesforce - List App Manager

  1. Fare clic su "App > App manager > Trova la tua applicazione" dall'elenco e fare clic su "Visualizza".  

Configurazione Salesforce - API (Key connessa)

  1. Nella sezione API copiare "Chiave del consumatore" e "Segreto del consumatore" - dovremo aggiungerli in seguito nella sezione di integrazione del 3CX CRM.
  2. Fare clic su "Gestione" in alto e su "Modifica criteri".

Configurazione Salesforce - OAuth politiche

  1. Andare alla sezione Politiche OAuth e impostare Utenti autorizzati su "Tutti gli utenti possono auto-autorizzarsi".
  2. Premere “Salva”.

Passo 2: Configurare il 3CX

Configurazione generale di Salesforce e 3CX

  1. Accedere alla console di gestione 3CX e andare a "Impostazioni" > "Integrazione CRM" > scheda "Lato server".
  2. Selezionare "SalesforceV2" dall'elenco a discesa.
  3. Compilare i dettagli ottenuti nel passo precedente per la chiave del consumatore e il segreto del consumatore e premere il pulsante Autorizza per avviare il processo di autorizzazione. Concedi l'accesso al 3CX e il Token di aggiornamento verrà visualizzato sotto il pulsante Autorizza.

Passo 3: Configurare il Journaling delle chiamate e chat

Salesforce Journaling delle chiamate

  1. Per segnalare le chiamate esterne e le chat a Salesforce, l'indirizzo email configurato per l'interno 3CX deve corrispondere all'indirizzo email di un utente Salesforce. In questo modo il 3CX può mappare l'interno 3CX che riceve la chiamata o la chat con l'utente Salesforce.
  2. Selezionare l'opzione "Abilita Call Journaling" per segnalare le chiamate esterne al CRM e configurare questi parametri "Journaling chiamate":
  • "Oggetto della chiamata" - l'oggetto della chiamata.
  • "Chiamata in entrata con risposta" - descrizione per le chiamate in entrata con risposta.
  • "Chiamata persa" - descrizione per le chiamate perse.
  • "Chiamata in uscita con risposta" - descrizione per le chiamate in uscita con risposta.
  • "Chiamata in uscita senza risposta" - descrizione per le chiamate in uscita senza risposta.
  1. Si noti che nei parametri "Journaling delle chiamate" è possibile utilizzare delle variabili, indicate come
    [nome_variabile]
    , ad esempio il numero esterno è specificato come
    [Numero]
    .

Salesforce Journaling delle Chat

  1. Se si desidera segnalare le chat al CRM, selezionare la casella di controllo Abilita Chat Journaling e configurare i parametri seguenti:
  • Oggetto della chat: L'oggetto della sessione di chat.
  1. Si noti che nei parametri "Chat Journaling" è possibile utilizzare delle variabili, indicate come
    [nome_variabile]
    , ad esempio il numero esterno è specificato come
    [Numero]
    .

Passo 4: Configurazione dei contatti e164 e dell'ID chiamante

Strategia di abbinamento dei contatti

  1. Per ottenere una corrispondenza con Salesforce, le ultime 7 cifre dell'ID chiamante in entrata devono corrispondere alle ultime 7 cifre di un campo telefonico in una voce del CRM, oppure il numero completo ricevuto dal trunk SIP deve corrispondere completamente al numero di telefono nel CRM.
  2. Salesforce può memorizzare i numeri in formato E164, quindi se il trunk SIP fornisce il numero del chiamante anche in formato E164, è preferibile una corrispondenza esatta. È anche possibile utilizzare la riformattazione dell'ID chiamante per adattare il numero del chiamante prima che venga trasmesso al CRM.
  3. ⚠ Importante: nella console di gestione 3CX, aprire "Avanzate" > "Contatti" > "Opzioni". Impostare la strategia di corrispondenza su "Corrisponde esattamente" quando possibile (formato E164 richiesto in Salesforce e nel trunk SIP), oppure "Corrisponde ad almeno X numeri di caratteri" e impostare il valore su 7.
  4. ⚠ Importante: in Salesforce assicuratevi che tutti i numeri dei vostri contatti siano memorizzati nel formato E164, compreso il prefisso più (+). Il prefisso più (+) impedisce a Salesforce di riformattare automaticamente il numero se ci si trova negli Stati Uniti o in Canada, causando il fallimento della ricerca del contatto.

Passo 5: Configurare la creazione di contatti

Configurazione dei contatti

  1. Se si desidera creare nuovi contatti nel CRM quando si riceve una chiamata da un numero sconosciuto (non trovato sia nel 3CX che nel CRM), selezionare la casella di controllo "Consenti la creazione di contatti direttamente nel CRM usando il 3CX Web Client" e configurare i parametri sottostanti.
  2. I parametri di creazione del contatto sono:
  • Crea Lead o Contatto - L'entità da creare (Lead/Contatto).
  • Nuova azienda - Il nome dell'azienda quando viene creato un contatto.
  1. Si noti che è possibile utilizzare variabili nei parametri. Le variabili sono specificate tra [], ad esempio il numero esterno è specificato come [Numero].
  2. Quando il numero del chiamante non può essere abbinato a un contatto, il client 3CX permetterà all'utente di creare il contatto compilando i dettagli in una finestra di dialogo.

Per saperne di più

Ultimo aggiornamento

Questo documento è stato aggiornato l'ultima volta il 19 luglio 2023

https://www.3cx.it/doc/integrazione-crm-salesforce/ 

Discuti questo articolo