Engine Builder

Un engine è una conversazione progettata come un diagramma. Lo costruisci su una canvas partendo da pochi elementi, lo testi nel simulatore e poi lo pubblichi. Questa pagina illustra ogni parte del builder. Se sei alle prime armi, dai prima un'occhiata a Personas — ogni engine gira come una persona.

Concetti fondamentali

Alcune parole ricorrono ovunque nel builder. Impara queste e il resto viene da sé.

• Fase — uno stadio della conversazione. Una fase è un messaggio di apertura (come l'AI avvia quella fase) più un deck di card che può giocare mentre la conversazione è in quella fase. Un engine tipico ha alcune fasi: un'apertura a freddo, un riscaldamento, un invito.
• Deck — il set di card abbinate a una fase. A ogni turno l'engine gioca una card dal deck, scelta con un'estrazione casuale ponderata, così la stessa fase risulta ogni volta diversa.
• Card — una singola mossa: chattiamo, fai una domanda, invia una foto, lascia un link, chiudi. Ogni card ha le proprie impostazioni (vedi il riferimento alle card di seguito).
• Gate / transizione — una regola che sposta la conversazione da una fase all'altra, o attiva una reazione. Alcuni gate si trovano inline tra due fasi; altri fluttuano e osservano l'intera conversazione.
• Fact — un dettaglio che l'engine apprende sul lead (il nome, la città, gli interessi). I fact vengono estratti dalla chat man mano che avviene e possono essere inseriti nei messaggi tramite un tag.
• Punti di avvio — i nodi che indicano dove inizia una conversazione: l'AI scrive per prima, l'utente scrive per primo, o un evento esterno.
• Observer flottanti — gate non collegati tra due fasi specifiche. Osservano l'intera conversazione e si attivano ogni volta che la loro condizione è soddisfatta (ad esempio, appare un fact o il lead accetta un link).

La canvas

Il builder è una canvas zoomabile di nodi collegati da edge. Trascini i pezzi dal lato, aggiungi card alle fasi e tracci linee per collegare il flusso.

Palette dei nodi

• Avvio — i nodi di avvio conversazione (AI Opener, Inbound Chat, Event Trigger).
• Fasi — aggiunge un nuovo nodo fase alla canvas.
• Regole — i gate logici e gli observer che colleghi tra o intorno alle fasi.

Libreria card

La libreria card elenca ogni tipo di card. Trascina una card su una fase per aggiungerla al deck di quella fase. Lo stesso tipo di card può comparire in più fasi con impostazioni diverse.

Collegamento degli edge

Trascina dall'handle di uscita di un nodo a un altro nodo per creare un edge. Gli edge sono il modo in cui un punto di avvio raggiunge la sua prima fase e i gate fanno avanzare la chat.

Auto-arrange

I grafi collegati a mano diventano disordinati. Il pulsante Auto-arrange (la bacchetta, in alto a destra della canvas del flusso) ridispone l'intero grafo in un layout ordinato da sinistra a destra senza nodi sovrapposti, poi adatta la vista. Le nuove posizioni vengono salvate quando salvi l'engine. Eseguilo prima di finire qualsiasi engine.

Tipi di card

Le card sono le mosse che un engine può fare all'interno di una fase. Questi sono i tipi integrati, con i loro nomi nella libreria:

• Chat casuale (CHAT) — messaggio in forma libera. È l'unica card che rispetta pienamente le tue Istruzioni personalizzate, quindi è il tuo strumento principale per guidare il tono.
• Cacciatore di fact (PROBE) — chiede il prossimo fact mancante, puntando automaticamente al dettaglio di cui l'engine ha ancora bisogno.
• Invia foto (PHOTO) — invia la foto più adatta dal vault della persona, scelta automaticamente in base alla descrizione di ogni foto.
• Foto di verifica (VERIFICATION) — chiede al lead di inviare una foto di verifica/prova di sé stesso.
• Lascia il link (LINK_DROP) — lascia il tuo link funnel. Richiede un URL funnel impostato nelle impostazioni globali.
• Chiudi (CLOSE) — conclude e termina la conversazione.
• Reagisci (REACT), Tease / Flirt (TEASE), Apri (SHARE), Relazionati (RELATE) — beat veloci integrati che mantengono la conversazione umana. Vedi il punto importante qui sotto — questi quattro eseguono una riga fissa.

Gate e transizioni

I gate decidono quando la conversazione avanza o reagisce. Esistono due forme: contatori inline collegati tra due fasi, e observer flottanti che osservano l'intera chat.

Contatore inline

• Dopo N messaggi (MESSAGE_COUNT) — collegato fase → gate → fase. Conta i turni e fa avanzare la conversazione una volta raggiunta una soglia. La soglia è 1–20. Questo è il modo standard per far progredire una chat attraverso le sue fasi.

Observer flottanti

• Controllo fact (FACT_EXISTS) — si attiva quando uno specifico fact è stato estratto dalla conversazione.
• Checker conversione (CONVERSION_CHECK) — si attiva in base al fatto che il lead abbia accettato o rifiutato l'ultimo link lasciato.
• Rilevatore segnali (DETECTOR) — un observer interno che supporta la difesa dalle accuse di bot. Non è offerto nella palette; non lo posizioni tu.

Punti di avvio

Ogni engine deve sapere come inizia una chat. Aggiungi uno o più nodi di avvio e collega ciascuno alla fase dove inizia quel percorso.

• AI Opener / Outreach — l'AI invia il primo messaggio (outreach a freddo). Usalo per funnel proattivi.
• Inbound Chat / Default — l'utente scrive per primo (il normale DM in entrata). Un engine deve avere esattamente un avvio Inbound Chat / Default.
• Event Trigger — avvia una chat quando si attiva uno specifico evento esterno. Richiede un ID evento (ad esempio, story_reaction).
• Follow-up — ricontatta un lead che è diventato silenzioso, riportandolo nella conversazione.

Fact e la scheda Knowledge

La scheda Knowledge è dove gestisci i fact che l'engine raccoglie. Esistono due tipi:

• Fact di sistema — dettagli integrati che l'engine cerca sempre di apprendere (come il nome e la posizione del lead).
• Fact personalizzati — i tuoi campi, specifici per il tuo funnel.

Ogni fact è assegnato a una fase — lo stadio durante il quale l'engine dovrebbe cercare di apprenderlo. La card Fact Finder poi insegue qualsiasi fact ancora mancante per la fase corrente.

L'inspector dei nodi

Clicca su qualsiasi nodo per aprire l'inspector a destra. Ciò che puoi modificare dipende dal nodo, ma i campi comuni sono:

• Istruzioni / direttiva — guida in linguaggio naturale su cosa deve fare l'AI. Su una card questo orienta il messaggio; su una fase è lo scopo della fase. (Ricorda che le quattro card rapide la ignorano.)
• Opener della fase — il messaggio di apertura per una fase: come l'AI avvia la conversazione quando entra in quella fase.
• Peso (1–100) — la probabilità che una card venga estratta dal suo deck a un dato turno. Peso maggiore = giocata più spesso.
• Limite di utilizzo (0–20) — il numero massimo di volte che una card può essere giocata in una conversazione. 0 significa illimitato.
• Attesa tra gli utilizzi — quanti turni attendere prima che una card possa essere giocata di nuovo, in modo che non si ripeta consecutivamente.

Tag di prompting

All'interno delle Istruzioni di una card puoi digitare un tag e l'engine inserisce il valore reale prima che il messaggio venga inviato. I tag disponibili:

Dettagli della persona

• {name} — il nome della persona
• {age} — l'età della persona
• {origin} — la provenienza della persona
• {city} — la città della persona
• {job} — il lavoro della persona
• {hobbies} — gli hobby e gli interessi della persona
• {bio} — la bio della persona
• {style_tags} — le caratteristiche dello stile di messaggistica della persona
• {time} — l'orario del giorno corrente, così la persona può sembrare consapevole della mattina o della sera

Il tuo funnel

• {platform} — l'app su cui stai messaggiando
• {funnel_platform} — la tua piattaforma funnel o di destinazione

Azioni

• {photo} — invia la foto più adatta dal vault, scelta automaticamente per descrizione
• {link} — lascia il tuo link di conversione, con elusione dei filtri applicata

Specifici per card

• {fact} — su una card Fact Finder: il prossimo dettaglio da scoprire sul lead
• {vibe} — su una card Send Photo: il mood attuale della foto, casual o piccante
• {context} — su una card entry / opener: il primo messaggio in entrata a cui l'opener reagisce

Impostazioni globali e di Identità

Le impostazioni a livello di engine si trovano nella scheda Identità / impostazioni globali:

• Piattaforma di messaggistica — l'app su cui gira la conversazione (guida il tag {platform} ).
• Limite di turni (1–100, default 60) — il numero massimo di turni prima che la conversazione si fermi.
• Numero massimo di bolle (1–5) — in quante bolle di messaggio separate può essere suddivisa una singola risposta.
• Piattaforma funnel — la tua piattaforma di destinazione (guida {funnel_platform}).
• URL funnel — il link che invia la card Drop the Link.
• Mascheramento link — applicato automaticamente per eludere i filtri link quando il link viene lasciato.
• Valore del lead — quanto vale un lead convertito, usato dall'analytics per stimare il fatturato.

Rifiuti e difesa dal bot

Puoi programmare come l'engine gestisce i momenti difficili — un lead che si oppone, o accusa l'AI di essere un bot. Ogni scenario abbina un trigger con una risposta, che può essere un testo o un'immagine, così la conversazione si riprende elegantemente invece di bloccarsi.

Validazione e pubblicazione

Il builder controlla il tuo engine mentre lavori e riporta i problemi nel pannello Problemi. Due livelli contano:

• Gli errori bloccano la pubblicazione. Non puoi pubblicare un engine che non supera la validazione.
• Solo gli errori al limite massimo bloccano il Salva. Puoi salvare un lavoro in corso che ha ancora problemi minori e tornarci in seguito.
• Il pannello Problemi passa al nodo quando clicchi su un problema, così puoi risolverlo direttamente.

Gestione engine e marketplace

• Nuovo — inizia un nuovo engine da una canvas vuota.
• Copia (clone) — duplica un engine esistente per iterare senza toccare l'originale.
• Rinomina — rinomina uno dei tuoi engine .
• Elimina — rimuove un engine di tua proprietà.
• Pubblica / annulla pubblicazione — condivide un engine pulito nel marketplace, oppure lo rimuove.

Passi successivi

Con un engine costruito, sei pronto a metterlo al lavoro. Leggi della persona con cui gira in Personas, parti da un funnel collaudato nel Marketplace templates, testalo in Testing & il simulatore, e collegalo live con Going live.