Creazione di un Agente vocale IA per la qualificazione dei lead in uscita con le azioni IA di HubSpot

Configura un Agente vocale IA in uscita che qualifica i lead creati in HubSpot e li aggiorna automaticamente utilizzando le azioni IA di HubSpot. Questo articolo illustra come creare l'agente, collegarlo a HubSpot e creare il flusso di lavoro che attiva la chiamata in uscita.

Nota: In questo articolo utilizzeremo un esempio basato su ACME, un'azienda SaaS con un modulo per lead in entrata sul proprio sito web, gestito da HubSpot. Anziché chiamare e qualificare manualmente ogni nuovo lead, ACME vuole che un Agente vocale IA lo faccia automaticamente. Gli account più strategici vengono trasferiti in tempo reale agli addetti alle vendite, mentre gli account più piccoli vengono qualificati dall'agente e registrati affinché il Team di vendita possa ricontattarli. L'agente recupera inoltre il record Contatto HubSpot del lead e aggiorna il campo della fase del ciclo di vita per indicare che la qualificazione è stata completata.

Implementando questa configurazione, puoi qualificare i lead non appena arrivano, assicurandoti che quelli più promettenti raggiungano più rapidamente gli addetti alle vendite quando il loro interesse è ancora vivo. In questo modo acceleri il ciclo di vendita, migliori i tassi di conversione da lead a demo e mantieni la pipeline più ordinata, escludendo i lead non qualificati prima che raggiungano gli addetti alle vendite e consentendo al Team di concentrarsi sulla vendita anziché sulla ricerca e sulla qualificazione manuale di ogni lead in entrata.

Come funziona

Questa configurazione può essere adattata praticamente a qualsiasi scenario, ma ecco come si presenta un tipico flusso delle chiamate nell'esempio di ACME:

1. Un nuovo lead invia un modulo sul sito web, gestito da HubSpot, creando un record Contatto.
2. L'invio del modulo attiva un flusso di lavoro HubSpot, registrando il record Contatto e avviando una chiamata in uscita tramite l'Agente vocale IA.
3. L'agente si mette in contatto con il lead, attiva l'azione Recupera contatto per recuperare il record Contatto e inizia la qualificazione, facendo riferimento ai campi del contatto come contesto {{variable}} durante tutta la conversazione, incluso il numero di licenze richieste dal lead.
4. Se il lead ha 15 o più Utenti, l'agente attiva l'azione Aggiorna contatto per aggiornare la proprietà della fase del ciclo di vita, quindi trasferisce immediatamente la chiamata a un addetto alle vendite.
5. Se il lead ha 14 Utenti o meno, l'agente attiva l'azione Aggiorna contatto per aggiornare la proprietà della fase del ciclo di vita, quindi informa l'interlocutore che il Team di vendita lo contatterà a breve prima di terminare cortesemente la chiamata.

Prima di iniziare

Questa guida presuppone che siano già presenti i seguenti elementi:

• Un account HubSpot attivo con un modulo web per l'acquisizione dei lead.
• L'invio del modulo attiva la creazione di un record Contatto in HubSpot e compila i campi standard firstname, lastname, phone ed email nell'oggetto Contatto.
• La proprietà della fase del ciclo di vita esiste nell'oggetto Contatto e può essere aggiornata tramite l'azione IA Aggiorna contatto.
• Un'Integrazione HubSpot attiva nel Dashboard di Aircall.
• Il campo contact_phone deve essere in formato E.164 (ad esempio, +14155551234).

Passaggio 1: crea la chiave API di Aircall e il token Basic Auth

Prima di creare l'Agente vocale IA, genera una chiave API in Aircall. Il flusso di lavoro di HubSpot la utilizzerà per autenticare la richiesta quando attiva la chiamata in uscita. Poiché HubSpot richiede le credenziali sotto forma di token Basic Auth anziché come coppia di ID API e token non elaborati, dovrai prima combinarli e codificarli.

Passaggi

