Configura l'instradamento intelligente verso il proprietario del contatto HubSpot su un numero di telefono Aircall condiviso per garantire che i chiamanti vengano messi in contatto in modo efficiente con il loro referente dedicato.

Nota: Il video tutorial potrebbe mostrare la versione precedente della sezione Verifica risposta. Fai sempre riferimento ai passaggi scritti in questo articolo per le indicazioni più aggiornate.

In questa guida imparerai:

  • In che modo l'utilizzo del widget Chiama (tramite API) migliora l'efficienza e l'Esperienza del cliente

  • Come configurare l'instradamento intelligente verso il proprietario del contatto HubSpot

    • Primo passaggio: creare campi personalizzati in HubSpot e generare un bearer token

    • Secondo passaggio: configurare il widget Chiama (tramite API) in Smartflows

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

In che modo l'utilizzo del widget Chiama (tramite API) migliora l'efficienza e l'Esperienza del cliente

L'instradamento intelligente su un numero di telefono condiviso offre importanti vantaggi in termini di efficienza, precisione ed Esperienza del cliente. Indirizzando in modo intelligente le chiamate in entrata in base ai dati del CRM, l'instradamento intelligente garantisce che ogni chiamante raggiunga rapidamente la persona giusta, riducendo i tempi di attesa e migliorando i tassi di risoluzione alla prima chiamata.

Utilizzando il widget Chiama (tramite API) di Aircall in Smartflows, un'implementazione comune indirizza i chiamanti in entrata direttamente al loro proprietario del contatto HubSpot. In questo modo si evita che l'intero Team venga interrotto da chiamate non destinate ai suoi membri e non è più necessario mettere in attesa i chiamanti durante il trasferimento al loro referente dedicato.

Come configurare l'instradamento intelligente verso il proprietario del contatto HubSpot

Primo passaggio: crea proprietà personalizzate in HubSpot e genera un bearer token

Importante: Questo passaggio richiede familiarità con i campi personalizzati di HubSpot e le app private di HubSpot.

Inizia in HubSpot creando una proprietà personalizzata per memorizzare l'indirizzo e-mail del proprietario del contatto.

Passaggi

  1. Vai a Proprietà dei contatti nelle Impostazioni di HubSpot.

  2. Seleziona Crea proprietà.

  3. Completa i dettagli della proprietà come segue:

ImpostazioneValore
Tipo di oggettoContatto
EtichettaE-mail del proprietario del contatto Aircall
Nome interno/APIaircall_contact_owner_email
Tipo di campoTesto su una sola riga
Nota: Configura la sezione Regole come desideri, ma assicurati che i caratteri speciali non siano limitati, poiché gli indirizzi e-mail includono caratteri come @ e .
  1. Puoi quindi creare un Flusso di lavoro HubSpot per compilare automaticamente questo campo:

  • Iscrivi tutti i nuovi contatti al momento della creazione.

  • Per includere i contatti esistenti, seleziona Sì, iscrivi i contatti esistenti che soddisfano attualmente i criteri di attivazione nel passaggio Rivedi e pubblica della configurazione del Flusso di lavoro.

  1. Una volta creata la proprietà, compilala con un indirizzo e-mail. Questo valore ti servirà in seguito per verificare la validità del percorso all'interno del widget Chiama (tramite API).

Screenshot 2024-02-23 at 6.08.57 pm.png
  1. Successivamente, genera un token bearer nel tuo portale per sviluppatori HubSpot. Questo token autenticherà la richiesta API durante la configurazione del widget Chiama (tramite API) in Smartflows. Per istruzioni dettagliate, consulta la guida di HubSpot alle app private.

Passaggio 2: configurare il widget Chiama (tramite API) in Aircall Smartflows

