Lark Messenger icon

Lark Messenger

Lark Messenger Management

Actions38

Overview

This node interacts with the Lark Messenger API to determine whether a specific user or bot is a member of a given group chat. It is useful in scenarios where workflows need to verify membership status before performing actions such as sending messages, managing group settings, or automating group-related tasks.

For example, before sending a notification to a group, you might want to confirm that a particular user or bot is part of that group to avoid errors or unauthorized messaging.

Properties

Name Meaning
Authentication Method used for 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 to check membership against. This is required and must be provided as a string.
Options Additional optional settings:
- Use Custom Body: Boolean flag indicating whether to send a custom request body instead of the default one.

Output

The node outputs JSON data representing the result of the membership check. Typically, this will include information indicating whether the specified user or bot is a member of the group identified by the Chat Id.

If the node supports binary data output (not indicated here), it would generally represent attachments or media related to the group or membership status, but no such binary output is described in the provided code.

Dependencies

  • Requires access to the Lark Messenger API.
  • Needs either a Tenant Token or OAuth2 credentials configured in n8n for authentication.
  • The base URL for API requests is https://open.larksuite.com/open-apis.
  • Proper permissions on the API credentials to query group membership are necessary.

Troubleshooting

  • Invalid Chat Id: If the Chat Id is incorrect or does not exist, the API will likely return an error. Verify the Chat Id format and ensure the group exists.
  • Authentication Errors: Using invalid or expired credentials will cause authentication failures. Ensure the Tenant Token or OAuth2 token is valid and has the required scopes.
  • Permission Denied: The authenticated user or bot may lack permission to query group membership. Check API permissions and roles.
  • Use Custom Body Misconfiguration: If the "Use Custom Body" option is enabled but the custom body is malformed or incomplete, the request may fail. Validate the custom body structure if used.

Links and References

Discussion