1. Nel Dashboard di Aircall, vai a Integrazioni > Chiavi API dal menu di navigazione a sinistra.
2. Fai clic su Genera una chiave API e assegna un nome alla nuova chiave.
3. Copia l'ID API e il token API e combinali in un'unica stringa: API_ID:API_Token (senza spazi, utilizzando i due punti come separatore).

4. Codifica il risultato in Base64 utilizzando uno dei seguenti metodi:

   Strumento del browser: incolla la stringa combinata in uno strumento di codifica Base64.

   Terminale (macOS/Linux):

   Copia

   echo -n "YOUR_API_ID:YOUR_API_TOKEN" | base64

   Windows PowerShell:

   Copia

   [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes("YOUR_API_ID:YOUR_API_TOKEN"))

5. Il risultato è una stringa simile a YWJjMTIzOnRlc38ge8tlbg==. Copiala e conservala in un luogo sicuro: ti servirà nel passaggio 5.

Passaggio 2: attiva le azioni IA

Abilita le azioni IA nell'Integrazione HubSpot specifica a cui vuoi collegare l'Agente vocale IA. Nell'esempio di ACME, ciò significa abilitare Recupera contatto e Aggiorna contatto.

Passaggi

1. Torna alla pagina iniziale dell'API nel Dashboard di Aircall.
2. Trova e seleziona l'Integrazione HubSpot esistente.
3. Fai clic sulla scheda Azioni IA nella barra di navigazione superiore.
4. Abilita Aggiorna contatto e Recupera contatto in Agente vocale IA.

Passaggio 3: crea e configura l'Agente vocale IA

Crea l'agente.

Passaggi

1. Dal menu di navigazione a sinistra, vai a Agenti IA > Agenti vocali IA.
2. Fai clic su Crea un Agente vocale IA e seleziona In uscita.

Una volta creato, l'agente deve essere configurato. Le sezioni seguenti rispettano l'ordine in cui appaiono nel menu di navigazione a sinistra dell'editor dell'agente IA e spiegano il ruolo di ciascuna nel caso d'uso di ACME.

Per ulteriore assistenza con questi passaggi di configurazione, consulta Configurazione dell'Agente vocale IA.

Assegnazione dei numeri, Profilo dell'agente e Informazioni sull'azienda

• Assegnazione dei numeri: il numero di telefono da cui l'agente effettuerà la chiamata quando viene attivato.
• Profilo dell'agente: definisce l'identità principale dell'agente.
• Informazioni sull'azienda: definisce il modo in cui l'agente fa riferimento alla tua azienda.

Base di conoscenza

La Base di conoscenza è il luogo in cui fornisci le informazioni che l'agente utilizza per rispondere alle domande del chiamante.

Suggerimento: Per questo caso d'uso, aggiungi una fonte di conoscenza concisa nel caso in cui il potenziale cliente abbia domande sulla tua azienda. Per ottenere prestazioni ottimali, non cercare di trattare ogni argomento: limitati alle domande più frequenti sugli argomenti più rilevanti in questa fase del ciclo di vendita. Sovraccaricare la Base di conoscenza può rallentare le risposte e ridurne l'accuratezza.

Script della chiamata: messaggi di benvenuto e commiato

I messaggi di benvenuto e commiato definiscono ciò che i chiamanti sentono all'inizio e alla fine di una chiamata.

L'agente può personalizzare il messaggio di benvenuto utilizzando variabili dinamiche compilate dal record del contatto HubSpot. Tutti i dati raccolti dal modulo vengono associati a una proprietà corrispondente nel record del contatto, che si tratti di un campo standard come Nome o di una proprietà personalizzata creata da te. Qualsiasi proprietà può essere passata nel payload del contesto e richiamata nello script dell'agente come {{variable}} (ad esempio, associando il Nome alla proprietà firstname puoi utilizzare {{firstname}} nel messaggio di benvenuto: "Ciao {{firstname}}, ho visto il modulo che hai inviato...").

Per il caso d'uso di ACME, questo è il messaggio di benvenuto configurato:

