Questa guida spiega come abilitare le azioni IA di Salesforce e collegarle all'Agente vocale IA di Aircall, affinché l'agente possa cercare, aggiornare e creare record Salesforce durante una chiamata in corso, senza trasferirla a una persona.

Questa guida illustra le azioni IA di Salesforce per un Agente vocale IA nelle chiamate in entrata. Configura l'agente come agente in entrata; le azioni IA di Salesforce non sono disponibili per le chiamate in uscita.

Importante: Prima di iniziare, devi sapere due cose. Innanzitutto, questa operazione modifica dati Salesforce reali: l'agente legge e scrive nella tua organizzazione Salesforce usando le tue autorizzazioni e verifica l'identità del chiamante prima di modificare un record esistente. In secondo luogo, utilizza la quota API di Salesforce: ogni azione è una richiesta API Salesforce e viene conteggiata nel limite giornaliero della tua organizzazione.

Prima di iniziare

  • Il tuo piano Aircall deve essere Professional o Custom e avere l'Add-on Agente vocale IA abilitato.
  • La tua Integrazione Salesforce deve essere autorizzata e connessa nel Dashboard Aircall.
  • Devi aver configurato un Agente vocale IA. Se non ne hai ancora uno, consulta prima Configurazione dell'Agente vocale IA, quindi torna a questa guida.

Azioni Salesforce disponibili

Ogni azione riportata di seguito è predefinita da Aircall. Gli input, gli output e il comportamento sono fissi. Gli amministratori stabiliscono quali azioni abilitare e quali agenti possono utilizzarle, ma non possono modificare ciò che fa un'azione.

FunzionalitàCosa fa
Trova clienteIdentifica il chiamante cercandolo in Salesforce per telefono (opzione preferita), e-mail o nome e restituisce il Contatto, Lead o Il mio conto corrispondente. Viene eseguita per prima, affinché le altre azioni sappiano su quale record operare. Sola lettura.
Trova casoCerca il caso del chiamante: un caso specifico tramite il relativo numero oppure un elenco dei casi del chiamante filtrato per aperti, chiusi o tutti. Sola lettura.
Trova opportunitàVerifica se il chiamante ha opportunità in corso, come contesto di supporto, ad esempio per annotare un interesse o instradare la chiamata. Sola lettura.
Recupera cronologia attivitàMostra le interazioni recenti con il chiamante, comprese le chiamate registrate, le attività e le riunioni, affinché l'agente possa rispondere disponendo del contesto completo. Sola lettura.
Recupera cronologia casoSpiega come un caso ha raggiunto lo stato attuale, cosa è cambiato e quando, oltre ai commenti pubblici aggiunti dagli agenti. Sola lettura.
Crea casoApre un nuovo caso per il chiamante. Il caso viene creato con lo stato Nuovo e l'origine impostata su Telefono ed è collegato automaticamente alla chiamata da cui proviene. Per la priorità puoi usare parole comuni come "urgente" o "normale".
Aggiorna casoAggiorna il caso per cui il chiamante sta chiedendo assistenza, modificandone lo stato, la priorità, l'oggetto o la descrizione, oppure aggiunge un commento pubblico. Richiede prima la verifica dell'identità.
Crea o aggiorna record clienteVerifica che il chiamante esista in Salesforce con il tipo di record corretto (Contatto, Lead o Il mio conto) e inserisce i dettagli appresi durante la chiamata. Compila soltanto i campi vuoti o i segnaposto creati da Aircall, senza mai sovrascrivere le informazioni già presenti per il cliente.
Aggiorna recordCorregge un campo reale di un Contatto, Lead o Il mio conto esistente quando il chiamante lo richiede esplicitamente, ad esempio: "Il mio indirizzo e-mail è sbagliato". Richiede la verifica dell'identità e la rilettura prima del salvataggio.
Nota: Crea caso e Crea o aggiorna record cliente sono progettate per evitare duplicazioni nel Registro chiamate esistente. Riutilizzano un record corrispondente esistente, se presente, e non creano l'attività della chiamata stessa, poiché viene già registrata dal Registro chiamate standard di Aircall.

