Personalizzazione
Panoramica
La personalizzazione ti consente di adattare il comportamento del tuo agente a ogni singolo utente, permettendo conversazioni più naturali e contestualmente pertinenti. ElevenLabs offre diversi approcci alla personalizzazione:
- Variabili dinamiche - Inserisci valori di runtime nei prompt e nei messaggi
- Override - Sostituisci completamente i prompt di sistema o i messaggi
- Webhook di avvio della conversazione - Recupera questi dati dal tuo server quando inizia una conversazione
Metodi di personalizzazione
Struttura dei dati client per l’avvio della conversazione
L’oggetto conversation_initiation_client_data definisce cosa può essere personalizzato quando avvii una conversazione. I client possono inviarlo direttamente. Un webhook di avvio della conversazione restituisce lo stesso oggetto.
Ogni campo è facoltativo.
Le variabili dinamiche di sistema, ovvero quelle con prefisso system__, non possono essere inviate o sostituite nel
payload di avvio dal client. Puoi impostare solo variabili dinamiche personalizzate tramite il campo
dynamic_variables.
Informazioni sull’origine
source_info registra quale client ha avviato la conversazione. L’origine viene memorizzata nella conversazione e l’endpoint per elencare le conversazioni può filtrare in base a essa.
Gli SDK di ElevenLabs e il widget riportano l’origine automaticamente: js_sdk, react_sdk, react_native_sdk, python_sdk, swift_sdk, android_sdk, flutter_sdk e widget. Un client personalizzato può omettere source_info. Non usarlo per i tuoi metadati; usa invece dynamic_variables.
ElevenAgents imposta direttamente l’origine per telefonia, messaggistica, integrazioni, anteprime dei template ed esecuzioni di sub-agenti, ad esempio twilio, sip_trunk, whatsapp, zendesk_integration, template_preview e subagent_tool. La risposta di un webhook di avvio della conversazione non la modifica.
Webhook di avvio della conversazione
Per la telefonia e la messaggistica in entrata, ElevenAgents può recuperare questi dati di avvio dal tuo server anziché dal client. Quando il webhook è abilitato, ElevenAgents invia una richiesta POST e applica il JSON che restituisci.
Configura l’URL del webhook e i secret degli header nelle impostazioni degli agenti. Nella scheda Sicurezza dell’agente, abilita Recupera i dati client di avvio da un webhook e tutti i campi di override che la tua risposta potrebbe includere.
Il webhook viene eseguito per una nuova conversazione in entrata su Twilio Voice, Exotel, trunk SIP, WhatsApp o Twilio SMS quando i dati client di avvio non sono già presenti. Viene eseguito anche per le sessioni di Amazon Connect, in cui la tua risposta viene unita al contesto del contatto fornito da Amazon Connect.
Le chiamate in uscita con Twilio Voice, Exotel, SIP e WhatsApp lo attivano solo se la richiesta in uscita non include conversation_initiation_client_data. I messaggi WhatsApp in uscita non lo attivano mai: passa invece le variabili dinamiche nella richiesta in uscita.
Non viene eseguito per le conversazioni tramite widget o SDK, altre integrazioni di messaggistica o thread WhatsApp e SMS ripresi.
Le conversazioni di anteprima avviate dalla pagina delle impostazioni dell’agente non attivano i webhook di avvio della conversazione. Durante i test in Anteprima, usa i segnaposto delle Variabili dinamiche nell’editor dell’agente. Questi segnaposto non vengono usati nelle conversazioni in entrata in produzione.
ElevenAgents invia il contesto del chiamante nel body della richiesta:
caller_id e called_number sono numeri di telefono su Twilio, Exotel, SIP e SMS. Per WhatsApp in entrata sono l’ID utente WhatsApp e l’ID del tuo numero di telefono WhatsApp. Nelle chiamate in uscita, caller_id è il tuo numero e called_number è la persona chiamata. call_sid è il SID della chiamata del provider per la telefonia e una stringa vuota su WhatsApp, SMS e Amazon Connect. Le chiamate SIP possono includere anche call_id e sip_headers. Le sessioni Amazon Connect includono call_id impostato sull’ID del contatto.
La tua risposta deve usare la struttura conversation_initiation_client_data descritta sopra. Includi ogni variabile dinamica personalizzata definita dall’agente. Gli override sono facoltativi e devono essere abilitati in Sicurezza. Il body della risposta HTTP deve avere una dimensione massima di 256 KB (262.144 byte).
Un webhook non riuscito o scaduto può impedire l’avvio della conversazione. Per la configurazione di Twilio, consulta Personalizzazione di Twilio. Questo webhook è distinto dai webhook post-chiamata.