Hanna Bot

Interact with Hanna IRC Bot via its REST API
Join our community

Actions9

Overview

This node integrates with the Hanna IRC Bot via its REST API to perform various IRC-related operations. Specifically, the "Get Channel Info" operation retrieves detailed information about a specified IRC channel, such as its topic, user count, modes, creation time, and the list of users along with their roles (operator, voice, half-op).

This node is beneficial in scenarios where you want to monitor or manage IRC channels programmatically within an n8n workflow. For example, you could use it to:

  • Automatically fetch channel details for reporting or logging.
  • Trigger actions based on channel membership or topic changes.
  • Integrate IRC channel data into dashboards or other communication tools.

Properties

Name Meaning
Channel Name IRC channel name to get information about (include the leading #). Example: #general

Output

The output JSON contains detailed information about the queried IRC channel under the channelInfo field, including:

  • name: The channel's name.
  • topic: The current topic of the channel (if any).
  • userCount: Number of users currently in the channel.
  • users: An array of user nicknames present in the channel.
  • modes: The channel modes/settings string.
  • created: Timestamp or date when the channel was created.

Additionally, if user information is available, the output includes a channelUsers array with objects describing each user’s:

  • nick: User nickname without mode prefixes.
  • modes: String of mode prefixes the user has (e.g., @ for operator, + for voice).
  • isOperator: Boolean indicating if the user is a channel operator.
  • hasVoice: Boolean indicating if the user has voice privileges.
  • isHalfOp: Boolean indicating if the user has half-operator status.

The output also includes metadata fields:

  • success: Indicates if the API call was successful.
  • operation: The operation performed (channel).
  • queriedChannel: The channel name requested.
  • response: Raw response from the API.
  • timestamp: ISO timestamp of when the response was generated.

No binary data is produced by this operation.

Dependencies

  • Requires connection to a Hanna IRC Bot REST API endpoint.
  • Needs an API authentication token credential configured in n8n to authorize requests.
  • The node sends HTTP requests to the bot’s API URL with bearer token authorization.

Troubleshooting

  • Invalid Operation Error: If an unsupported operation is selected, the node throws an error indicating "Invalid operation". Ensure the operation is set to "Get Channel Info" or another supported value.
  • Authentication Failures: If the API token or URL is incorrect or missing, requests will fail. Verify that the Hanna IRC Bot API credentials are correctly configured.
  • Channel Not Found or Empty Response: If the specified channel does not exist or the bot has no information about it, the response may be empty or incomplete. Confirm the channel name includes the # prefix and exists on the IRC network.
  • Network Issues: Connectivity problems between n8n and the Hanna Bot API can cause request failures. Check network access and firewall settings.
  • Malformed Channel Name: The channel name must include the leading #. Omitting it may result in errors or no data returned.

Links and References

Discussion