Ciao {{firstname}}, sono Charlie, l'assistente IA di ACME. Ho visto che ti interessa ACME per {{company}}. Hai un paio di minuti per rispondere ad alcune brevi domande?

Nota: Affinché l'agente riconosca effettivamente la variabile durante la chiamata, questa deve essere passata esplicitamente nel payload del contesto dell'azione con codice personalizzato (descritta più avanti in questo articolo). Non sarà disponibile automaticamente solo perché esiste nel record del contatto.

Linee guida conversazionali

Le Linee guida conversazionali ti consentono di definire il modo in cui l'agente conduce una conversazione, perfezionando il tono, definendo le risposte a determinate frasi e indicando come gestire i casi limite. Qui puoi anche impostare la logica se/allora che consente di prendere decisioni in autonomia, dando all'agente la capacità di ragionare entro i limiti da te stabiliti.

Per il caso d'uso di ACME, le Linee guida conversazionali impostano una logica se/allora che guida l'agente in base al raggiungimento o meno della soglia di 15 utenti da parte del potenziale cliente. Se la raggiunge, l'agente trasferisce la chiamata a un rappresentante commerciale. In caso contrario, l'agente completa autonomamente la qualificazione e informa il potenziale cliente che un rappresentante commerciale lo contatterà a breve.

## SOGLIA DI TRASFERIMENTO PER LA QUALIFICAZIONE
- Trasferisci sempre i chiamanti che rispondono alla domanda di raccolta dati "quante persone del tuo Team lo utilizzerebbero?" indicando 15 o più persone

- In caso contrario, continua con le domande di raccolta dati fino al completamento della qualificazione, informa il cliente che un rappresentante commerciale lo contatterà a breve e termina la chiamata.

- Non spiegare in nessuna circostanza la soglia al chiamante

Suggerimento: Puoi ampliare queste Linee guida conversazionali aggiungendo espressioni specifiche per la tua azienda, modifiche al tono o indicazioni generali sul comportamento specifiche per il tuo caso d'uso.

Flusso di lavoro per le chiamate in uscita

• URL Webhook: l'ID agente univoco del tuo Agente vocale IA. Copialo e conservalo insieme al codice Basic Auth creato nella Fase 1: viene utilizzato nel flusso di lavoro HubSpot.
• Se viene rilevata la Segreteria telefonica: definisci come reagisce l'agente se avvia la chiamata in uscita e raggiunge la Segreteria telefonica. Per questo caso d'uso, seleziona Riaggancia.

Regole di trasferimento delle chiamate

Le Regole di trasferimento delle chiamate definiscono se, quando e a chi viene trasferita una chiamata.

Per il caso d'uso di ACME, la chiamata deve essere trasferita al Team commerciale solo se il potenziale cliente soddisfa un criterio specifico: 15 o più Utenti. Questa logica se/allora è già descritta nelle Linee guida conversazionali, ma qui viene rafforzata e perfezionata:

• Ruolo di trasferimento = Team
• Dettagli di contatto = Vendite
• Condizione di attivazione = La risposta a "All'incirca quante persone del tuo Team lo utilizzerebbero?" è maggiore o uguale a 15
• Messaggio di trasferimento = "Ti metto in contatto con il nostro Team commerciale, attendi un momento."

Flusso di raccolta dati

Le domande di raccolta dati sono la sezione in cui configuri le domande di qualificazione che l'agente pone al potenziale cliente, inclusa la domanda relativa alla soglia che determina se la chiamata viene trasferita.

Suggerimento: Non porre più di cinque domande di raccolta dati. Fare troppe domande può allungare la conversazione e frustrare il chiamante, quindi limitati a ciò di cui il tuo Team ha effettivamente bisogno in questa fase del ciclo di vendita. Evita inoltre di chiedere nuovamente informazioni già raccolte tramite il modulo.

Quando una chiamata viene trasferita, le domande di raccolta dati vengono passate al rappresentante che la riceve per fornirgli il contesto e, al termine della chiamata, vengono registrate in formato strutturato nel registro della chiamata in HubSpot e Aircall Workspace.

