Integrazione CRM Salesforce

Introduzione

Aggiungi contatti con 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

Configurazione Salesforce - app manager

  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 impostazioni" > "Configurazione".
  3. Nella barra laterale, sotto la sezione PLATFORM TOOLS, selezionare "App > App Manager".
  4. Clliccare sul pulsante "Nuova app client esterna" in alto a destra della pagina web.
  5. Verrà visualizzato il modulo “Gestione app client esterna”.

Client esterno

  1. Nel pannello Informazioni di base, inserisci il nome dell'app client esterna, un indirizzo e-mail di contatto e lo stato di distribuzione.

Abilita OAuth impostazioni

  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 al servizio URL di identità (id, profilo, e-mail, indirizzo, telefono)
  • Accesso agli identificatori unici degli utenti (openid)
  • Accesso completo (full)
  • Gestione dei dati utente tramite API (api)
  • Gestire i dati dell'utente tramite browser web (web)
  • Eseguire richieste in qualsiasi momento (refresh_token, offline_access)
  1. Scorri verso il basso fino alla sezione Sicurezza, assicurati che le opzioni “Richiedi chiave segreta per flusso server web” e “Richiedi chiave segreta per flusso token di aggiornamento” siano selezionate.
  2. Inoltre, tieni presente che PKCE (Proof Key for Code Exchange) è ora supportato su 3CX versione 20, Update 6. È possibile utilizzare il flusso di autenticazione PKCE abilitando l'opzione “Richiedi chiave di prova per l'estensione Code Exchange (PKCE) per i flussi di autorizzazione supportati”. Se l'opzione è disabilitata, il PKCE verrà ignorato e l'autorizzazione verrà eseguita correttamente.
  3. Premere “Crea”.
  4. Cliccare su “App > Gestione app client esterne > Trova la tua app” dall'elenco e cliccare su “Modifica politiche”.

Modifica politiche

  1. In Politiche, vai alla sezione Politiche OAuth e imposta Utenti autorizzati su “Tutti gli utenti possono autorizzarsi autonomamente”.
  2. Cliccare su “Salva”.

Impostazioni generali

  1. In Impostazioni, vai alla sezione Impostazioni OAuth e clicca sul pulsante “Chiave consumatore e segreta”. Quindi copia i valori per “Chiave consumatore” e “Chiave segreta consumatore”: dovremo aggiungerli in seguito nella sezione di integrazione 3CX CRM.

Passo 2: Configurare il 3CX

Integrazione CRM

  1. Accedere alla console di gestione 3CX e andare a "Integrazioni” > “CRM" 
  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 “Salva” 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

Abilita Call Journaling

  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]
    . Le variabili disponibili da utilizzare sono elencate     qui.

Abilita Call Journaling sul centralino

  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]
    . Le variabili disponibili da utilizzare sono elencate     qui.

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

Opzioni 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

Configurare la creazione di 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]. Le variabili disponibili da utilizzare sono elencate qui.
  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.

📄 Nota: Quando si creano contatti in Salesforce, il nome della società specificato nel web client viene ignorato. Ciò è dovuto alle limitazioni dell'API di Salesforce. Questo vale solo per i contatti, il nome dell'azienda viene impostato quando si creano le derivazioni.

Per saperne di più

Ultimo aggiornamento

Questo documento è stato aggiornato il 17 luglio 2025

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

Discuti questo articolo