OneBot icon

OneBot

Consume OneBot API
Join our community

Actions6

Overview

This node integrates with the OneBot API to send messages and retrieve information related to messaging, groups, friends, and more. Specifically, for the Send Group Message operation under the Message resource, it allows sending text messages to a specified group in a chat platform that supports OneBot.

Common scenarios where this node is beneficial include:

  • Automating announcements or notifications to a group chat.
  • Sending batch messages to multiple groups.
  • Forwarding multiple messages as a single forwarded message to a group.

For example, you could use this node to automatically send daily updates to a project team’s group chat or forward a series of messages collected from previous workflow steps into a group conversation.

Properties

Name Meaning
Group Name or ID Select the target group by name or ID to which the message will be sent. Can be chosen from a list or specified dynamically via expression.
Message The text content of the message to send to the group. Supports multiline input.
Forward Mode Boolean flag indicating whether to forward multiple messages as a single forwarded message instead of sending them individually.

Output

The node outputs JSON data representing the response from the OneBot API after sending the group message. This typically includes confirmation details such as message IDs or status indicators returned by the API.

If multiple items are processed with forwarding enabled, the output corresponds to the result of the forwarded message request.

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to the OneBot API.
  • Needs an API authentication credential configured in n8n (e.g., an API key or token) to authorize requests.
  • Utilizes internal helper functions to make HTTP GET or POST requests to the OneBot endpoints.

Troubleshooting

  • Empty or invalid group ID: Ensure the "Group Name or ID" property is correctly set. If using expressions, verify they resolve to valid group identifiers.
  • API authentication errors: Confirm that the API credential is properly configured and has sufficient permissions to send group messages.
  • Forward mode issues: When forwarding multiple messages, ensure the source messages are correctly formatted and the API supports forwarding in your environment.
  • Network or connectivity problems: Check network access to the OneBot API endpoint and any firewall settings.

Common error messages may include authorization failures, invalid parameters, or rate limiting responses from the API. Resolving these usually involves verifying credentials, input values, and API usage limits.

Links and References

Discussion