Infrastrutture AI Documento interno di delivery

Energy Live SSD — Stato Delivery

Chatbot WhatsApp "Eny" per la riattivazione 2026, circa 4.865 contatti, aggiornato al 10 luglio 2026 (sera).

23
Cicli di test superati
4.865
Contatti importati in GHL
127
Chunk di KB (13 file)

Intake

Survey, liste contatti e materiali cliente.

1
Survey e materiali ricevutiFATTO
Survey GHL del 26 giugno (Terenzio Lomoro), liste contatti (circa 4.879 unici) e documentazione KB estratta (22 file). Nome bot confermato: Eny.
2
Anagrafica e progress trackingFATTO
Cliente in database, task su Asana, progress.json attivo.

Provisioning backend (Hetzner)

Tenant, KB e motore RAG sul box chatbot.

1
Tenant "energylive" provisionatoFATTO
Workflow chatbot attivo, retrieve e File API clonata da tertium, DB dedicato rag_energylive. Modello LLM gpt-5-mini.
2
Knowledge Base ingeritaFATTO
13 file, 127 chunk dopo il fix del 9 luglio: aggiunta info-struttura e header validita orari.
3
Profilo portale completoFATTO
Login energylive attivo, conversazioni visibili, KPI attivi, tenant aggiunto al nodo Stats Appointments del Control Plane (snapshot in history).

CRM GoHighLevel

Sub-account, contatti, pipeline e workflow. In corso.

1
Sub-account, utente e calendarioFATTO
Sub-account live, utente Terenzio (admin, invito partito), calendario consulente round robin 30 min, campo contatto eta creato.
2
Import contattiFATTO
4.865 contatti importati con tag riattivazione-2026 (533 flag genitore, campo eta popolato), 0 fallimenti, verificato via API.
3
Pipeline e tagFATTO
Pipeline "Riattivazione 2026" con 7 stage, tag interessato e opt-out creati.
4
3 workflow intake (A/B/C)IN DRAFT
Verificato via API 10/07: esistono gia in GHL ma sono in Draft. Manca solo il Publish (guide nella Checklist operativa, voci 4-6).
5
Drip campagna riattivazione
Da costruire su GHL nativo (decisione: n8n resta solo motore RAG). Parte quando WhatsApp e template Meta sono attivi.

Prompt e Testing

Prompt Eny live e QA multi-turn.

1
Prompt Eny v5 liveFATTO
19.343 caratteri: promo Acquafitness e Acquagym, mai prezzi, mai cifre eco, scenario genitore, anti meta-coaching, limite 400-500 char, Fase 1 two-step. Snapshot di ogni versione in history.
2
QA multi-turn e one-shotFATTO
23 cicli superati: multi-turn 7 scenari, full test 10 personas, 25 one-shot. Fix applicati (ban eco-euro, no nuoto, regola piano orari corrente, contatti ufficiali), poi 4 su 4 probe passate.
3
Test pipeline end-to-endIN ATTESA
Parte quando il canale WhatsApp e collegato: enable webhook, whatsapp e wait, mapping sessionKey al contact_id, enable tagContact.

Canale WhatsApp

Collegato dal cliente e wiring n8n completato. In attesa del workflow GHL inbound.

1
WhatsApp collegato al CRMFATTO
Il cliente ha collegato il numero WhatsApp al CRM in data 10 luglio 2026 (guida inviata, accesso su info@energy-live.it).
2
Wiring nodi n8n WhatsAppFATTO E VALIDATO
Webhook, invio WhatsApp, wait umano, tagContact e doppio trigger (widget piu WhatsApp) abilitati e cablati al motore conversazionale RAG. Completato e validato il 10 luglio.
3
Workflow GHL inbound verso EnyIN CORSO
Manca solo il workflow GHL "0" (Customer Replied WhatsApp piu tag riattivazione-2026, POST al webhook n8n) per attivare la pipeline conversazionale end-to-end.

