Workflow node reference
Detect Mood
Understand the mood and urgency of a message. Exact configuration, outputs, execution behavior, errors, limits, and examples for the Detect Mood workflow node.
What this guide covers
- Category: AI.
- Use it to estimate the tone or mood of text and branch or prioritize follow-up.
- 1 configuration fields and 3 documented outputs.
- Tone is culturally and contextually ambiguous.
What this node does
Understand the mood and urgency of a message
Use it to estimate the tone or mood of text and branch or prioritize follow-up.
When not to use it
Do not use it to diagnose a person, infer protected traits, or make a final eligibility decision.
Prerequisites
- Representative text input
- A defined operational use for the output
- Human review for sensitive escalation
Representative text input. A defined operational use for the output. Human review for sensitive escalation
Inputs and configuration fields
| Field | Key | Control / type | Requirement | Default | Accepted values and behavior |
|---|---|---|---|---|---|
Message to Analyze | input | variable-input | Required when shown | {{context.message.content}} | Value accepted by the displayed control. Variables supported |
Configure the node
- Drag Detect Mood from AI in the node palette.
- Select the node to open its configuration drawer.
- Complete every required field and any conditional field revealed by your choices.
- Insert variables only from the current trigger or an earlier node on the same path.
- Connect every required output handle to the intended next step.
- Save and run Workflow Test with representative data before activation.
Outputs
Later nodes can use these values only after this node has run successfully on the same execution path.
| Variable | Type | Meaning |
|---|---|---|
{{nodes.ai_sentiment.sentiment}} | string | positive, negative, or neutral |
{{nodes.ai_sentiment.urgency}} | string | low, medium, high, or critical |
{{nodes.ai_sentiment.emotions}} | array | Detected emotions like happy, angry, confused |
Execution behavior
- Analyzes the supplied text.
- Emits mood/sentiment, score/confidence, and related output fields defined by the node.
- Runs for real during Test.
AI nodes run for real during Workflow Test and can consume billable AI usage. Do not assume an automatic retry unless the execution record explicitly shows one.
Example use case
Prioritize an urgent human handoff when an inbound support message appears strongly negative.
Message Received → Detect Mood → Condition → Human Handoff / AI ResponseCommon errors
| Symptom | Resolution |
|---|---|
Tone is misread | Use more context and avoid acting on mood alone. |
Input is empty | Check the selected message variable. |
Limitations
Tone is culturally and contextually ambiguous.
Always combine with business rules and human judgment where consequences matter.
Tone is culturally and contextually ambiguous. Always combine with business rules and human judgment where consequences matter.