L'instradamento intelligente all'ultimo Agente garantisce che i chiamanti ricorrenti vengano collegati automaticamente all'Agente che li ha contattati più di recente. Utilizzando il widget Instrada a (tramite API) di Aircall in Smartflows, puoi migliorare le tue attività di chiamata in uscita e offrire un'esperienza più fluida ai clienti ricorrenti.

Importante: Il widget Instrada a (tramite API) deve essere abilitato tramite un flag di funzionalità. Contatta il tuo referente Aircall per abilitarlo prima di procedere.
Nota: Il tutorial video potrebbe mostrare la versione precedente della sezione Verifica risposta. Fai sempre riferimento ai passaggi scritti in questo articolo per le indicazioni più aggiornate.

Perché utilizzare l'instradamento intelligente all'ultimo Agente?

L'utilizzo del widget Instrada a (tramite API) per configurare l'instradamento all'ultimo Agente offre diversi vantaggi:

  • Migliore esperienza per il chiamante, collegando i clienti ricorrenti all'Agente che conosce il loro caso
  • Riduzione dell'abbandono delle chiamate, poiché le chiamate vengono indirizzate direttamente a un contatto noto
  • Maggiore efficienza, evitando che l'intero Team venga interrotto da chiamate in entrata non pertinenti
  • Migliore gestione dei lead, poiché gli agenti si concentrano sui propri potenziali clienti

Crea la tua chiave API Aircall

Per iniziare, hai bisogno di una chiave API Aircall. Questa consentirà al widget Instrada a (tramite API) di autenticarsi e recuperare la Cronologia delle chiamate.

Passaggi

  1. Nel Dashboard Aircall, vai a Integrazioni > Chiavi API.
  2. Fai clic su Genera una chiave API.
  3. Assegna un nome alla chiave, quindi copia l'ID API e il token API.
Screenshot 2025-09-16 at 6.55.35 PM.png
  1. Salvali in modo sicuro, poiché questa è l'unica volta in cui il token sarà visibile.
  2. Fai clic su Conferma.
Nota: Se perdi il token, dovrai generarne uno nuovo.

Configura il widget Instrada a (tramite API) in Smartflows

Ora configura il tuo Smartflow utilizzando la chiave API per abilitare l'instradamento dinamico.

Passaggi

  1. Nel Dashboard Aircall, vai al Numero Smartflows che desideri configurare.

  2. Inserisci il widget Instrada a (tramite API) nella posizione desiderata all'interno del Flusso delle chiamate.

Nota: Gli Utenti instradati tramite l'API non devono essere necessariamente assegnati alla Distribuzione delle chiamate di Smartflows. Tuttavia, se sono assegnati, riceveranno le notifiche delle Chiamate perse nella loro Lista delle cose da fare.
  1. Configura la Richiesta nell'editor del widget:
    • URL: copia e incolla il seguente URL: https://api.aircall.io/v1/calls/search?direction=outbound&order=desc&phone_number={{callerNumber}}
      • Questo URL cercherà la chiamata in uscita più recente effettuata verso il Numero del chiamante in entrata attuale e restituirà l'Utente Aircall corrispondente.
    • Metodo: nel menu a discesa Metodo saranno disponibili le opzioni POST e GET. Assicurati di aver selezionato GET

    • Autenticazione: nel menu a discesa Autenticazione saranno disponibili le seguenti opzioni: Autenticazione di base (Utente e password), Token bearer, Chiave API, OAuth e Nessuna. Assicurati di aver selezionato Autenticazione di base (Utente e password)

    • Credenziali: seleziona Imposta credenziali e inserisci le seguenti informazioni:
      • Nome utente = il tuo ID API
      • Password = il tuo token API
  1. Scorri verso il basso e configura la Risposta:
    • Tipo di risposta: nel menu a discesa Tipo di risposta, saranno disponibili le opzioni Utente (ID o e-mail), Team (ID), Numero Aircall (interno), Numero esterno e Destinazione dinamica (ID). Assicurati di aver selezionato Utente (ID o e-mail)

    • Percorso: copia e incolla quanto segue nel campo Percorso: calls[0].user.id

    • Per concludere, devi eseguire un test sulla risposta nell'apposito campo Testa risposta. Questo campo accetta un oggetto JSON contenente una o più variabili di input utilizzate nell'URL o nel corpo della richiesta.
    • Per questo esempio, dovrai fornire callerNumber nel formato E.164, ma puoi includere anche altre variabili se richieste dalla configurazione.
    • Esempio:
      {
        "callerNumber": "+15551234567"
      }
    • Quando esegui il test, il widget sostituisce le variabili nella richiesta con i valori del JSON e mostra il risultato analizzato in base al percorso configurato (calls[0].user.id). Assicurati che il payload restituito contenga i dati previsti, affinché il widget possa instradare correttamente la chiamata.
  1. Modifica le impostazioni di squillo sotto il campo del test in base alle tue preferenze operative.
Suggerimento: Esegui sempre un test per verificare che il percorso restituisca un ID Utente Aircall corretto.

Facoltativo: aggiungi un Team di fallback

Valuta la possibilità di aggiungere un Team di fallback dopo il widget Ring-to (via API), per assicurarti che nessuna chiamata venga persa se l'ultimo Agente è Non disponibile.

Nota: Tutte le destinazioni di Instradamento (Utenti, Team, Numeri) devono esistere prima di configurare il widget Ring-to (via API).
serve aiuto?
Suggerimento: Se vuoi sfruttare questa funzionalità ma non disponi delle competenze tecniche necessarie, contatta il nostro Team di gestione degli account, che ti metterà in contatto con il nostro Team tecnico per ricevere Supporto e indicazioni sull'implementazione.