Per il caso d'uso di ACME, le domande di raccolta dati sono:

• Qual è il problema principale che speri di risolvere con uno strumento come questo?
• Hai in mente una tempistica approssimativa per prendere una decisione?
• Saresti tu a prendere la decisione finale oppure sono coinvolte altre persone?
• All'incirca quante persone del tuo Team lo utilizzerebbero?

Azioni IA

Aggiungi le azioni IA al tuo Agente vocale IA.

Passaggi

1. Vai ad Azioni IA nel menu di navigazione a sinistra dell'agente IA.
2. Fai clic su Aggiungi azione.
3. Nel pannello laterale, apri l'elenco a discesa e seleziona HubSpot > Ottieni contatto. Fai clic su Salva azione. Ripeti la stessa procedura per HubSpot > Aggiorna contatto.

Linee guida conversazionali per le azioni IA

Qui puoi definire quando l'agente deve utilizzare ogni azione e cosa dire o fare in seguito.

Per il caso d'uso di ACME, Ottieni contatto recupera il contatto creato tramite l'invio del modulo, mentre Aggiorna contatto aggiorna la proprietà della fase del ciclo di vita. Poiché questa chiamata rappresenta la qualificazione del lead, ACME aggiorna la fase del ciclo di vita a Lead qualificato per le vendite (valore interno: salesqualifiedlead). Il valore da impostare dipende dall'utilizzo di fasi del ciclo di vita standard o personalizzate e dal punto del ciclo di vendita rappresentato da questa chiamata. Assicurati di sostituire salesqualifiedlead con il valore pertinente al tuo caso d'uso.

##Ottieni contatto
- Quando il chiamante conferma che è possibile porgli delle domande, usa "Ottieni contatto" con il numero {{phone}} del chiamante dal contesto

- Chiedi "Solo per conferma, {{phone}} è il numero di telefono che abbiamo registrato per te?" e verifica se la risposta è sì o no. Leggilo nel formato E164

- Se SÌ, l'identità è confermata. Memorizza il contactId per utilizzarlo nelle azioni successive e passa alle domande di raccolta dati.

- Se NO, chiedi al chiamante il suo indirizzo email e riprova con "Ottieni contatto". Se il record viene trovato, l'identità è confermata. Memorizza il contactId per utilizzarlo nelle azioni successive e passa alle domande di raccolta dati.

- Se non è ancora possibile recuperare il record del contatto, scusati e comunica al chiamante: "Non riesco a recuperare il tuo record di contatto nel nostro sistema. Qualcuno del nostro Team di vendita ti contatterà il prima possibile utilizzando le informazioni che hai fornito nel modulo", quindi termina la chiamata.

##Aggiorna contatto
- Quando il chiamante ha risposto alla domanda di qualificazione (Numero di utenti), usa "Aggiorna contatto" con il contactId memorizzato in precedenza per aggiornare lifecyclestage a "salesqualifiedlead".

- Aggiorna contatto deve sempre essere eseguita prima che la chiamata venga instradata verso un trasferimento o una chiusura, in modo che la fase del ciclo di vita venga aggiornata indipendentemente dall'esito.

Passaggio 4: testa il tuo agente per la qualificazione dei lead

Una volta configurato tutto e prima di procedere alla configurazione di HubSpot, testa accuratamente l'agente utilizzando il pannello Chiamata di prova sul lato destro dell'editor dell'agente. Questo simula l'esperienza di una chiamata reale senza inviare alcuna attività di chiamata al tuo Team né attivare attività in HubSpot.

Esegui tre scenari per verificare che l'agente si comporti come previsto:

