Usa i custom values del CRM nei prompt

I custom values del tuo CRM — le costanti per sub-account come nome dell'attività, indirizzo o dettagli dell'offerta — sono disponibili dentro ogni prompt agente come variabili {{cv_*}}. Scrivi il prompt una volta sola; ogni chiamata riempie i valori del cliente per cui sta effettivamente chiamando.

È questo che permette a un solo template agente di servire molti clienti: un agente "nicchia fisioterapia" può aprire con {{cv_business_name}} e citare {{cv_offer_details}} senza bisogno di un prompt separato per ogni cliente.

Come si risolvono i valori al momento della chiamata

Ogni chiamata — in uscita e in entrata — risolve i token {{cv_*}} dal sub-account di quella chiamata: il cliente a cui appartiene il lead. Le chiamate del cliente A prendono i valori del cliente A, quelle del cliente B i valori del cliente B.

Il sub-account di riferimento che scegli nell'editor non c'entra nulla in questo. È solo un aiuto in fase di progettazione: popola la palette delle variabili così puoi vedere quali variabili esistono e inserirle con un clic. Cambiare il riferimento non cambia mai ciò che dice una chiamata reale.

Due note pratiche:

• I valori vengono letti dal tuo CRM e messi brevemente in cache, quindi la modifica di un custom value nel CRM può impiegare fino a un'ora per arrivare alle chiamate live.
• La lettura è fail-open: se il tuo CRM non è raggiungibile al momento del dispatch, la chiamata parte comunque e le variabili non risolte restano vuote.

Inserire le variabili dall'editor

1. Apri l'agente (Agenti → agente → tab Prompt). Lo stesso pannello è disponibile nel form Nuovo agente, così puoi costruire il prompt attorno alle variabili fin dal primo giorno.
2. Nel pannello Variabili GHL, scegli un Sub-account di riferimento: — il selettore è ricercabile. I sub-account creati dallo stesso snapshot condividono le stesse variabili, quindi qualsiasi cliente di quello snapshot va bene come riferimento.
3. Caricate le variabili, la palette mostra un campo di ricerca e il conteggio di ciò che è disponibile. Uno snapshot porta facilmente decine di variabili, quindi non viene elencato nulla finché non scrivi: cerca per nome o per chiave (ad esempio budget o cv_business) e le variabili corrispondenti compaiono come chip, in due gruppi:
   • Custom values — i custom values del sub-account, risolti automaticamente a ogni chiamata.
   • Campi contatto — token per singolo lead, popolati dal workflow che fa scattare la chiamata.
4. Clicca una chip per inserire la variabile nel prompt alla posizione del cursore. Se la ricerca trova più di 30 risultati per gruppo, affinala per vedere gli altri.

Naming: cv_ più la chiave normalizzata

Ogni token è {{cv_<key>}}, dove <key> è la chiave del campo CRM normalizzata: minuscolo, ogni sequenza di caratteri che non sia lettera o cifra collassata in un singolo underscore, e il prefisso custom_values. rimosso.

Non devi mai costruirli a mano — la palette inserisce il token esatto.

Vincono i valori inviati dal trigger

Il webhook del workflow che fa partire una chiamata può inviare la propria mappa customValues (vedi Collega il workflow del CRM a un agente). Anche quei valori sono esposti come variabili cv_* e, in caso di collisione di nome, vince il valore del trigger su quello del sub-account. È anche così che i campi contatto (custom fields GHL) del singolo lead arrivano al prompt con il webhook generico: il workflow li mappa dentro customValues (es. "contact_budget": "{{contact.budget}}").

Con l'azione marketplace «Avvia ciclo di chiamate» non c'è nulla da mappare: i custom fields del contatto vengono recuperati automaticamente ed esposti con gli stessi token della palette (es. {{cv_contact_budget}}), poi salvati sul contatto come ogni altro valore del trigger.

I valori del trigger restano sul contatto

I customValues inviati da un trigger vengono salvati sul lead, non usati solo per quella chiamata. Si risolvono come le stesse variabili cv_* su ogni contatto successivo:

• i richiami automatici (cadenza di richiamo o richiamata programmata) viaggiano con l'intero set inviato dal trigger;
• le richiamate inbound — quando il lead richiama, l'agente che risponde ha lo stesso contesto cv_* per-contatto con cui aveva chiamato;
• un trigger successivo per lo stesso contatto aggiorna le chiavi che invia e conserva le altre (un aggiornamento parziale non cancella mai i valori precedenti).

Quindi ogni campo contatto che metti nel prompt dell'agente come token cv_* resta disponibile per quel contatto lungo tutto il ciclo di chiamate, in entrambe le direzioni.

Un template per nicchia

La configurazione tipica: un agente per nicchia, collegato a un workflow dello snapshot. Ogni cliente creato da quello snapshot condivide le stesse chiavi di custom value ma riempie i propri valori — quindi onboardare un nuovo cliente significa importare il sub-account e compilare i suoi custom values nel CRM. Nessuna modifica al prompt, nessun nuovo agente.

Prossimi passi

• Collega il workflow del CRM a un agente
• Scrittura dei dati sul CRM a fine chiamata
• Crea il tuo primo agente