Parametri dinamici

I parametri dinamici permettono all'agente di usare dati reali del contatto e del workflow invece di testo statico.

Usali quando greeting, prompt, descrizione function, input function o URL API devono usare valori del contatto o della chiamata corrente.

In RocketAiFlow, i valori dinamici arrivano di solito da due punti:

Mantieni chiara questa distinzione quando configuri le functions. Alcuni valori sono noti prima che la chiamata inizi; altri devono essere raccolti dall'agente durante la conversazione.

• Valori contatto/template: valori già salvati nel contatto outbound o nel contatto inbound trovato tramite Contatti inbound.
• Valori generati dall'LLM: valori che il modello estrae o crea durante la chiamata, come intento, orario callback, stato lead, note, città o risultato della qualificazione.

I contact template definiscono quali campi del contatto possono essere inseriti dinamicamente nei campi dell'agente.

Il template di default include i principali parametri di un contatto creato in RocketAiFlow:

Puoi modificare il template di default e aggiungere chiavi custom. Le chiavi custom vengono renderizzate da data. Per esempio, se aggiungi una chiave chiamata birthDate, la variabile diventa {t.data.birthDate}.

Crea template diversi in base alle variabili custom che vuoi caricare nei contatti. Per esempio, se un workflow usa externalId e un altro usa data.birthDate o data.policyNumber, aggiungi quelle chiavi nel template corretto così saranno disponibili come variabili selezionabili quando crei o modifichi un agente.

Questo riduce gli errori di typing: invece di scrivere manualmente i nomi delle variabili, usa i suggerimenti mostrati dalla UI.

• {t.CampaignId}
• {t.ContactId}
• {t.id}
• {t.name}
• {t.phone}
• {t.priority}
• {t.surname}
• {t.totalGlobal}

Una variabile viene sostituita solo quando il valore corrispondente esiste nel contatto usato per quella chiamata.

Se il valore non esiste, la variabile non viene renderizzata. Prima di usare variabili custom, assicurati che i dati del contatto contengano le key-value attese.

• Outbound: le variabili vengono renderizzate dal contatto caricato nella campagna. I campi custom devono essere dentro l'oggetto data del contatto.
• Inbound: le variabili vengono renderizzate solo se negli Agent settings è abilitato il recupero del contatto e Contatti inbound contiene una lista con un numero che corrisponde al chiamante.
• Nei campi che supportano le variabili, digita @ per aprire i suggerimenti oppure clicca le variabili mostrate sotto il campo.
• Per preparare i contatti, vedi Importa contatti.

I valori dinamici sono utili quando una function deve chiamare l'endpoint API corretto o passare il contesto giusto senza creare valori statici per ogni contatto.

Esempio: se una function custom PUT aggiorna un contatto nel tuo CRM e l'id CRM è salvato nel contatto come externalId, puoi usare quel valore nella URL API, per esempio https://crm.example.com/contacts/{t.externalId}.

RocketAiFlow renderizza l'id dal contatto attivo. L'LLM può generare solo i valori da aggiornare, come stato, note o risultato della qualificazione.

• usa valori contatto/template per dati già noti come phone, name, CRM id, campaign id, piano, filiale o campi custom del contatto
• usa valori generati dall'LLM per informazioni scoperte durante la chiamata
• usa valori template nelle descrizioni delle functions quando l'LLM ha bisogno di contesto
• usa valori template nelle URL API quando l'endpoint esterno ha bisogno di un identificativo specifico del contatto

I parametri dinamici sono utili quando rendono il workflow più preciso. Non sono utili quando rendono la function difficile da leggere o da debuggare.

• passa solo i valori richiesti dall'azione
• dai nomi chiari alle chiavi custom dentro data
• documenta da dove arriva ogni valore
• testa prima un contatto e un solo percorso di workflow
• non dipendere da una chiave custom finché non hai verificato che esista nei dati del contatto