• Percorso ideale: chiama come lead con 15 o più Utenti e verifica che l'agente ti trasferisca a un rappresentante commerciale (il trasferimento non avverrà realmente, poiché si tratta di una chiamata simulata). Quindi chiama come lead con meno di 15 Utenti e verifica che l'agente completi autonomamente la qualificazione e ti comunichi che un rappresentante commerciale ti contatterà.
• Percorso ambiguo: fornisci una risposta vaga o incerta quando ti viene chiesto il Numero di utenti (ad esempio, "non ne sono ancora sicuro") e osserva come l'agente gestisce l'ambiguità, se pone una domanda di chiarimento o fa un'ipotesi.
• Percorso problematico: metti alla prova l'agente con condizioni difficili, ad esempio interrompendolo a metà risposta, fornendo risposte contraddittorie sul Numero di utenti o chiedendogli di fare qualcosa che non rientra nel suo ambito (ad esempio, "prenotami comunque una demo"). Verifica che gestisca queste situazioni in modo appropriato anziché fornire informazioni errate.

Se riscontri risultati imprevisti, identifica il problema, apporta le modifiche necessarie e ripeti il test finché non sei certo che l'agente sia pronto a qualificare i lead.

Passaggio 5: crea il Flusso di lavoro HubSpot e l'azione di codice personalizzato

Quindi, configura HubSpot creando un Flusso di lavoro che attivi la chiamata in uscita dell'Agente vocale IA.

Passaggi

1. In HubSpot, vai ad Automazione > Flussi di lavoro.
2. Fai clic su Crea Flusso di lavoro > Da zero.

Attivazione dell'iscrizione

Per l'attivazione dell'iscrizione, usa due opzioni: l'iscrizione manuale, un pratico strumento di test che consente di eseguire il Flusso di lavoro senza inviare ogni volta il modulo lead effettivo, e la condizione reale che i potenziali clienti soddisferanno, ovvero l'invio del modulo lead specifico.

Passaggi

1. Nell'attivazione dell'iscrizione, seleziona Attiva manualmente > Contatto > Salva e continua.
2. Fai nuovamente clic sull'attivazione dell'iscrizione e, sotto OPPURE, seleziona Quando si verifica un evento.
3. In Aggiungi criteri, cerca e seleziona Invio del modulo.
4. L'invio del modulo è stato completato un numero qualsiasi di volte in qualsiasi momento verrà aggiunto per impostazione predefinita.
5. Fai clic su + Aggiungi criteri e seleziona Nome del modulo.
6. Imposta Nome del modulo = è uno qualsiasi di = [il tuo modulo di acquisizione lead].
7. Fai clic su Salva.

Nuova iscrizione

Nota: Mantieni disattivata la nuova iscrizione per questo Flusso di lavoro, poiché ogni lead deve essere qualificato una sola volta per ogni invio del modulo. Attivandola, potrebbero essere effettuate chiamate in uscita duplicate se qualcuno invia il modulo più di una volta. Se desideri gestire le chiamate senza risposta, Aircall registra l'esito della chiamata in HubSpot; valuta quindi la possibilità di creare un Flusso di lavoro di follow-up separato che utilizzi questa informazione per riattivare la chiamata dopo un intervallo, anziché affidarti alla nuova iscrizione in questo punto.

Azione di codice personalizzato

Passaggi

1. Sotto il trigger di iscrizione, fai clic su + per aggiungere un'azione.
2. Cerca Codice personalizzato e selezionalo.
3. Scegli Node.js 18.x come linguaggio.
4. In Segreti, fai clic su Scegli un segreto > Aggiungi nuovo segreto.
5. Nome del segreto: AIRCALL_BASIC_AUTH (assicurati che non contenga spazi).
6. Valore del segreto: incolla la stringa Base64 del Passaggio 1.
7. Salva il segreto e torna all'azione.
8. Una volta tornato nell'azione, seleziona AIRCALL_BASIC_AUTH dal menu a discesa: verrà visualizzato come chip.

Proprietà da includere nel codice

Fai clic su Aggiungi proprietà per ogni campo necessario all'Agente vocale IA per qualificare il contatto e personalizzare la chiamata. Per ciascuno, seleziona la proprietà HubSpot da cui recuperare i dati e assegnale un nome di variabile, ossia il nome che utilizzerai per fare riferimento a tale valore nel codice (ad esempio, event.inputFields['firstname']).

