Lark Messenger icon

Lark Messenger

Lark Messenger Management

Actions38

Overview

This node interacts with the Lark Messenger API to obtain information about group announcements within a specified group chat. It is useful for scenarios where you need to programmatically retrieve the current announcement message or details from a group in Lark Messenger, such as monitoring updates, automating notifications, or integrating group announcement data into other workflows.

For example, you might use this node to fetch the latest announcement of a project team’s group chat and then send a summary email to stakeholders automatically.

Properties

Name Meaning
Authentication Method of authenticating with Lark Messenger API. Options: "Tenant Token" (using a tenant-level API token) or "OAuth2" (using OAuth2 authentication).
Chat Id The unique identifier of the group chat whose announcement information you want to obtain.
Options Additional optional settings:
• Use Custom Body: Whether to send a custom request body instead of the default one (boolean).

Output

The node outputs JSON data containing the group announcement information retrieved from the Lark Messenger API. This typically includes fields such as the announcement content, timestamp, author, and any related metadata provided by the API.

If the API supports binary data for announcements (e.g., attachments), the node would handle it accordingly, but based on the provided code and properties, the output focuses on JSON structured announcement details.

Dependencies

  • Requires access to the Lark Messenger API.
  • Requires either a Tenant Token credential or OAuth2 credential configured in n8n for authentication.
  • The base URL for API requests is https://open.larksuite.com/open-apis.
  • Proper permissions must be granted to the API credentials to read group announcement information.

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 the group exists.
  • Authentication Errors: Using invalid or expired credentials will cause authentication failures. Ensure that the Tenant Token or OAuth2 token is valid and has necessary scopes.
  • Permission Denied: The authenticated user or token may lack permission to access the group announcement. Check API permissions and group membership.
  • Use Custom Body Misconfiguration: If "Use Custom Body" is enabled but the custom body is malformed or incomplete, the request may fail. Double-check the custom body structure if used.

Links and References

Discussion