Actions38
- Message Actions
- Message Buzz Message Actions
- Message Batch Message Actions
- Message Image Actions
- Message File Actions
- Message Message Card Actions
- Message Message Reaction Actions
- Group Actions
- Group Group Member Actions
- Group Group Announcement Actions
Overview
This node interacts with the Lark Messenger API to manage group members, specifically allowing users to specify group administrators within a chat group. It is useful in scenarios where an organization or team uses Lark Messenger for communication and needs to programmatically assign or update the list of administrators for a particular group chat. For example, an admin automation workflow could update group managers based on role changes in an HR system.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method of authenticating API requests. Options: "Tenant Token" (using a tenant-level API token) or "OAuth2" (using OAuth2 authentication). |
| Chat Id | The unique identifier of the group chat where administrators are to be specified. This ID identifies the target group. |
| Manager Ids | A collection of user IDs to be set as group administrators. Multiple manager IDs can be added. |
| Custom Body | An optional JSON body that can be used to override the default request payload when specifying group administrators. |
| Use Custom Body | Boolean option to toggle whether to send the custom JSON body instead of the standard structured input. |
Output
The node outputs JSON data representing the response from the Lark Messenger API after attempting to specify the group administrators. This typically includes confirmation of success or details about any errors encountered. The output does not include binary data.
Dependencies
- Requires access to the Lark Messenger API.
- Requires either a tenant token credential or OAuth2 credential configured in n8n for authentication.
- Network connectivity to
https://open.larksuite.com/open-apis.
Troubleshooting
- Invalid Chat Id: If the provided chat ID is incorrect or does not exist, the API will return an error. Verify the chat ID format and existence.
- Authentication Errors: Using invalid or expired credentials will cause authentication failures. Ensure the API key or OAuth2 token is valid and has necessary permissions.
- Empty Manager Ids: Submitting an empty list of manager IDs may result in an error or no changes. Make sure to provide at least one valid user ID.
- Custom Body Format: When using the custom body option, ensure the JSON structure matches the API requirements; otherwise, the request may fail.
- API Rate Limits: Frequent calls might hit rate limits imposed by Lark Messenger API. Implement retries or backoff strategies if needed.
Links and References
- Lark Messenger API Documentation (for Chat ID description and API details)
- n8n Documentation on Credentials (for setting up API authentication)