Ce face Chat Trigger
Chat Trigger pornește fluxul la fiecare mesaj trimis într-o interfață de chat. Trebuie conectat un nod rădăcină de tip agent sau lanț. Fiecare mesaj înseamnă o execuție: o conversație cu 10 mesaje consumă 10 execuții. Nodul a înlocuit Manual Chat Trigger (eliminat în n8n 3.0).
Cât construiești fluxul, lasă Make Chat Publicly Available oprit și folosește chatul manual din editor. Când îl pornești, alegi Hosted Chat (interfața găzduită de n8n, configurabilă din opțiuni) sau Embedded Chat (widgetul de chat n8n ori interfața ta, care cheamă URL-ul din Chat URL).
Agentul sau lanțul întoarce un câmp output sau text, iar Chat Trigger trimite valoarea lui ca răspuns. Dacă construiești răspunsul manual, câmpul trebuie să se numească text sau output; altfel se trimite tot obiectul. Cu nodul Chat, pune Response Mode pe Using Response Nodes.
Sintaxă și opțiuni
| Opțiune / Parametru | Descriere |
|---|---|
Make Chat Publicly Available |
Chat public (pornit) sau doar chatul manual din editor (oprit). |
Mode |
Hosted Chat sau Embedded Chat. |
Authentication |
None, Basic Auth (același utilizator și parolă pentru toți) sau n8n User Auth (doar utilizatori n8n logați; opțional Require Workflow Execute Permission). |
Initial Message(s) |
Doar la Hosted Chat: mesajele afișate când utilizatorul deschide pagina. |
Make Available in n8n Chat |
Publică agentul în Chat Hub, cu Agent Name și Agent description. Chat Hub este dezactivat implicit în n8n 3.0. |
Allowed Origin (CORS) |
Originile permise, separate prin virgulă. Implicit *. |
Input Placeholder, Title, Subtitle |
Textele interfeței găzduite. |
Load Previous Session |
Încarcă mesajele unei sesiuni anterioare. Cu From Memory, conectează același nod de memorie la Chat Trigger și la agent. |
Response Mode |
When Last Node Finishes, Using Response Nodes (nodul Chat sau Respond to Webhook) sau Streaming response. |
Require Button Click to Start Chat |
Afișează butonul New Conversation. |
Exemple practice
Exemplul 1: Widget încorporat, cu date suplimentare din site
Câmpul metadata apare în ieșirea Chat Trigger, lângă celelalte date.
createChat({
webhookUrl: 'YOUR_PRODUCTION_WEBHOOK_URL',
metadata: {
'YOUR_KEY': 'YOUR_DATA'
}
});
Exemplul 2: Textul utilizatorului în nodurile următoare
{{ $json.chatInput }}
Greșeli frecvente și bune practici
- Eroarea
workflow could not be started!la încărcarea sesiunii anterioare: folosește același nod de memorie pentru Chat Trigger și agent, cu Session ID pe Connected Chat Trigger Node. - Încorporezi chatul pe alt domeniu și restrângi Allowed Origin (CORS) fără să incluzi domeniul site-ului.
- Returnezi răspunsul într-un câmp cu alt nume decât
textsauoutputși utilizatorul primește tot obiectul JSON.