Importante: Questa sezione richiede familiarità con l'API REST di HubSpot, JSON e Smartflows.
  1. Vai a Dashboard Aircall > Numeri e apri il numero Smartflows da configurare.

    • È importante notare che gli Utenti Aircall a cui verranno instradate le chiamate tramite l'API non devono necessariamente essere assegnati alla Distribuzione delle chiamate di Smartflows. Se sono assegnati, quando non rispondono alla chiamata trasferita riceveranno le notifiche delle Chiamate perse nella loro Lista delle cose da fare. Tuttavia, non riceveranno queste notifiche se non sono assegnati al numero.

  2. Vai al numero di telefono su cui desideri configurare il widget Chiama (tramite API). Aggiungi il widget Chiama (tramite API) nel punto desiderato della distribuzione Smartflows per aprire l'editor del widget.

  3. Imposta Metodo di autenticazione su Token bearer, quindi fai clic su Imposta credenziali. Nel modulo a comparsa delle credenziali, incolla il token bearer creato nel passaggio precedente.

Screenshot 2025-10-23 at 17.55.19.png
  1. Torna all'editor del widget e completa la configurazione della richiesta:

  • URL: https://api.hubapi.com/crm/v3/objects/contacts/search

  • Metodo: POST

  • Corpo:

    {
      "properties": [
        "firstname",
        "lastname",
        "company",
        "email",
        "hubspot_owner_id",
        "aircall_contact_owner_email",
        "hs_calculated_phone_number",
        "hs_calculated_mobile_number",
        "hs_searchable_calculated_phone_number",
        "hs_searchable_calculated_mobile_number",
        "last_used_aircall_phone_number"
      ],
      "filterGroups": [
        {
          "filters": [
            {
              "propertyName": "hs_calculated_mobile_number",
              "operator": "EQ",
              "value": "{{callerNumber}}"
            }
          ]
        },
        {
          "filters": [
            {
              "propertyName": "hs_calculated_phone_number",
              "operator": "EQ",
              "value": "{{callerNumber}}"
            }
          ]
        }
      ],
      "sorts": [
        {
          "propertyName": "lastmodifieddate",
          "direction": "DESCENDING"
        }
      ],
      "limit": 10
    }
  1. Imposta la configurazione della risposta:

  • Tipo di risposta = User (ID or email)
  • Percorso = results[0].properties.aircall_contact_owner_email
  1. Esegui un test nel campo dedicato Testa risposta:

  • Inserisci un numero di telefono valido nel formato internazionale E.164.

  • Verifica che venga restituito un payload JSON.

  • Verifica che il Percorso sia valido per trovare il valore utilizzato per trasferire o instradare la chiamata in entrata.

  • Verifica che l'indirizzo email del contatto esistente corrisponda all'indirizzo email di un Utente esistente in Aircall.

Screenshot 2025-09-16 at 7.08.50 PM.png
Suggerimento: Regola le impostazioni di squillo direttamente sotto il test in base alle esigenze operative della tua azienda.

Ora puoi iniziare a testare le chiamate in entrata per l'Instradamento intelligente verso il Proprietario del contatto HubSpot utilizzando il widget Chiama (tramite API).

Spunti di riflessione

  • Aggiungere un Team sotto il widget Chiama (tramite API) può essere utile per il flusso. Funge esclusivamente da soluzione di riserva nei casi in cui il Proprietario del contatto non è Disponibile, assicurando che nessuna chiamata venga persa.

  • Puoi impostare questa configurazione con altri oggetti HubSpot, come il Proprietario dell'azienda o il Proprietario della trattativa.

  • Ricorda che Aircall può instradare le chiamate in entrata utilizzando il widget Chiama (tramite API) solo con una logica semplice (ovvero senza ramificazioni basate su condizioni, cicli e così via). In altre parole, deve essere presente una delle seguenti opzioni:

    • Nel profilo dell'oggetto HubSpot (ad esempio, contatto, azienda e così via)

    • In un oggetto HubSpot correlato accessibile indirettamente (ad esempio, Utente) dall'oggetto HubSpot principale (ad esempio, contatto, azienda e così via)

  • I valori verso cui effettui l'instradamento devono esistere prima di configurare il widget Chiama (tramite API).

Se hai bisogno di ulteriore assistenza per implementare questa configurazione di Instradamento intelligente o desideri scoprire Automazioni simili per migliorare le tue operazioni, contatta il Team Successo del cliente.