Handoff

Consegna e formazione. In attesa.

1
Consegna cliente e walkthroughPENDING
Notifica cliente, formazione finale e passaggio dati consulente. Parte dopo il test end-to-end e la pubblicazione dei workflow.

Checklist operativa

Sequenza completa aggiornata al 10 luglio 2026 (sera). Pallino verde: fatto, ambra: in corso, grigio: da fare.

1
Wiring canale WhatsApp su n8nFATTOClaude
Webhook, invio WhatsApp, wait umano, tagContact (additivo) e doppio trigger widget piu WhatsApp. Fatto e validato il 10 luglio.
1b
Widget chat di test nella doc clienteFATTOClaude
Widget "Prova Eny in diretta" embeddato nella documentazione cliente. Fatto il 10 luglio.
2
Workflow GHL "0": Riattivazione Inbound verso EnyIN CORSOLorenzo
Trigger Customer Replied WhatsApp piu tag riattivazione-2026, poi Webhook POST a n8n, poi Publish. Verificato via API 10/07: non ancora creato in GHL, va costruito da zero con la guida sotto.
Webhook n8n: https://n8n-internal-chatbot.automazioni.ai/webhook/energylive/inbound
Istruzioni operative passo passo
  1. Nella sub-account Energy Live vai su Automation, poi Workflows, poi Create Workflow e scegli Start from scratch (blank).
  2. Rinomina il workflow (in alto a sinistra) in: Riattivazione · Inbound → Eny (n8n).
  3. Clicca Add New Trigger e seleziona Customer Replied. Aggiungi i filtri:
    • Reply Channel uguale a WhatsApp
    • Contact Tag: il contatto HA il tag riattivazione-2026
    • Contact Tag: il contatto NON ha il tag stop-bot. Finche il tag e presente i messaggi non arrivano a n8n e il bot resta in silenzio (takeover umano).
    Salva il trigger.
  4. Clicca il + sotto il trigger, aggiungi l'azione Webhook (categoria Developers) e configurala:
    • Method: POST
    • URL: https://n8n-internal-chatbot.automazioni.ai/webhook/energylive/inbound
    • Payload di default, nessun custom data
    Salva l'azione.
  5. In alto a destra attiva il toggle da Draft a Publish e salva. Non lasciarlo in Draft, altrimenti il trigger non scatta.
3
Test pipeline end-to-end su WhatsApp realeDA FARELorenzo piu Claude
Messaggio reale, Eny risponde, esecuzione n8n verde.
Istruzioni operative passo passo
  1. Nella sub-account crea un contatto di prova con il tuo numero WhatsApp personale.
  2. Applica al contatto il tag riattivazione-2026 (senza questo tag il workflow "0" non scatta).
  3. Dal tuo telefono scrivi un messaggio al numero WhatsApp di Energy Live collegato al CRM.
  4. Attendi la risposta di Eny entro circa 40 secondi (il wait umano di 5-38 secondi e incluso nel ritardo).
  5. Avvisa Claude, che nel frattempo monitora le esecuzioni n8n e conferma che il flusso e verde.
Se dopo circa 40 secondi non arriva risposta: controlla che il workflow "0" sia in Publish e che il contatto abbia davvero il tag riattivazione-2026.
4
Workflow GHL A: Inbound verso In conversazioneCOSTRUITO, MANCA SOLO PUBLISHLorenzo
Verificato via API 10/07: il workflow esiste gia in GHL ma e in Draft. Unico step rimasto: aprilo in Automation, poi Workflows e attiva il toggle Publish in alto a destra.
Guida di riferimento per verificare la configurazione
  1. Automation, poi Workflows, poi Create Workflow blank. Nome: Riattivazione · Inbound → In conversazione.
  2. Trigger: Customer Replied (inbound message), Channel uguale a WhatsApp. Aggiungi i filtri sul contatto:
    • HA il tag riattivazione-2026
    • NON ha il tag interessato
    • NON ha il tag opt-out
    Le due esclusioni sono obbligatorie: senza, ogni risposta successiva ritrascina il lead in "In conversazione" anche dopo che B o C lo hanno spostato avanti.
  3. Nelle Settings del workflow attiva Allow re-entry ON (deve scattare a ogni risposta, non solo alla prima).
  4. Azione: Create/Update Opportunity. Pipeline Riattivazione 2026 (Q8E0qbByxY3r5Son80a0), stage In conversazione (62ffb963-eedc-4788-818b-84a754df6a6b), owner Terenzio Lomoro. Se l'opportunity esiste gia, spostala a "In conversazione".
  5. Publish, non lasciare in Draft.
