Feishu Node icon

Feishu Node

Feishu Node

Overview

This node is designed to interact with the Feishu (Lark) platform, specifically for the "消息" (Message) resource and the "批量撤回消息" (Batch Recall Messages) operation. It allows users to batch recall (retract) previously sent messages by providing a batch message task ID. This is useful in scenarios where an organization needs to retract multiple messages that were sent out in bulk, such as correcting mistakes or recalling sensitive information.

Practical Example:
If your company accidentally sends out an incorrect announcement to all employees via Feishu, you can use this node to quickly recall all those messages using the batch message task ID returned from the original send operation.

Properties

Name Type Meaning
待撤回的批量消息任务ID String The batch message task ID to be recalled. This ID is obtained from the message_id field in the response of the batch send message API request.

Output

The node outputs a JSON object for each input item processed. The structure of the output depends on the response from the Feishu API for the batch recall operation. If an error occurs and "Continue On Fail" is enabled, the output will include an error field with the error message (and possibly additional error details if available).

Example Success Output:

{
  // ...fields as returned by the Feishu API for batch recall
}

Example Error Output (when Continue On Fail is enabled):

{
  "error": "Error message here"
}

Dependencies

  • Feishu Account & API Access: Requires valid Feishu credentials configured in n8n (feishuCredentialsApi).
  • n8n Configuration: The node must be properly set up within an n8n workflow with access to the required credentials.

Troubleshooting

  • Missing Method Error:

    • Message: 未实现方法: message.message:batchRecall
    • Cause: The selected resource/operation combination is not implemented in the node.
    • Solution: Double-check that you have selected the correct resource and operation, and ensure the node version supports it.
  • API Errors:

    • If the Feishu API returns an error (e.g., invalid or expired batch message ID), the node will output an error message.
    • Solution: Verify that the provided batch message task ID is correct and has not expired.
  • Credential Issues:

    • If credentials are missing or invalid, the node will fail to authenticate with Feishu.
    • Solution: Ensure that the Feishu credentials are correctly configured in n8n.

Links and References

Discussion