Lark Messenger icon

Lark Messenger

Lark Messenger Management
Join our community

Actions38

Overview

This node, named "Lark Messenger," is designed to manage group chat settings within the Lark messaging platform. Specifically, the "Updates Group Speech Scopes" operation allows users to modify moderation settings and manage the list of moderators in a group chat. This can be useful for administrators who want to control who can moderate conversations or adjust speech permissions dynamically.

Practical examples include:

  • Adding or removing moderators in a team chat to delegate conversation control.
  • Changing the group's moderation policy to restrict or allow certain types of messages.
  • Automating group management workflows based on external triggers or events.

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 where the speech scopes will be updated. Required to specify which group to modify.
Moderation Setting A string representing the new moderation setting for the group. This controls how speech is moderated within the group.
Moderator Added List A list of user identifiers to add as moderators to the group. Each item is a string representing a user ID.
Moderator Removed List A list of user identifiers to remove from the group's moderators. Each item is a string representing a user ID.
Custom Body Allows sending a fully custom JSON body for the request instead of using the predefined fields. Useful for advanced users who want to customize the API call beyond the standard options.
Options > Use Custom Body Boolean flag indicating whether to use the Custom Body field instead of the standard properties.

Output

The node outputs JSON data representing the response from the Lark API after updating the group speech scopes. This typically includes confirmation of the update status and any relevant metadata returned by the API.

If the node supports binary data output, it would represent files or media related to the group or moderation settings, but this operation primarily deals with JSON data.

Dependencies

  • Requires access to the Lark Open APIs endpoint at https://open.larksuite.com/open-apis.
  • Needs either a Tenant Token credential or OAuth2 credential configured in n8n for authentication.
  • Proper permissions must be granted to the credentials used to modify group chat settings.

Troubleshooting

  • Invalid Chat Id: If the provided Chat Id does not correspond to an existing group, the API will return an error. Verify the Chat Id is correct and accessible by the authenticated user.
  • Insufficient Permissions: Errors may occur if the authentication token lacks rights to modify group settings. Ensure the API credentials have appropriate scopes.
  • Malformed Request Body: When using the Custom Body option, ensure the JSON is valid and matches the expected schema; otherwise, the API will reject the request.
  • Empty Moderator Lists: Adding or removing empty lists might cause no changes; verify that the lists contain valid user IDs.
  • Network Issues: Connectivity problems to the Lark API endpoint will result in request failures; check network and proxy settings.

Links and References

Discussion