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
The "Update Group Announcement Info" operation in the "Messenger Group Group Announcement" resource allows users to modify the announcement information of a specific group chat within Lark Messenger. This node is useful for automating updates to group announcements, such as posting new messages or changing existing announcement content programmatically.
Practical scenarios include:
- Automatically updating group announcements based on external triggers (e.g., project status changes).
- Managing multiple group announcements centrally via workflows.
- Integrating with other systems to keep group members informed without manual intervention.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method of authenticating API requests. Options: Tenant Token, OAuth2. |
| Chat Id | The unique identifier of the group whose announcement you want to update. This ID specifies which group's announcement will be modified. |
| Requests | A collection of items representing the update requests to apply to the group announcement. Each item is a string describing an individual update action or content. |
| Revision | A string representing the revision number or version of the announcement info being updated. This can be used for concurrency control or to specify the exact version to update. |
| Custom Body | Allows sending a fully custom JSON body instead of using the predefined properties. Useful for advanced use cases where the standard fields do not cover all requirements. |
| Use Custom Body | Boolean option to toggle between using the standard input properties or providing a custom JSON body for the request. |
Output
The node outputs JSON data representing the response from the Lark Messenger API after attempting to update the group announcement. This typically includes confirmation of the update, any updated announcement details, or error information if the update failed.
No binary data output is indicated for this operation.
Dependencies
- Requires valid authentication credentials, either a Tenant Token or OAuth2 token, configured in n8n.
- Depends on access to the Lark Suite Open APIs at
https://open.larksuite.com/open-apis. - Proper permissions to modify group announcements in the target Lark workspace are necessary.
Troubleshooting
- Invalid Chat Id: If the provided Chat Id does not correspond to an existing group or the user lacks permission, the API will return an error. Verify the Chat Id and permissions.
- Authentication Errors: Using incorrect or expired tokens will cause authentication failures. Ensure that the API credentials are valid and have not expired.
- Revision Conflicts: Providing an incorrect or outdated revision string may result in update conflicts. Confirm the current revision before updating.
- Malformed Requests: When using the custom body option, ensure the JSON structure matches the API specification exactly to avoid errors.
- Empty Requests Array: Submitting an empty or improperly formatted requests array will likely cause the API to reject the update.
Links and References
- Lark Messenger API Documentation — For detailed information about Chat Ids and group announcement API usage.