Azioni

Conoscere chi chiama prima che inizi la chiamata

Cerca chi chiama nel tuo sistema prima che l'agente saluti.

Un Pre fetch interroga il tuo sistema su chi chiama mentre la chiamata si apre e passa la risposta all'agente prima della sua prima parola: così può salutare per nome un cliente che torna, vedere un ordine aperto o conoscere il livello di chi chiama.

Configurarlo

1. Aggiungi un Pre fetch

   Apri l'agente → Azioni → Aggiunga strumento e scegli Pre fetch in cima al menu.

2. Puntalo al tuo endpoint

   Campo	Cosa inserire
   Nome	Un nome breve, ad es. crm_lookup. È anche il nome del blocco che l'agente legge
   API URL	Il tuo endpoint, ad es. https://crm.example.com/lookup?phone={phone}
   Metodo HTTP	GET è il più adatto; funzionano anche POST, PUT, PATCH e DELETE
   Header	Facoltativi, ad es. la tua chiave API
   Parametri query	Facoltativi; un nuovo pre fetch parte con phone={phone}

3. Usa i segnaposto

   Vengono compilati a ogni chiamata, nell'URL, negli header e nei parametri:

   Segnaposto	Valore
   {phone}	Il numero di chi chiama; in una chiamata in uscita, il numero composto
   {direction}	inbound o outbound
   {agent_id}	L'ID dell'agente
   {user_id}	L'ID del proprietario dell'account
   {call_id}	L'ID della chiamata: abbinalo ai dati che ricevi dopo la chiamata

Cosa riceve l'agente

La tua risposta viene aggiunta alle istruzioni dell'agente come blocco con nome. Se il tuo endpoint restituisce { "name": "Sarah Johnson", "tier": "Gold", "open_orders": 1 }, l'agente lo legge prima del saluto. Nel prompt puoi indicare cosa farne, ad es. se il contesto della chiamata contiene il nome del cliente, salutalo per nome.

Limiti

• Solo telefonate: una chiamata web non ha un numero da cercare.
• Ogni richiesta ha 1,5 secondi, tutte insieme 2 secondi. Un endpoint lento o in errore non ritarda mai il saluto: l'agente parte senza quel blocco.
• Le risposte oltre 8 KB vengono troncate. Restituisci pochi campi, non l'intera scheda cliente.
• Un pre fetch viene eseguito sempre; non ha una condizione.

Casi d'uso

• Salutare per nome i clienti che tornano.
• Conoscere l'ordine aperto prima che chi chiama lo spieghi.
• Trattare diversamente i numeri VIP fin dalla prima frase.

Vedi anche

• Recuperare dati in tempo reale durante la chiamata — quando l'agente deve decidere durante la chiamata se cercare qualcosa
• Invia i dati della chiamata al tuo sistema — dopo la chiamata