Hanna Bot

Interact with Hanna IRC Bot via its REST API

Overview

The Hanna Bot node allows interaction with the Hanna IRC Bot through its REST API. It supports a variety of IRC-related operations such as sending messages or notices, joining or leaving channels, changing the bot's nickname, retrieving user or channel information, and more. This node is useful for automating IRC bot management and communication tasks within n8n workflows.

For example, you can use this node to:

  • Change the bot’s nickname dynamically during a workflow.
  • Send messages or notices to specific IRC channels or users.
  • Retrieve detailed information about users or channels for monitoring or logging purposes.

Properties

Name Meaning
New Nickname New nickname for the bot

Note: The "New Nickname" property is required when using the "Change Nick" operation.

Output

The output JSON object contains the following fields relevant to the "Change Nick" operation:

  • success: Boolean indicating if the operation was successful.
  • operation: The string "nick" indicating the performed operation.
  • response: The raw response from the Hanna Bot API parsed as JSON.
  • timestamp: ISO timestamp of when the operation was executed.
  • newNick: The new nickname that was set for the bot.

This output confirms the nickname change request and provides any additional data returned by the API.

Dependencies

  • Requires an API key credential for authenticating with the Hanna Bot REST API.
  • The node expects the Hanna Bot API URL and token to be configured in the credentials.
  • No other external dependencies are needed.

Troubleshooting

  • Invalid operation error: If an unsupported operation value is provided, the node throws an error indicating an invalid operation.
  • Authentication errors: Ensure the API key credential is correctly configured and has sufficient permissions.
  • API connectivity issues: Verify the Hanna Bot API URL is reachable from the n8n instance.
  • Malformed input: Required properties like "New Nickname" must be provided; otherwise, the node will fail.

Links and References

Discussion