Qualsiasi {{variable}} già utilizzata nel saluto e nelle Linee guida conversazionali dell'agente deve essere inclusa qui con un nome di variabile corrispondente, altrimenti l'agente non potrà accedervi durante la chiamata.

Per il caso d'uso di qualificazione dei lead di ACME e per la maggior parte dei casi d'uso di qualificazione standard, mantieni questo elenco essenziale: all'agente serve solo il contesto sufficiente per personalizzare il saluto e confermare l'identità dell'interlocutore:

Nota: L'ID record (hs_object_id) è l'ID numerico interno di HubSpot per il record del contatto. Viene utilizzato come idempotency_key per evitare chiamate duplicate e come variabile di contesto hubspot_contact_id affinché le azioni Ottieni contatto e Aggiorna contatto dell'agente facciano riferimento al record corretto durante tutta la chiamata.

Incollare il codice

Seleziona tutto il contenuto dell'editor di codice e sostituiscilo con il modello seguente. Dopo averlo incollato, aggiorna i segnaposto seguenti:

const axios = require('axios');

exports.main = async (event, callback) => {
  // Pull contact fields from HubSpot
  const firstname     = event.inputFields['firstname'];
  const lastname      = event.inputFields['lastname'];
  const phone         = event.inputFields['phone'];
  const company       = event.inputFields['company'];
  const email         = event.inputFields['email'];
  const hs_contact_id = event.inputFields['hs_object_id'];

  // Auth and endpoint
  const basicAuth = process.env.AIRCALL_BASIC_AUTH;
  const agentUrl = 'https://api.aircall.io/v1/outbound-calls/agents/YOUR_AGENT_ID';

  try {
    const response = await axios.post(
      agentUrl,
      {
        contact_phone: phone,
        idempotency_key: `acme-qualification-${hs_contact_id}`, // unique per workflow + contact
        context: {
          firstname: firstname,
          lastname: lastname,
          company: company,
          email: email,
          hubspot_contact_id: String(hs_contact_id)
        },
        expiration_seconds: 600 // call attempt expires after 10 minutes if it can't connect
      },
      {
        headers: {
          Authorization: `Basic ${basicAuth}`,
          'Content-Type': 'application/json'
        }
      }
    );
    callback({ outputFields: { aircall_status: String(response.status), aircall_message: 'Call triggered successfully' } });
  } catch (error) {
    const status = error.response?.status || 500;
    const body = JSON.stringify(error.response?.data) || 'No response body';
    callback({ outputFields: { aircall_status: String(status), aircall_message: `Error: ${error.message} | ${body}` } });
  }
};

Importante: Le righe event.inputFields e context payload nel codice devono corrispondere ai campi delle variabili configurati in Proprietà da includere nel codice, che a loro volta devono corrispondere alle variabili utilizzate nel saluto e nelle Linee guida conversazionali dell'Agente vocale IA.

Output dei dati

In Output dei dati, aggiungi due output. Questi non influiscono sull'avvio della chiamata, ma vengono visualizzati nella cronologia del Flusso di lavoro di HubSpot per il debug.

• Nome dell'output = aircall_status. Tipo = stringa.
• Nome dell'output = aircall_message. Tipo = stringa.

Il Flusso di lavoro completato dovrebbe avere questo aspetto: 

Passaggio 6: testa l'azione del codice personalizzato e il Flusso di lavoro

Prima di attivare questo Flusso di lavoro per lead reali, testalo dall'inizio alla fine. Questo conferma tre aspetti: che HubSpot possa autenticarsi correttamente con Aircall, che la chiamata in uscita venga effettivamente avviata e che l'agente riceva il contesto corretto per gestire la conversazione come previsto. Eseguire subito il test su un contatto fittizio ti consente di individuare problemi di autenticazione, errori di formattazione o variabili non corrispondenti prima che influiscano su un potenziale cliente reale.

Passaggi

