Configurare l'instradamento intelligente verso il proprietario del contatto HubSpot usando il widget Chiama (tramite API) in un flusso di chiamata

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 proprio referente dedicato.

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

In questa guida scoprirai:

• In che modo l'uso 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 token bearer

  • Secondo passaggio: configurare il widget Chiama (tramite API) nell'editor di flussi

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'uso 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.

Un'implementazione comune che utilizza il widget Chiama (tramite API) di Aircall in un flusso di chiamata indirizza i chiamanti in entrata direttamente al rispettivo 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 i chiamanti in attesa mentre vengono trasferiti al proprio referente dedicato.

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

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

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

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

Passaggi

1. Nelle impostazioni di HubSpot, vai a Proprietà dei contatti.

2. Seleziona Crea proprietà.

3. Completa i dettagli della proprietà come segue:

Nota: Configura la sezione Regole come preferisci, ma assicurati che i caratteri speciali non siano limitati, poiché gli indirizzi e-mail includono caratteri come @ e .

4. Puoi quindi creare un flusso di lavoro HubSpot per compilare automaticamente questo campo:

• Registra tutti i nuovi contatti al momento della creazione.

• Per includere i contatti esistenti, seleziona Sì, registra i contatti esistenti che al momento soddisfano i criteri di attivazione nel passaggio Rivedi e pubblica della configurazione del flusso di lavoro.

5. Dopo aver creato la proprietà, compilala con un indirizzo e-mail. Avrai bisogno di questo valore in seguito per verificare la validità del percorso nel widget Chiama (tramite API).

6. 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) nell'editor di flussi. Per istruzioni dettagliate, consulta la guida di HubSpot alle app private.

Passaggio 2: configura il widget Chiama (tramite API) nell'editor di flussi

Importante: Questa sezione richiede familiarità con l'API REST di HubSpot, JSON e i flussi di chiamata.

1. Vai a Dashboard Aircall > Numeri e apri il numero con il flusso di chiamata da configurare.

   • È importante notare che gli utenti Aircall ai quali verranno instradate le chiamate tramite l'API non devono necessariamente essere assegnati alla configurazione del flusso di chiamata. 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 per il quale desideri configurare il widget Chiama (tramite API). Aggiungi il widget Chiama (tramite API) nel punto desiderato della configurazione del flusso di chiamata 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.

4. Torna all'editor del widget e completa la configurazione della richiesta:

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

• Metodo: POST

• Corpo:

  Copia

  {
    "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
  }

5. Imposta la configurazione della risposta:

• Tipo di risposta = Utente (ID o e-mail)
• Percorso = results[0].properties.aircall_contact_owner_email

6. 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 e-mail del contatto esistente corrisponda all'indirizzo e-mail di un utente esistente in Aircall.

Suggerimento: Modifica le impostazioni dello squillo direttamente sotto il test per adattarle alle attività aziendali.

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