Overview
This node is a trigger that starts an n8n workflow when events related to a Symbiosika tool occur. It listens for webhook calls from the Symbiosika platform, specifically for tool-related events within a specified organisation. This is useful for automating workflows based on custom tool activities in Symbiosika, such as when a tool is invoked or updated.
Practical examples include:
- Triggering a workflow when a specific tool is used in an organisation.
- Automating notifications or data processing when a new tool event happens.
- Integrating Symbiosika tool events with other systems via n8n.
Properties
| Name | Meaning |
|---|---|
| Organisation Name or ID | Select the organisation from a dynamically loaded list or specify its ID using an expression. The node will listen for tool events within this organisation. |
| Tool Name | The name of the tool as it will appear in Symbiosika. This identifies which tool's events will trigger the workflow. |
| Tool Description | A description explaining what the tool does. This metadata is sent during webhook registration. |
| Parameters | A collection of parameters defining the tool's inputs. Each parameter has: - Name: The parameter's name. - Type: Data type (Array, Boolean, Date, Function, Integer, Null, Number, Object, RegExp, String, Undefined). - Required: Whether this parameter must be provided. |
| Use Organisation-Wide? | Boolean flag indicating if the tool applies to the entire organisation rather than a subset or individual context. |
Output
The node outputs JSON data representing the event payload received from the Symbiosika webhook. The output contains all information about the tool event that triggered the workflow, allowing downstream nodes to process or react to these details.
If binary data were involved, it would be summarized here, but this node only handles JSON event data.
Dependencies
- Requires an API key credential for authenticating with the Symbiosika Chat API.
- Needs network access to the Symbiosika API endpoints to register and manage webhooks.
- The node dynamically loads organisations from the Symbiosika API to populate the organisation selection property.
- Proper configuration of the Symbiosika API URL and API key is necessary in the credentials.
Troubleshooting
- Failed to load organisations: This error occurs if the node cannot fetch the list of organisations from the Symbiosika API. Check that the API key credential is valid and the API URL is reachable.
- Symbiosika tool registration failed: Happens if the webhook registration request to Symbiosika fails or returns an unexpected response. Verify the organisation ID, tool name, and API credentials.
- Invalid response format for organisations: Indicates the API returned data not matching the expected array structure. Could be due to API changes or connectivity issues.
- If the webhook does not trigger the workflow, ensure the webhook URL is correctly registered in Symbiosika and accessible from the internet.
Links and References
- n8n Expressions Documentation
- Symbiosika API documentation (not publicly linked here; refer to your internal resources)