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 allows users or bots to voluntarily join a group chat in Lark Messenger by specifying the target group chat ID. It is useful for automating the process of adding participants to group conversations, such as onboarding new team members into project chats or integrating bots that provide notifications or services within group chats.
Practical examples include:
- Automatically joining a bot to a project group chat to send updates.
- Adding a user account to a department group chat based on workflow triggers.
- Enabling integration flows where external systems join group chats to monitor discussions.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method of authentication to use: either "Tenant Token" (an API key credential) or "OAuth2" (OAuth 2.0 token). |
| Chat Id | The unique identifier of the group chat to join. Required. |
| Use Custom Body | Boolean option to specify whether to send a custom JSON body instead of the default request body. |
| Custom Body | A JSON object representing a custom request body to send if "Use Custom Body" is enabled. |
Output
The node outputs JSON data representing the response from the Lark Messenger API after attempting to join the specified group chat. This typically includes success status and any relevant metadata about the join operation.
No binary data output is involved.
Dependencies
- Requires an active Lark Messenger API credential, either via a Tenant Token or OAuth2 authentication.
- The node communicates with the Lark Open APIs endpoint at
https://open.larksuite.com/open-apis. - Proper permissions must be granted to the API credentials to allow joining group chats.
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 ensure it corresponds to an existing group chat.
- Authentication Errors: Using invalid or expired credentials will cause authentication failures. Ensure the Tenant Token or OAuth2 token is valid and has necessary scopes.
- Permission Denied: The authenticated user or bot may lack permission to join the specified group chat. Confirm that the API credentials have rights to add members or join groups.
- Custom Body Issues: When using a custom JSON body, malformed JSON or missing required fields can cause request failures. Validate the JSON structure before sending.