Feishu Node

Actions61

Overview

This node enables forwarding a message in Feishu (Lark) to another user or group. It is useful for automating workflows where messages need to be programmatically redirected, such as relaying notifications, sharing information with different teams, or implementing approval flows.

Practical examples:

Automatically forward important alerts from one chat to a specific user or group.
Route customer support messages to the appropriate department.
Implement escalation procedures by forwarding unresolved issues to supervisors.

Properties

Name	Type	Meaning
待转发的消息的ID	String	The ID of the message to be forwarded. This identifies which message will be sent to the new recipient.
消息接收者 ID 类型	Options	The type of identifier used for the message recipient. Options include Open ID, Union ID, User ID, Email, and Chat ID, each corresponding to different ways of identifying users or groups in Feishu.
消息接收者 ID	String	The actual ID of the recipient, matching the selected ID type. This specifies who will receive the forwarded message.
UUID	String	A custom unique string for deduplication purposes when forwarding messages. This helps prevent sending duplicate messages if the same request is made multiple times.

Output

The node outputs a JSON object for each processed item. The structure typically includes the result of the forward operation as returned by the Feishu API. If an error occurs and "Continue On Fail" is enabled, the output will contain an error field with the error message (and possibly additional error details).

Example success output:

{
  "data": {
    // ...fields returned by Feishu's message forward API, e.g., message_id, status, etc.
  }
}

Example error output (when Continue On Fail is enabled):

{
  "error": "Error message here"
}

Dependencies

Feishu account: You must have valid Feishu credentials configured in n8n (feishuCredentialsApi).
API access: The Feishu app must have permission to forward messages on behalf of users.
n8n configuration: Ensure the node is properly authenticated using the required credentials.

Troubleshooting

Missing or invalid credentials: If credentials are not set up or are incorrect, the node will fail to authenticate with Feishu.
Invalid message or recipient ID: Providing an incorrect message ID or recipient ID will result in errors from the Feishu API.
Permission errors: If the Feishu app lacks necessary permissions, the API may reject the request.
Common error messages:
- "未实现方法: message.message:forward": Indicates that the requested resource-operation combination is not implemented in the node.
- Errors with "NodeApiError": These usually come from the Feishu API; check the error details for more information.

How to resolve:

Double-check all input fields for correctness.
Ensure your Feishu app has the correct permissions.
Review the error message for hints about what went wrong.