# Chat - Déclencheur de workflow | Docs - nodulz

Source: https://nodulz.com/fr/docs/nodes/chat

Language: fr

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](/docs/credentials) 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

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

## Pour aller plus loin

- [Fonctionnalités - nodulz](https://nodulz.com/fr/product/overview)
- [Catalogue des nœuds - nodulz](https://nodulz.com/fr/product/catalog)
- [Serveur MCP - nodulz](https://nodulz.com/fr/product/mcp)
- [Tarifs - nodulz](https://nodulz.com/fr/pricing)
- [Cas d’usage et automatisations - nodulz](https://nodulz.com/fr/use-cases)
- [Choisissez ce que vos workflows peuvent faire. - nodulz](https://nodulz.com/fr/compare)
- [Documentation - nodulz](https://nodulz.com/fr/docs)