Actions19
Overview
This node integrates with the OneBot API to perform various operations related to groups, friends, bots, messages, and members in a chat environment. Specifically for the 群组 (Group) resource and the 群戳一戳 (Group poke) operation, it allows you to send a "poke" action to a specific member within a group. This is akin to nudging or tapping a user to get their attention in a group chat.
Common scenarios:
- Notifying a particular group member without sending a full message.
- Triggering interactive or playful notifications inside group chats.
- Automating reminders or alerts by poking users in a group context.
Practical example:
You can configure this node to poke a user named "Alice" in the group "Project Team" to remind her about an upcoming meeting without cluttering the chat with text messages.
Properties
| Name | Meaning |
|---|---|
| Group Name or ID | Select the target group from a list or specify its ID via expression. |
| Member Name or ID | Select the target member within the chosen group from a list or specify their ID via expression. |
These properties are required for the "群戳一戳" operation and allow precise targeting of the poke action.
Output
The node outputs JSON data representing the result of the executed operation. The structure typically includes success status and any returned data or error messages from the OneBot API.
For the "群戳一戳" operation, the output JSON will confirm whether the poke was successfully sent or provide error details if it failed.
No binary data output is involved in this operation.
Dependencies
- Requires connection to a OneBot API endpoint.
- Needs an API authentication credential configured in n8n (e.g., an API key or token).
- The node uses internal helper methods to fetch lists of groups and group members dynamically for property options.
Troubleshooting
Common issues:
- Invalid or missing group ID or member ID may cause the poke action to fail.
- Insufficient permissions: The bot must have appropriate rights in the group to perform poke actions.
- Network or API errors when connecting to the OneBot service.
Error messages:
- Errors returned from the API will be included in the output JSON under an
errorfield. - If the node cannot load group or member lists, it may show errors indicating failure to retrieve login info or group/member data.
- Errors returned from the API will be included in the output JSON under an
Resolutions:
- Verify that the group and member IDs are correct and accessible.
- Ensure the bot has necessary permissions in the group.
- Check API credentials and network connectivity.
- Review logs for detailed error messages.
Links and References
Note: This summary is based on static analysis of the provided source code and property definitions, focusing on the "群组" resource and "群戳一戳" operation only.