Opzionale: aggiungi chiuso come terza esclusione tag se la consulente tagga a mano i lead chiusi (Iscritto / Non interessato). Opzionale anche un secondo trigger "Contact Tag added = riattivazione-2026" che crea l'opportunity in stage Nuovo (241293bd-7c59-4dee-9ff8-1df9933723f1) per tracciare il primo tocco.
5
Workflow GHL B: Interessato verso ConsulenteCOSTRUITO, MANCA SOLO PUBLISHLorenzo
Verificato via API 10/07: il workflow esiste gia in GHL ma e in Draft. Unico step rimasto: aprilo in Automation, poi Workflows e attiva il toggle Publish in alto a destra.
Guida di riferimento per verificare la configurazione
  1. Automation, poi Workflows, poi Create Workflow blank. Nome: Riattivazione · Interessato → Consulente + notifica.
  2. Trigger: Contact Tag added, tag uguale a interessato (settato dal bot o dall'handoff).
  3. Azione 1: Update Opportunity, stage Interessato → Consulente (f75adf6d-6426-442b-a26c-649bd5f89ace).
  4. Azione 2: Send Email (notifica interna) a comunicazioni@energy-live.it (Gianna, va sempre notificata delle comunicazioni rilevanti):
    • Oggetto: Nuovo lead interessato: {{contact.name}}
    • Corpo: nome, telefono, ultimo messaggio, link al contatto
  5. Azione 3: Add Tag: stop-bot, subito dopo lo spostamento stage. Appena il lead passa al consulente il bot si blocca da solo.
  6. Azione 4 (opzionale): notifica anche il consulente Terenzio e crea un task Richiama lead.
  7. Publish, non lasciare in Draft.
6
Workflow GHL C: Opt-out verso stage Opt-outCOSTRUITO, MANCA SOLO PUBLISHLorenzo
Verificato via API 10/07: il workflow esiste gia in GHL ma e in Draft. Unico step rimasto: aprilo in Automation, poi Workflows e attiva il toggle Publish in alto a destra.
Guida di riferimento per verificare la configurazione
  1. Automation, poi Workflows, poi Create Workflow blank. Nome: Riattivazione · Opt-out.
  2. Trigger: Contact Tag added, tag uguale a opt-out.
  3. Azione 1: Update Opportunity, stage Opt-out (8fcd9b2d-fc6f-4df5-8703-86ebbd93a65d).
  4. Azione 2: Set DND ON su tutti i canali, o almeno WhatsApp e SMS, per fermare gli invii.
  5. Publish, non lasciare in Draft.
6b
Workflow GHL D: Stop bot 24h (takeover umano)DA FARELorenzo
Auto-rimozione del tag stop-bot dopo 24 ore: quando il lead passa al consulente (o il tag viene messo a mano) il bot tace per 24h, poi riprende da solo. Pattern Tertium.
Istruzioni operative passo passo
  1. Automation, poi Workflows, poi Create Workflow blank. Nome: Riattivazione · Stop bot 24h.
  2. Trigger: Contact Tag added, tag uguale a stop-bot (crea il tag se non esiste). Nelle Settings attiva Allow re-entry ON.
  3. Azione 1: Wait 24 ore.
  4. Azione 2: Remove Contact Tag: stop-bot.
  5. Publish, non lasciare in Draft.
Il consulente puo anche aggiungere stop-bot a mano su qualsiasi contatto per silenziare il bot 24h; alla rimozione automatica il bot riprende.
7
Ri-test con i workflow attiviDA FARELorenzo piu Claude
Tag interessato, l'opportunity si muove e parte l'email di notifica.
Istruzioni operative passo passo
  1. Sul contatto di prova applica a mano il tag interessato.
  2. Verifica che l'opportunity si sposti nello stage Interessato → Consulente e che l'email di notifica arrivi a Gianna (comunicazioni@energy-live.it).
  3. Poi applica a mano il tag opt-out sullo stesso contatto.
  4. Verifica che l'opportunity passi allo stage Opt-out e che il DND risulti attivo sul contatto.
8
Template MetaDA FAREMarketing / Terenzio
Conferma bozze dal marketing, poi ok Terenzio, poi submission Meta con tempi tecnici di 2-5 giorni.
Istruzioni operative passo passo
  1. Sollecita al marketing la conferma delle bozze dei template (file sequenza-drip-whatsapp.md).
  2. Raccogli l'ok di Terenzio sui testi finali.
  3. Esegui la submission dei template su Meta dal CRM. Approvazione Meta in 2-5 giorni: e il percorso critico rispetto alla scadenza promo dell'8 agosto.
9
Drip campagna riattivazione su GHL nativoIN CORSO (STRUTTURA ORA, TEMPLATE DOPO)Lorenzo
Decisione: montare ORA la struttura del drip con messaggi custom segnaposto, sostituirli coi template Meta quando approvati. NON pubblicare prima. Struttura definita in sequenza-drip-whatsapp.md.
Istruzioni operative passo passo
  1. Automation, poi Workflows, poi Create Workflow blank. Nome: Riattivazione · Drip WhatsApp.
  2. Trigger: Contact Tag added, tag nuovo drip-start (il lancio campagna consiste nell'assegnare questo tag).
  3. Nelle Settings del workflow:
    • Stop on Response ON (chi risponde esce dal drip e passa a Eny)
    • Allow re-entry OFF
    • Time Window lun-ven 9:00-20:00
  4. Step 1: Send WhatsApp, segnaposto con il testo MSG 1 da sequenza-drip-whatsapp.md (variabile nome = {{contact.first_name}}).
  5. Wait 2 giorni.
  6. Step 2: Send WhatsApp, segnaposto MSG 2.
  7. Wait 2 giorni.
  8. Step 3: Send WhatsApp, segnaposto MSG 3.
  9. Save, NON pubblicare: resta in Draft finche i template Meta non sono approvati.
  10. Nel Workflow C (Opt-out) aggiungi l'azione Remove from All Workflows.
  11. Al lancio: tag drip-start a batch di 200-300 contatti al giorno (bulk action sulla lista riattivazione-2026), mai blast unico.
  12. A template approvati: nei 3 step Send WhatsApp seleziona i template riattivazione_ex_clienti_1/2/3 al posto del testo libero, poi Publish.
Attenzione: i messaggi custom NON partono verso contatti fuori dalla finestra 24h (regola Meta). I segnaposto servono solo a preparare la struttura; l'invio reale richiede i template approvati.
Vincolo temporale: la promo scade l'8 agosto. Per avere margine utile serve partire con l'outbound entro meta luglio. I 2-5 giorni di approvazione Meta sono il percorso critico.

Blocker residui

Cosa resta prima del go-live.

1
Dati consulente per handoff
Servono i dati del consulente e eventuali vincoli sui contenuti dal cliente.
2
Approvazione template Meta
Bozze pronte, in conferma col marketing. Submission Meta con tempi tecnici di 2-5 giorni.
3
Pubblicazione workflow GHL
I 3 workflow intake sono in draft e vanno pubblicati prima del test end-to-end.

Gia fatto