Chat

Catalogue des nœuds Déclencheurs

Sur cette page

Déclenche le workflow depuis une conversation de test ou une page publique

Utilisation et spécificités

L’éditeur propose un chat de test. publicEnabled et embedEnabled autorisent séparément la page publique et l’intégration. Le mode de réponse, le template et l’historique règlent la conversation.

Type technique : chat. Runtime : nodulz.

Identifiants et prérequis

Aucun identifiant externe dédié n’est défini par ce nœud. Les sources distantes ou la cible d’exécution peuvent néanmoins nécessiter leurs propres accès.

Consultez le guide des identifiants si une source distante ou une cible d’exécution nécessite un accès.

Paramètres

Les noms ci-dessous correspondent aux clés techniques. Les valeurs par défaut ne constituent pas une configuration prête à exécuter : renseignez les champs requis par votre opération. Les chemins contenant [] décrivent les éléments d’une liste ; certains champs dépendent du mode sélectionné.

Paramètre	Type	Par défaut	Valeurs / limites
`rateLimitEnabled`	`boolean`	-	-
`rateLimitMax`	`number`	`30`	-; > 0
`rateLimitWindowMs`	`number`	`60000`	-; > 0
`allowedIps`	`array`	-	-; max 256
`blockedIps`	`array`	-	-; max 256
`path`	`string`	`""`	-
`publicEnabled`	`boolean`	`false`	-
`embedEnabled`	`boolean`	`false`	-
`attachmentsEnabled`	`boolean`	`false`	-
`attachmentsMaxFiles`	`number`	`5`	-; ≥ 0
`attachmentMaxSizeMb`	`number`	`5`	-; ≥ 0
`attachmentsMaxTotalSizeMb`	`number`	`25`	-; ≥ 0
`authentication`	`enum`	`"none"`	`none`, `secret`
`secret`	`string`	-	-
`title`	`string`	`"Chat"`	-
`welcomeMessage`	`string`	`""`	-
`inputPlaceholder`	`string`	`""`	-
`avatarUrl`	`string`	`""`	-
`primaryColor`	`string`	`"#6366f1"`	-
`backgroundColor`	`string`	`"#ffffff"`	-
`userBubbleColor`	`string`	`"#6366f1"`	-
`assistantBubbleColor`	`string`	`"#f1f5f9"`	-
`historyEnabled`	`boolean`	`true`	-
`historyMaxMessages`	`number`	`50`	-; > 0
`respond`	`enum`	`"streaming"`	`streaming`, `when_finished`
`responseFormat`	`enum`	`"node_output"`	`template`, `last_node`, `node_output`, `response_node`
`respondNodeKey`	`string`	-	-
`responseTemplate`	`string`	`""`	-

Aide de configuration

path Chemin public: Identifiant unique dans l'URL (ex. mon-agent → /c/mon-agent). Lettres minuscules, chiffres et tirets uniquement.
publicEnabled Exposer une page publique: Active la page /c/{chemin} accessible sans authentification nodulz.
embedEnabled Autoriser l'intégration iframe: Active la variante /embed/c/{chemin} pour intégrer le chat dans un site externe.
authentication Authentification: Protège les routes publiques. Le secret est envoyé via l'en-tête x-nodulz-secret ou ?secret=.
secret Secret partagé: Secret partagé avec les clients autorisés. Identique au mécanisme des webhooks nodulz.
attachmentsEnabled Autoriser les pièces jointes: Autorise l’envoi de fichiers avec les messages. Les fichiers sont disponibles dans attachments en sortie du nœud.
attachmentsMaxFiles Nombre maximal de fichiers par message: Nombre maximal de fichiers par message. 0 signifie sans limite.
attachmentMaxSizeMb Taille maximale par fichier (Mo): Taille maximale en Mo par fichier. 0 signifie sans limite.
attachmentsMaxTotalSizeMb Taille totale maximale par message (Mo): Taille maximale en Mo de tous les fichiers d’un message. 0 signifie sans limite.
historyEnabled Conserver l'historique multi-tour: Stocke les messages précédents et les renvoie au workflow à chaque nouveau message.
historyMaxMessages Messages max par session: Limite le nombre de messages chargés depuis l'historique (les plus récents en priorité).
title Titre: Titre affiché en en-tête du chat public.
welcomeMessage Message de bienvenue: Premier message affiché par l'assistant avant toute interaction.
inputPlaceholder Placeholder de saisie: Texte indicatif dans la zone de saisie du message.
avatarUrl URL de l'avatar: Image affichée à côté des messages de l'assistant (URL absolue).
primaryColor Couleur principale: Couleur d'accent pour le titre et les éléments interactifs de la page publique.
backgroundColor Couleur de fond: Arrière-plan du panneau chat sur la page publique.
userBubbleColor Bulle utilisateur: Couleur de fond des messages envoyés par l'utilisateur.
assistantBubbleColor Bulle assistant: Couleur de fond des réponses de l'assistant.
respond Répondre: Streaming : réponse progressive au fil de l'exécution. À la fin : réponse unique une fois le workflow terminé.
respondNodeKey Nœud en streaming: Nœud dont la sortie streaming alimente la réponse chat en temps réel.
responseFormat Format de réponse: Source de la réponse finale lorsque le mode « à la fin » est sélectionné.
respondNodeKey Nœud de réponse: Nœud dont la sortie JSON/texte constitue la réponse assistant.
responseTemplate Modèle de réponse: Modèle Handlebars appliqué à la sortie du workflow pour formater la réponse.

Configuration initiale

Exemple de configuration initiale du catalogue, à adapter avant exécution. Les secrets doivent rester dans les identifiants.

json

{
  "path": "",
  "publicEnabled": false,
  "embedEnabled": false,
  "authentication": "none",
  "title": "Chat",
  "welcomeMessage": "",
  "inputPlaceholder": "",
  "avatarUrl": "",
  "primaryColor": "#6366f1",
  "backgroundColor": "#ffffff",
  "userBubbleColor": "#6366f1",
  "assistantBubbleColor": "#f1f5f9",
  "historyEnabled": true,
  "historyMaxMessages": 50,
  "respond": "streaming",
  "responseFormat": "node_output",
  "responseTemplate": ""
}

Vérification

Testez le nœud avec des données représentatives. Contrôlez sa sortie dans l’inspecteur et les logs, puis utilisez le mapping de l’éditeur pour les champs des nœuds suivants. Un test de déclencheur avec payload simulé ne valide pas la livraison du service externe.

Voir aussi : Expressions et données, Exécutions, Catalogue des nœuds.