Il widget Instradamento intelligente: Chiama (tramite API) utilizza una risposta API per determinare a quale utente, Team, numero interno o numero esterno Aircall instradare una chiamata, in base ai dati archiviati al di fuori di Aircall.

Questo widget offre funzionalità di instradamento dinamico potenti e flessibili collegando Aircall a sistemi di terze parti, come CRM o Help desk.

Importante: Il widget Chiama (tramite API) è disponibile solo con il Piano Professional. Per effettuare l'upgrade, contatta il tuo account manager Aircall.

Prerequisiti

Prima di configurare il widget, assicurati che siano soddisfatti i seguenti requisiti.

Credenziali di autenticazione

Il Metodo di autenticazione dipende dalla piattaforma esterna da cui intendi recuperare i dati. I metodi supportati includono:

  • Autenticazione di base
  • Token bearer
  • Chiave API
  • OAuth

Esempio (API Aircall):

  1. Nel Dashboard Aircall, vai a Integrazioni > Chiavi API.
  2. Genera una nuova chiave API.
  3. Salva sia l'ID della chiave API sia il token.
  4. Nella configurazione del widget Chiama (tramite API), vai a Credenziali e imposta:
    • Nome utente = ID della chiave API
    • Password = token API

Per ulteriori informazioni su come trovare la chiave API Aircall, consulta il nostro articolo Dove trovare la mia chiave API Aircall.

Conoscenza dell'API della piattaforma

Devi conoscere la struttura e gli endpoint dell'API pubblica della piattaforma esterna.

Sebbene Dove trovare la mia chiave API Aircall utilizzi l'API Aircall come esempio, puoi usare anche piattaforme come HubSpot, Salesforce, Zendesk, Intercom, Pipedrive o CRM interni.

Conoscenza di JSON

Il widget utilizza JSON (JavaScript Object Notation) per scambiare dati con le API. È necessaria una conoscenza delle strutture JSON di base per configurare correttamente i percorsi dei dati.

Suggerimento: Se hai bisogno di assistenza per configurare il widget, il nostro team tecnico può fornire consulenza e Supporto per l'implementazione. Contatta il nostro team di Account Management.

Considerazioni sull'utilizzo

Il widget Chiama (tramite API) consente l'Instradamento delle chiamate dinamico (“intelligente”) in base a dati esterni. Può interrogare qualsiasi sistema che supporti API REST e Metodi di autenticazione standard.

Nota: Le richieste effettuate da Chiama (tramite API) scadranno dopo 10 secondi. Assicurati che l'endpoint risponda entro questo limite di tempo; in caso contrario, il widget potrebbe non riuscire a recuperare la destinazione dell'instradamento.

La risposta API deve restituire i dati in un formato che Aircall possa interpretare per l'instradamento. I tipi di risposta supportati includono:

Tipo di rispostaDescrizione
UtenteInstrada la chiamata a un Agente specifico utilizzando il suo ID utente Aircall o il suo indirizzo e-mail.
TeamInstrada la chiamata a un Team Aircall specifico utilizzando il relativo ID Team.
Numero AircallInstrada internamente la chiamata a un altro numero Aircall utilizzando il relativo ID numero.
Numero esternoInstrada esternamente la chiamata a un numero di telefono, che deve essere in formato internazionale E.164.
Destinazione dinamica (ID)Consente all'API esterna di specificare dinamicamente sia il tipo di destinazione sia l'ID della destinazione.

Quando utilizzi Destinazione dinamica (ID), devi definire due percorsi JSON nel widget:

  • Percorso del tipo di destinazione (user, team, number o external)
  • Percorso del valore della destinazione (l'ID univoco della destinazione)
Nota: Per le risposte Destinazione dinamica, il widget accetta solo i seguenti valori per il tipo di destinazione: agent, team, internal ed external.

Se la destinazione individuata è un Team, si applicano le regole di squillo standard. Se è un Utente o un numero, tali regole non si applicano.

Qualsiasi logica avanzata (ad esempio instradamento condizionale o assegnazione di priorità) deve essere elaborata nel sistema esterno prima di restituire la risposta API.

Passaggi di configurazione

Il widget determina se chiamare un Utente, un Team, un Numero Aircall, un Numero esterno o una Destinazione dinamica (ID) in base alla chiamata API configurata.

Passaggi:

  1. Nell'editor di Smartflows, aggiungi un widget Chiama (tramite API).
  2. Scegli il metodo HTTP (GET o POST), a seconda della sezione dell'API che desideri utilizzare.
    • Esempio: quando utilizzi l'endpoint Cerca chiamate dell'API Aircall, seleziona GET.

  3. Inserisci l'URL dell'API, ad esempio:

    https://api.aircall.io/v1/calls/search?order=desc&phone_number={{callerNumber}}

    Questa operazione cerca le chiamate più recenti associate al numero di telefono del chiamante.

  4. Utilizza variabili come callerNumber, targetNumber o callUUID per inserire dinamicamente nella richiesta dati specifici della chiamata. Consulta la documentazione dell'API Aircall per l'elenco completo dei parametri di query.

Configurazione della risposta

Nella sezione Configurazione della risposta, definisci come verrà analizzata la risposta API per determinare la destinazione dell'instradamento.

Tipi di risposta supportati:

  • Utente (ID o e-mail)
  • Team (ID)
  • Numero Aircall (interno)
  • Numero esterno (formato E.164)
  • Destinazione dinamica (ID)

Esempio di percorso JSON:

calls[0].user.id

Questo percorso fa riferimento al primo elemento nell'array “calls” e recupera l'ID dell'utente.

Esempio di risposta JSON della destinazione dinamica:

{
  "calls": [
    {
      "target_type": "team",
      "target_id": 12345
    }
  ]
}
  • Percorso del tipo di destinazione: calls[0].target_type
  • Percorso del valore di destinazione: calls[0].target_id

Se il tipo di destinazione è Team, le regole di squillo verranno applicate di conseguenza.

Testare la configurazione

Utilizza il campo Test della risposta per simulare le richieste API e verificare che i percorsi configurati restituiscano i valori corretti.

Esempio di input di test:

{
  "callerNumber": "+15551234567",
  "targetNumber": "+15557654321",
  "callUUID": "abcd-1234-efgh-5678",
  "lineId": 12345
}

Ogni chiave nel JSON corrisponde a una variabile utilizzata nell'URL o nel corpo della richiesta. Quando esegui il test, il widget sostituisce queste variabili e visualizza i risultati analizzati.

Se si verifica un errore, consulta la sezione Errori nella documentazione dell'API Aircall per indicazioni sulla risoluzione dei problemi.

Impostazioni dello squillo

Dopo aver configurato e testato l'integrazione API, modifica le Impostazioni dello squillo per definire come vengono distribuite le chiamate. Queste impostazioni funzionano come quelle del widget standard Squilla a.

Per maggiori dettagli, consulta il nostro articolo del Centro assistenza Panoramica dell'Instradamento di Smartflows.

Suggerimento: Se ti interessa 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.