Il tagging delle chiamate consente agli agenti di applicare etichette (tag) alle chiamate Aircall direttamente dalla barra delle utilità di Salesforce, sia durante la chiamata sia subito dopo la sua conclusione. I tag vengono definiti in Aircall e salvati nel record della chiamata in Salesforce. Il tagging obbligatorio è un'impostazione di Aircall per numeri di telefono specifici che richiede agli agenti di selezionare almeno un tag prima di poter completare il lavoro post-chiamata.

Questo articolo spiega come usare il tagging in Salesforce e come funziona il tagging obbligatorio in Salesforce. Per sapere come creare e gestire i tag nella Dashboard di Aircall, consulta Gestire i tag delle chiamate nella Dashboard di Aircall. Per informazioni su come aggiungere tag alle chiamate, consulta Aircall Workspace: aggiungere note e tag alle chiamate.

Prima di iniziare

Assicurati di avere:

  • Il pacchetto gestito Aircall per Service Cloud Voice, versione 0.10.0 o successiva, installato.
  • Salesforce Service Cloud Voice configurato e attivo.
  • L'Estensione omnicanale Aircall aggiunta al Generatore di app Lightning con l'etichetta impostata su Voce Aircall.
  • Tag definiti in Dashboard di Aircall > Impostazioni > Tag. Senza tag, il pannello di tagging sarà vuoto.
  • Per il tagging obbligatorio: l'impostazione deve essere attivata per i numeri di telefono interessati in Dashboard di Aircall > Numeri > Impostazioni del numero.

Configurare il tagging delle chiamate

Il pannello di tagging non viene visualizzato dopo le chiamate se l'Estensione omnicanale Aircall non è stata aggiunta al Generatore di app Lightning per l'app degli agenti. Si tratta di una configurazione da eseguire una sola volta da parte di un amministratore Salesforce.

Passaggi

  1. Vai a Configurazione > Gestione app e apri l'app Lightning utilizzata dagli agenti SCV.
  2. Nella sezione della barra delle utilità, aggiungi il componente Estensione omnicanale Aircall (aircallOmnichannelExtension).

    Screenshot 2026-08-17 at 12.58.52.png
  3. Imposta l'etichetta di questo componente nella barra delle utilità su Voce Aircall.
  4. Salva e attiva la pagina.

    Screenshot 2026-08-17 at 12.59.28.png
Importante: Il componente usa l'etichetta Voce Aircall per trovare e aprire automaticamente il pannello corretto. Se l'etichetta è diversa, la barra delle utilità non si apre per le chiamate in entrata.

Come funziona

  • Durante la chiamata: il pannello di tagging è aperto nella barra delle utilità dal momento in cui la chiamata viene connessa. L'agente può selezionare tag e scrivere note in qualsiasi momento durante la chiamata. L'elenco dei tag viene caricato automaticamente da Aircall. Durante la chiamata non è presente un pulsante Salva; le selezioni vengono mantenute fino alla fine della chiamata.
  • Quando la chiamata termina: il pannello post-chiamata si apre con tutte le selezioni già effettuate dall'agente precompilate. Un elenco aggiornato dei tag viene recuperato in background per includere le modifiche recenti. L'agente può modificare la selezione prima di salvarla.
  • Tagging obbligatorio: se il tagging obbligatorio è attivato in Aircall per il numero di telefono, il pulsante Salva rimane disabilitato finché l'agente non seleziona almeno un tag.
  • Salvataggio: quando l'agente fa clic su Salva, i tag e le note vengono inviati ad Aircall e integrati nel record della chiamata in Salesforce. Nulla di ciò che è già presente nel record viene sovrascritto: salvare due volte non comporta problemi.
  • Conclusione: allo scadere del timer del lavoro post-chiamata, il sistema verifica se il tagging era obbligatorio e se è stato eseguito. Se era obbligatorio ma non è stato eseguito, il timer si ferma e l'agente vede un promemoria. Se la verifica stessa non riesce per qualsiasi motivo, l'agente può sempre proseguire: nessuno rimane bloccato in modo permanente.

Cosa possono fare gli agenti

FunzionalitàCosa può fare l'agenteQuando è disponibile
Aggiungere tag a una chiamataScegliere uno o più tag e aggiungere noteDopo qualsiasi chiamata a cui è stata data risposta
Aggiungere tag durante la chiamataSelezionare tag e scrivere note prima della fine della chiamata; le selezioni vengono riportate nel pannello post-chiamataMentre la chiamata è connessa
Tagging obbligatorioNon è possibile salvare o completare il lavoro post-chiamata senza selezionare almeno un tagSolo per i numeri di telefono con il tagging obbligatorio attivato

Risoluzione dei problemi

Tagging durante la chiamata

