Actions9
Overview
The node "Hanna Bot" enables interaction with an IRC bot via its REST API, allowing users to perform a variety of IRC-related operations programmatically within n8n workflows. It supports sending messages and notices, joining or leaving channels, changing nicknames, querying user and channel information, retrieving server status, and sending raw IRC commands directly.
A common use case is automating IRC communications, such as sending alerts or notifications to specific channels or users, managing channel membership, or gathering IRC network data for monitoring or reporting purposes.
For example, the "Send Raw Command" operation allows sending any custom IRC command string directly to the IRC server, which is useful when you need to execute commands not covered by other predefined operations.
Properties
| Name | Meaning |
|---|---|
| IRC Command | Raw IRC command to send (e.g., PRIVMSG #channel :Hello world). This is a free-text string representing any valid IRC command line. |
Note: The above property applies specifically to the "Send Raw Command" operation.
Output
The node outputs JSON objects containing:
success: Boolean indicating if the operation was successful.operation: The name of the executed operation (e.g., "raw").response: Parsed response from the Hanna Bot API, typically reflecting the result of the IRC command or query.timestamp: ISO timestamp of when the operation was performed.command: For the "Send Raw Command" operation, echoes back the raw IRC command sent.
The output structure varies depending on the operation but generally includes detailed information about the IRC state or confirmation of the action taken.
This node does not output binary data.
Dependencies
- Requires connection to a Hanna IRC Bot REST API endpoint.
- Needs an API authentication token credential configured in n8n to authorize requests.
- The API URL and token must be provided via credentials.
Troubleshooting
- Invalid Operation Error: If an unsupported operation value is set, the node throws an error indicating an invalid operation. Ensure the operation parameter is correctly set to one of the supported options.
- Authentication Failures: Errors related to authorization usually mean the API token is missing, expired, or incorrect. Verify the API key credential configuration.
- Malformed IRC Commands: When using the "Send Raw Command" operation, ensure the IRC command string is properly formatted according to IRC protocol standards; otherwise, the IRC server may reject it.
- Network Issues: Connectivity problems to the Hanna Bot API endpoint will cause request failures. Check network access and API availability.
Links and References
- IRC Protocol Basics — foundational document describing IRC commands and behavior.
- Hanna Bot API documentation (refer to your Hanna Bot instance documentation for detailed API endpoints and usage).