Passaggio 1: abilita le azioni nella tua Integrazione Salesforce

Tutte le azioni sono attive per impostazione predefinita. Disattiva soltanto quelle che non vuoi mettere a disposizione dei tuoi agenti.

Passaggi

  1. Vai a Dashboard Aircall > Integrazioni > App.
  2. Apri l'Integrazione Salesforce connessa e seleziona la scheda Azioni IA.
  3. Attiva o disattiva le azioni che vuoi rendere disponibili o disabilitare.
1-1.png
Nota: Abilitare un'azione qui non influisce sulle chiamate in corso né sulla configurazione esistente. Rende soltanto l'azione disponibile per l'assegnazione a un agente. Un'azione disabilitata non viene visualizzata nella configurazione dell'agente.

Passaggio 2: aggiungi le azioni Salesforce al tuo Agente vocale IA

Passaggi

  1. Apri l'agente e, in Capacità funzionali, fai clic su Azioni IA.
  2. Fai clic su + Aggiungi azione.

    Screenshot 2026-08-14 at 14.29.02.png
  3. Nell'elenco Seleziona dalle integrazioni, cerca Salesforce e scegli l'azione che desideri.

    Screenshot 2026-08-14 at 14.29.32.png
  4. Esamina le istruzioni preimpostate e gli input richiesti, quindi fai clic su Aggiungi azione. Ripeti la procedura per ogni azione che vuoi far utilizzare all'agente.
  5. Fai clic su Salva.
  6. Fai clic su Attiva agente per iniziare a utilizzare l'agente per le tue chiamate.
Screenshot 2026-08-14 at 14.30.01.png
Suggerimento: Se hai installato più di una Integrazione Salesforce, assegna a ciascuna un nome personalizzato distinto, in modo da distinguerne le azioni quando le aggiungi a un agente. In caso contrario, i gruppi nel menu a discesa appaiono identici ed è facile aggiungere un'azione dall'integrazione sbagliata.
Nota: Se un'azione non è presente nel menu a discesa, significa che non è abilitata nell'integrazione. Torna al Passaggio 1 e attivala.

Indicare all'agente quando utilizzare ogni azione

Dopo aver aggiunto un'azione, puoi fornire istruzioni in linguaggio semplice su quando richiamarla. Puoi scrivere queste regole in due punti, ciascuno con una finalità diversa.

