Overview
The Symbiosika Assistant Chat node enables interaction with a Symbiosika AI assistant through chat messages. It supports sending user input to the assistant, continuing existing conversations, selecting specific assistant templates, retrieving available assistants, and resetting chat sessions.
This node is useful in scenarios where you want to integrate conversational AI into workflows, such as customer support automation, interactive FAQs, or virtual assistant tasks. For example, you can send a user's question to the assistant and receive an AI-generated response, continue a previous conversation by referencing a chat ID, or reset a chat session to start fresh.
Properties
| Name | Meaning |
|---|---|
| Organisation Name or ID | Select or specify the organisation context for the chat interaction. |
| Operation | Choose the action to perform: "Chat with Assistant", "Get Available Assistants", or "Reset Chat". |
| User Input | The message text sent from the user to the assistant (required for chat operation). |
| Use Existing Chat ID | Whether to continue an existing chat conversation using a chat ID. |
| Chat ID | The identifier of the existing chat to continue (shown if "Use Existing Chat ID" is true). |
| Use Specific Assistant | Whether to use a specific assistant template for the chat. |
| Assistant Name or ID | Select or specify the assistant template to use (shown if "Use Specific Assistant" is true). |
| Chat ID (Reset Chat) | The chat ID of the conversation to reset (required for reset chat operation). |
Output
For Chat with Assistant operation:
assistantMessage: The assistant's reply content.chatId: The current chat session ID (useful for continuing conversations).finished: Boolean indicating if the conversation is finished.render: Additional rendering information from the assistant.sessionId: Passed-through session identifier from input data.meta: Metadata returned from the API about the chat.
For Get Available Assistants operation:
assistants: An array of available assistant templates with their details.
For Reset Chat operation:
resetMessage: Confirmation or message after resetting the chat.chatId: The chat session ID that was reset.finished: Boolean indicating if the reset ended the conversation.render: Additional rendering information.sessionId: Passed-through session identifier from input data.
The node does not output binary data.
Dependencies
- Requires an API key credential for authenticating with the Symbiosika Chat API.
- The node makes HTTP requests to the Symbiosika API endpoints to perform operations.
- The API base URL and key are configured via the credential.
- The node dynamically loads options for organisations and assistants from the API.
Troubleshooting
- No user input provided: When performing a chat operation, ensure the "User Input" property is filled; otherwise, the node will throw an error.
- Invalid or missing chat ID: If continuing or resetting a chat, provide a valid chat ID; missing or invalid IDs cause errors.
- Failed to load organisations or assistants: Network issues or invalid API keys may prevent loading options; verify credentials and connectivity.
- Invalid API responses: The node expects specific JSON structures; unexpected formats will cause errors.
- Operation not supported: Selecting an unsupported operation value will result in an error.
- To handle errors gracefully, enable "Continue On Fail" in the node settings to capture errors per item without stopping the workflow.
Links and References
- n8n Expressions Documentation
- Symbiosika API documentation (not publicly linked here; refer to your API provider)