Feishu Node

Overview

This node is designed to forward messages within the Feishu platform. It allows users to specify an existing message by its ID and send (forward) it to another recipient identified by various types of IDs such as Open ID, Union ID, User ID, Email, or Chat ID. This functionality is useful in scenarios where automated workflows need to redistribute or share messages across different users or groups without manual intervention.

Practical examples include:

• Automatically forwarding important notifications or alerts to specific team members.
• Redistributing customer support messages to relevant departments.
• Sharing announcements or updates from one chat to another group or user.

Properties

Name	Meaning
待转发的消息的ID	The ID of the message that you want to forward. This identifies the original message to be sent to another recipient.
消息接收者 ID 类型	The type of identifier used for the message recipient. Options include: - Open ID: Identifies a user within a specific application. - Union ID: Identifies a user across multiple applications under the same developer. - User ID: Identifies a user within a tenant. - Email: Uses the user's email address. - Chat ID: Identifies a group chat.
消息接收者 ID	The actual ID value of the recipient, corresponding to the selected ID type.
UUID	A custom unique string used to deduplicate requests when forwarding messages. Optional but helps prevent sending duplicates.

Output

The node outputs JSON data representing the result of the forward message operation. This typically includes confirmation details such as success status and any metadata returned by the Feishu API about the forwarded message.

If the node supports binary data output (not explicitly shown here), it would represent any media or attachments associated with the forwarded message.

Dependencies

• Requires an API key credential for authenticating with the Feishu platform.
• Needs proper configuration of the Feishu API credentials within n8n.
• Depends on the Feishu API endpoints for message forwarding.

Troubleshooting

• Common issues:

  • Invalid or missing message ID: Ensure the message ID provided exists and is accessible.
  • Incorrect recipient ID or ID type: Verify that the recipient ID matches the selected ID type.
  • Duplicate forwarding attempts: Use the UUID property to avoid duplicate message forwarding.
  • Authentication errors: Confirm that the API key credential is valid and has necessary permissions.

• Error messages:

  • "未实现方法" (Unimplemented method): Indicates the requested resource-operation combination is not supported; check if the resource and operation names are correct.
  • API errors related to invalid parameters or permissions will be surfaced; review the error message and adjust inputs accordingly.

Links and References

• Feishu Developer Documentation
• Guides on obtaining various user identifiers (Open ID, Union ID, User ID, Chat ID) can be found in the Feishu developer docs linked above.