Istruzioni aggiuntive (nel pannello dell'azione) si applicano solo a quella specifica azione. Usale per controllare il modo in cui l'agente raccoglie gli input, su quali campi di output concentrarsi o cosa confermare prima dell'esecuzione.

Linee guida per la conversazione (sotto l'elenco delle azioni in uso, visibile dopo aver salvato la prima azione) si applicano a tutte le azioni IA dell'agente. Usale per definire gli eventi di attivazione, concatenare le azioni, creare diramazioni in base ai valori restituiti e impostare condizioni di fallback o trasferimento. Ad esempio: "Quando la persona che chiama chiede informazioni su un ticket esistente, usa Trova caso".

Suggerimento: Scrivi le regole nelle Istruzioni aggiuntive quando la logica riguarda una singola azione. Usa le Linee guida per la conversazione per la logica aziendale che interessa più azioni o dipende da ciò che restituisce un'azione. Inserire la stessa regola in entrambi i punti rende più difficile eseguire il debug dell'agente.

Per una spiegazione completa delle differenze tra Istruzioni aggiuntive e Linee guida per la conversazione e di quando usare ciascuna opzione, consulta Utilizzo delle azioni IA con gli Agenti vocali IA.

Testare la configurazione

Testa la configurazione prima di attivarla. Esistono due modi per convalidarla.

Scheda Test dell'integrazione

Passaggi

  1. Vai a Dashboard Aircall > Integrazioni > App.
  2. Apri l'Integrazione Salesforce connessa e vai alla scheda Test delle azioni IA.
  3. Seleziona un'azione, compila i parametri e fai clic su Esegui per verificare la connessione e visualizzare la risposta di Salesforce.

Chiamata di prova nelle impostazioni dell'agente

Passaggi

  1. Vai a Dashboard Aircall > Agenti IA > Agenti vocali IA e apri l'agente che vuoi testare.
  2. Fai clic su Chiamata di prova per simulare una conversazione reale dall'inizio alla fine.
Importante: Le chiamate di prova consumano minuti degli Agenti vocali IA e possono creare record reali in Salesforce. Quando possibile, usa una Sandbox Salesforce.
Suggerimento: Se un'azione non riesce nella scheda Test delle azioni IA, il problema riguarda Salesforce (la connessione, le autorizzazioni dell'utente connesso o una regola di convalida dell'organizzazione), non l'agente. Se invece riesce nella scheda ma l'agente non l'ha usata durante una Chiamata in corso, il problema riguarda l'assegnazione all'agente o le indicazioni su "quando usarla" nel passaggio 2, non Salesforce.

Risoluzione dei problemi comuni

Cosa vediCausa probabileCosa fare
L'azione Salesforce non è presente nel menu a discesa durante la configurazione dell'agenteNon è abilitata nell'Integrazione SalesforceAbilitala nel passaggio 1; apparirà quindi nel passaggio 2
L'agente non ha usato l'azione durante la chiamataL'azione non è assegnata oppure l'agente non dispone di indicazioni su quando usarlaVerifica che l'azione sia stata aggiunta all'agente e inserisci indicazioni in un italiano semplice nelle Linee guida per la conversazione
L'agente ha detto di non riuscire a trovare la persona che chiamaNessun record Salesforce corrispondente: è normale per una persona nuova o sconosciutaÈ il comportamento previsto; l'agente può creare un record se opportuno
L'agente ha salutato la persona sbagliata o recuperato i record di qualcun altroPiù record Salesforce condividono il numero di telefono della persona che chiama; l'agente usa quello aggiornato più di recenteElimina i duplicati in Salesforce: unisci i record oppure correggi i numeri di telefono, in modo che rimanga una sola corrispondenza univoca
Un aggiornamento è stato rifiutato oppure l'agente ha chiesto alla persona che chiama di confermare un datoVerifica dell'identità, prevista per le modifiche ai record esistentiChiedi alla persona che chiama di confermare un valore registrato (nome, indirizzo email o numero di telefono); l'aggiornamento potrà quindi proseguire
Salesforce ha rifiutato una creazione o un aggiornamentoUna regola di convalida dell'organizzazione, un campo obbligatorio o una restrizione a livello di campo ha impedito la scritturaControlla le regole di convalida e i campi obbligatori dell'oggetto in Salesforce, modifica la regola o concedi l'accesso all'utente connesso, quindi riprova
L'agente non può visualizzare o modificare determinati record o campiL'utente Salesforce connesso non dispone dell'autorizzazione per quell'oggetto o campoConcedi l'accesso all'utente Salesforce connesso, quindi riprova
Un agente In uscita non ha usato le azioni SalesforceLe azioni IA di Salesforce supportano solo le chiamate In entrataÈ il comportamento previsto; usa le azioni con un agente In entrata
Salesforce segnala che la connessione non è autorizzata o è scadutaÈ necessario autenticare nuovamente la connessione SalesforceRiconnetti l'Integrazione Salesforce nel Dashboard, quindi riprova
L'azione è stata lenta o è scadutaSalesforce è stato lento oppure la ricerca era estesa

Se nessuna di queste soluzioni risolve il problema, contatta il Supporto Aircall indicando l'agente interessato, l'azione coinvolta, una chiamata o un record di esempio, il risultato previsto e ciò che è accaduto.

Domande frequenti

L'agente modifica i miei dati Salesforce?

Sì. Può creare e aggiornare record, casi, contatti, lead e i miei conti usando le autorizzazioni della tua organizzazione. Prima di modificare un record esistente verifica l'identità della persona che chiama; nel resto dei casi, legge i record.

Cosa succede se la persona che chiama non viene trovata in Salesforce?

L'agente può comunque fornire assistenza e, quando opportuno, creare un contatto essenziale usando i dati della persona che chiama, in modo che il caso non rimanga senza collegamento. Se trova una corrispondenza, riutilizza il record esistente, evitando così di creare duplicati.

L'agente può registrare la chiamata come attività o compito?

No. Il Registro chiamate standard di Aircall registra già la chiamata. Le azioni IA di Salesforce non creano intenzionalmente attività di chiamata, così non vengono generate voci duplicate.

Questa funzionalità consuma il mio limite API di Salesforce?

Sì. Ogni azione è una richiesta API di Salesforce conteggiata nel limite giornaliero della tua organizzazione, quindi il consumo aumenta in base alla frequenza con cui gli agenti usano le azioni.

Serve un amministratore Salesforce per configurare questa funzionalità?

Non è richiesto alcun intervento da parte di un amministratore Salesforce oltre alla connessione iniziale dell'integrazione. L'abilitazione delle azioni e la loro aggiunta a un agente vengono eseguite interamente nel Dashboard dall'amministratore del tuo account Aircall.

Quali autorizzazioni Salesforce usa l'agente?

Le azioni vengono eseguite come l'utente Salesforce che ha autorizzato l'integrazione, quindi l'agente può visualizzare e modificare solo ciò che è consentito a tale utente. Per limitare gli elementi su cui l'agente può intervenire, definisci in modo appropriato il profilo e le autorizzazioni di quell'utente Salesforce.

Agenti diversi possono avere azioni diverse?

Sì. Le azioni vengono aggiunte a ciascun agente, quindi un agente di supporto e un agente di vendita possono avere ciascuno il proprio set. Abilitare un'azione nell'Integrazione Salesforce la rende soltanto disponibile per l'assegnazione, senza attivarla per tutti gli agenti.

Devo aggiungere tutte le azioni?

No. Aggiungi soltanto quelle necessarie all'agente. Un set più piccolo e mirato consente in genere all'agente di agire in modo più chiaro e prevedibile.

Come posso impedire in seguito a un agente di usare un'azione?

Rimuovila dalle azioni IA dell'agente oppure disattivala nella scheda Azioni IA dell'Integrazione Salesforce per revocarla contemporaneamente a tutti gli agenti. Le modifiche diventano effettive dopo aver salvato e attivato l'agente.

Come fa l'agente a sapere con chi sta parlando?

Cerca chi chiama in Salesforce tramite il numero di telefono e può anche trovare corrispondenze in base all'indirizzo e-mail o al nome tra Contatti, Lead e I miei conti.

Posso modificare la funzione o la formulazione di un'azione?

No. Il comportamento di ogni azione è definito da Aircall. Puoi stabilire quando l'agente deve usarla tramite le Linee guida per la conversazione e cosa deve dire tramite il copione della chiamata, ma non puoi modificarne la logica interna.

Gli agenti per le chiamate in uscita possono usare queste azioni?

No. Le Azioni IA di Salesforce sono disponibili soltanto per le chiamate in entrata. Configura l'agente su In entrata.

Con quali record di Salesforce può operare?

Contatti, Lead, I miei conti, Casi e Opportunità. Li legge per ricavare il contesto e, dove hai abilitato questa funzione, crea o aggiorna Contatti, Lead, I miei conti e Casi.

Come evita di modificare il record della persona sbagliata?

Prima di aggiornare un record esistente, l'agente verifica chi chiama chiedendo di confermare un dato già presente in archivio e ripete la modifica prima di salvarla. Se il dato non corrisponde, non effettua la modifica.

Posso provarlo prima dell'attivazione?

Sì. Usa una chiamata di prova e la scheda Test delle Azioni IA per verificare come l'agente usa le azioni prima di attivarlo.