ProblemaProbabile causaCosa fare
Nel pannello durante la chiamata non compaiono tagL'elenco dei tag non è stato caricato oppure non esistono tag in AircallVerifica che esistano tag in Dashboard di Aircall > Impostazioni chiamate > Tag. Se esistono ma non compaiono, ricarica la barra delle utilità per riprovare alla chiamata successiva.
I tag selezionati durante la chiamata non vengono riportati nel pannello post-chiamataLa sessione è stata reimpostata durante la chiamataRicarica la barra delle utilità e verifica di avere la versione più recente del pacchetto. Se il problema persiste, controlla se la sessione Salesforce dell'agente è scaduta durante la chiamata.

Il pannello di tagging

ProblemaProbabile causaCosa fare
Il pannello non compare dopo la fine di una chiamataL'Estensione omnicanale Aircall non è stata aggiunta oppure la barra delle utilità non è apertaVerifica che il componente sia stato aggiunto in Configurazione > Generatore di app e che la barra delle utilità sia aperta. Se il componente è presente e alla chiamata è stata data risposta, ricarica la barra delle utilità per ristabilire la connessione.
Il pulsante Salva non è disabilitato anche se il tagging obbligatorio è attivato per il numeroLa connessione non è aggiornata oppure l'impostazione non è attivaVerifica che il tagging obbligatorio sia attivo per quel numero in Dashboard di Aircall > Impostazioni > Numeri di telefono. Se lo è, ricarica la barra delle utilità.
Il pannello si apre ma si chiude subito oppure lampeggiaUn problema relativo alla sessione o al pacchettoRicarica la barra delle utilità. Verifica che la sessione dell'agente sia attiva e che il pacchetto sia aggiornato alla versione più recente.

Selezione dei Tag

ProblemaCausa probabileCosa fare
Nel pannello non compaiono Tag tra cui scegliereNon ci sono Tag in Aircall oppure il recupero dei dati non è riuscitoVerifica che esistano Tag in Pannello di controllo Aircall > Impostazioni chiamate > Tag. Se ci sono ma non compaiono, ricarica la barra delle utilità per avviare un nuovo recupero dei dati.
I Tag di una chiamata precedente compaiono ancora per una nuova chiamataLa sessione non è stata reimpostata correttamenteRicarica la barra delle utilità. Se succede regolarmente, verifica di usare la versione più recente del pacchetto.

Salvataggio di Tag e note

ProblemaCausa probabileCosa fare
Il salvataggio riesce, ma i Tag non compaiono nel record della chiamata in SalesforceMancano le autorizzazioni oppure il relativo record delle chiamate vocali Aircall non esiste ancoraVerifica che l'agente abbia accesso in lettura e modifica ai record delle chiamate vocali Aircall. Verifica che il record correlato esista; se la sincronizzazione non è ancora terminata, attendi qualche secondo e aggiorna la pagina.
I Tag salvati in Salesforce non compaiono nella chiamata in AircallUn problema di connessioneRicarica la barra delle utilità per ristabilire la connessione. Se la discrepanza persiste, contatta l'assistenza Aircall.
Compare un errore durante il salvataggio dei TagAircall ha rifiutato la richiestaRicarica la barra delle utilità e riprova. Se il problema persiste, verifica che il record della chiamata esista ancora in Aircall; non è possibile assegnare Tag da Salesforce alle chiamate eliminate o archiviate.

Attività post-chiamata e assegnazione obbligatoria dei Tag

ProblemaCausa probabileCosa fare
Il timer delle attività post-chiamata scade e compare un promemoria per assegnare un Tag alla chiamataIl blocco per l'assegnazione obbligatoria dei Tag funziona come previstoScegli un Tag e salvalo; il blocco viene rimosso non appena il Tag viene confermato.
Il blocco delle attività post-chiamata si attiva, ma l'assegnazione dei Tag non dovrebbe essere obbligatoria per questo numeroIl valore di un'impostazione non è aggiornatoVerifica l'impostazione Assegnazione obbligatoria dei Tag per il numero in Pannello di controllo Aircall > Numeri > Impostazioni del numero. Se è disattivata ma il blocco si attiva comunque, ricarica la barra delle utilità. Se il problema persiste, contatta l'assistenza Aircall.
L'assegnazione obbligatoria dei Tag non si attiva per una chiamata trasferitaLa configurazione di quel numero per gli scenari di trasferimentoContatta l'assistenza Aircall per verificare che l'assegnazione obbligatoria dei Tag sia configurata correttamente per i trasferimenti su quel numero.
Una seconda chiamata in entrata sembra scomparire mentre è in corso l'assegnazione obbligatoria dei Tag per la primaUn caso limite noto, risolto negli aggiornamenti recentiVerifica di usare la versione più recente del pacchetto. Se succede durante una sessione, ricarica la barra delle utilità.

Se nessuna di queste soluzioni risolve il problema, contatta l'assistenza Aircall indicando l'ID della tua organizzazione Salesforce, la versione del pacchetto installato, il numero Aircall e l'indirizzo email dell'agente, il browser utilizzato, l'ID della chiamata interessata o il record Salesforce e una descrizione di quanto accaduto.