Actions38
- Agent Actions
- Company Actions
- Content Actions
- Conversation Actions
- File Actions
- Message Actions
- Project Actions
- Workflow Actions
Message → Create
AI-generatedOverview
This node operation creates a new message within the Agentic Hub platform. It supports two modes: 'unified' mode, which automatically creates or updates a conversation based on a session ID, and 'legacy' mode, which requires an existing conversation ID. The node allows specifying message content, direction (from user to agent or agent to user), and additional options for both the message and the conversation. This operation is useful for automating message creation in workflows that manage conversations and messaging, such as customer support or chatbot interactions.
Use Case Examples
- Automatically create a conversation and send a message when a user initiates a chat session (unified mode).
- Send a message to an existing conversation using a known conversation ID (legacy mode).
Properties
| Name | Meaning |
|---|---|
| Mode | Determines whether to auto-create/update conversation based on session ID (unified) or use an existing conversation ID (legacy). |
| Session ID | Unique session identifier, required if mode is unified. |
| Workflow ID | ID of the workflow to which the conversation belongs, required if mode is unified. |
| Conversation ID | ID of the conversation to which the message belongs, required if mode is legacy. |
| Content | The text content of the message. |
| Direction | Message direction: 0 means from user to agent, 1 means from agent to user. |
| Conversation Options | Optional parameters to set or update conversation properties when in unified mode, such as status, human handling, sentiment, phone number, and human attention requirement. |
| Session ID (Legacy) | Session identifier used when conversation object is not provided, applicable in legacy mode. |
| Message Options | Additional optional message parameters such as error message, external message ID, sentiment score, status, and template ID. |
Output
JSON
json- The JSON response from the Agentic Hub API representing the created message and related data.
Dependencies
- Agentic Hub API authentication token
Troubleshooting
- Ensure required fields are provided based on the selected mode (unified or legacy). Missing sessionId or workflowId in unified mode or conversationId in legacy mode will cause errors.
- Invalid JSON format in any optional JSON fields (not applicable here but relevant for other operations) will cause errors.
- API authentication errors if the Agentic Hub API credentials are not correctly configured or expired.