1. Nell'azione Codice personalizzato, fai clic su Test.
2. Seleziona il record di un contatto con un numero di telefono; per questo primo test, usa te stesso o un contatto interno fittizio, non un potenziale cliente reale.
3. Dopo l'esecuzione, controlla la sezione Output dei dati.
4. aircall_status = 200 indica che l'operazione è riuscita. L'agente chiamerà il numero di telefono del contatto di test ed eseguirà lo script.
5. Se lo stato non è 200, ecco gli errori più comuni e come correggerli prima del prossimo test:

Attivazione del flusso di lavoro

Una volta completato il test, fai clic su Rivedi e attiva. Quando ti viene chiesto "Vuoi registrare i contatti che attualmente soddisfano i criteri di registrazione?", seleziona No, registra solo i contatti che soddisfano i criteri di registrazione dopo l'attivazione del flusso di lavoro.

Il flusso di lavoro e l'Agente vocale IA sono ora attivi.

Best practice

• Mantieni la Base di conoscenza essenziale e incentrata sulle domande più pertinenti in questa fase del ciclo di vendita, anziché cercare di trattare ogni argomento.
• Limita le domande di raccolta dati a cinque o meno ed evita di chiedere nuovamente informazioni già acquisite nel modulo del lead.
• Mantieni disattivata la nuova registrazione, affinché ogni lead venga qualificato una sola volta per ogni invio del modulo.
• Testa l'Agente vocale IA utilizzando il pannello Chiamata di prova prima di passare alla configurazione di HubSpot, quindi testa l'intero flusso di lavoro HubSpot dall'inizio alla fine su un contatto fittizio prima di attivarlo per i lead reali.
• Assicurati che ogni {{variable}} utilizzata nel messaggio di benvenuto e nelle Linee guida conversazionali dell'agente sia configurata anche in Proprietà da includere nel codice, con nomi di variabile corrispondenti.
• Assicurati che idempotency_key includa sia il prefisso del flusso di lavoro sia l'ID record del contatto, per evitare Chiamate in uscita duplicate.

Domande frequenti

L'Agente vocale IA può aggiornare i record HubSpot senza trasferire la chiamata?

Sì. L'azione Aggiorna contatto viene eseguita prima che la chiamata si dirami verso un trasferimento o un commiato, quindi la fase del ciclo di vita viene aggiornata indipendentemente dall'esito.

Cosa succede se l'Agente vocale IA non riesce a confermare l'identità del chiamante?

Chiede l'indirizzo e-mail del chiamante e prova nuovamente a eseguire Ottieni contatto. Se non è ancora possibile recuperare il record del contatto, si scusa, informa il chiamante che un membro del Team di vendita lo ricontatterà utilizzando le informazioni contenute nel modulo e termina la chiamata.

Perché il numero di telefono deve essere in formato E.164?

Il campo contact_phone deve essere in formato E.164 (ad esempio, +14155551234) affinché la chiamata in uscita venga avviata correttamente. In caso contrario, il flusso di lavoro restituirà un errore 400 e dovrai normalizzare la proprietà del telefono in HubSpot.

Perché la nuova registrazione deve rimanere disattivata per questo flusso di lavoro?

L'attivazione della nuova registrazione potrebbe generare Chiamate in uscita duplicate se un lead invia il modulo più di una volta. Se devi gestire le chiamate senza risposta, utilizza un flusso di lavoro di follow-up separato basato sull'esito della chiamata registrato nuovamente in HubSpot, anziché affidarti alla nuova registrazione.

Cosa devo fare se voglio modificare il Numero di utenti necessario per il trasferimento alle vendite?

Aggiorna la condizione di attivazione sia nelle Linee guida conversazionali sia nelle Regole di trasferimento delle chiamate affinché rifletta la soglia desiderata, in modo che il comportamento dell'agente e la logica di trasferimento rimangano allineati.

Posso testare il flusso di lavoro senza inviare il modulo del lead effettivo?

Sì. Utilizza l'opzione di registrazione manuale nell'attivatore di registrazione: in questo modo puoi eseguire il flusso di lavoro senza inviare il modulo ogni volta che vuoi testarlo.