Lark Messenger icon

Lark Messenger

Lark Messenger Management
Join our community

Actions38

Overview

This node interacts with the Lark Messenger API to manage group members, specifically allowing the deletion of group administrators from a specified group. It is useful in scenarios where you need to programmatically remove one or more administrators from a group chat, such as managing permissions dynamically based on external events or automating group administration tasks.

For example, if an organization wants to revoke admin rights from certain users after a project ends, this node can be used to automate that process by specifying the group and the user IDs to remove as admins.

Properties

Name Meaning
Authentication Method of authentication to use: either "Tenant Token" (an API key credential) or "OAuth2" (OAuth2 token).
Chat Id The unique identifier of the group chat from which administrators will be removed.
Manager Ids A list of user IDs representing the administrators to delete from the group. Multiple IDs can be provided.
Use Custom Body Boolean option to specify whether to send a custom JSON body instead of the standard format.
Custom Body When "Use Custom Body" is enabled, this JSON object is sent as the request body, allowing full customization of the API call payload.

Output

The node outputs JSON data returned by the Lark Messenger API after attempting to delete the specified group administrators. This typically includes success status and any relevant messages or error details from the API response.

No binary data output is produced by this operation.

Dependencies

  • Requires access to the Lark Messenger API.
  • Requires either a Tenant Token or OAuth2 credentials configured in n8n for authentication.
  • Network connectivity to https://open.larksuite.com/open-apis.

Troubleshooting

  • Invalid Chat Id: If the provided group ID is incorrect or does not exist, the API will return an error. Verify the group ID matches the target group.
  • Invalid Manager Ids: If any user ID in the manager_ids list is invalid or not an administrator, the API may reject the request or partially fail. Ensure all IDs are valid admins.
  • Authentication Errors: Using incorrect or expired credentials will cause authentication failures. Confirm that the Tenant Token or OAuth2 token is valid and has necessary permissions.
  • Custom Body Format Issues: When using the custom body option, ensure the JSON structure matches the API requirements exactly to avoid malformed request errors.

Links and References

Discussion