Feishu Node

Actions61

Overview

This node enables batch sending of messages via Feishu (飞书), a popular collaboration and messaging platform. It supports multiple message types—including text, image, rich text, group card sharing, and interactive cards—and allows targeting users or departments by various identifiers. This is useful for automating notifications, announcements, or alerts to groups of users within an organization.

Practical examples:

Sending company-wide announcements to all employees in selected departments.
Notifying specific users about workflow events or approvals.
Broadcasting rich content (cards) with actionable elements to targeted user groups.

Properties

Name	Type	Meaning
消息类型	options	The type of message to send. Options: 文本 (text), 图片 (image), 富文本 (post), 分享群名片 (share_chat), 卡片 (interactive). Required.
消息内容	json	The content of the message, as a JSON structure. Used for text, image, post, and share_chat message types.
卡片内容	json	The content of the card, as a JSON structure. Used when 消息类型 is 卡片 (interactive). Reference: Feishu Card Documentation
部门 ID 列表	json	List of department IDs to which the message will be sent.
用户 Open_id 列表	json	List of user open_ids to receive the message.
用户 User_id 列表	json	List of user user_ids to receive the message.
用户 Union_id 列表	json	List of user union_ids to receive the message.

Output

The node outputs an array of items, each containing a json field. The structure of this field depends on the response from the Feishu API for the batch message send operation. In case of errors (when "Continue On Fail" is enabled), the output item will contain an error field with the error message, and possibly additional error details if available.

Example success output:

{
  "data": {
    // ...response data from Feishu API, such as message IDs, status, etc.
  }
}

Example error output:

{
  "error": "Error message here"
}

Dependencies

External Service: Requires access to the Feishu Open Platform API.
Credentials: Needs n8n credentials of type feishuCredentialsApi.
Environment: No special environment variables required beyond n8n credential configuration.

Troubleshooting

Missing Method Error:
If you see an error like 未实现方法: message.message:batchSend, it means the requested resource-operation combination is not implemented in the node. Double-check that you have selected valid options.
Authentication Errors:
Errors related to authentication (e.g., invalid credentials) will result in error messages from the Feishu API. Ensure your feishuCredentialsApi is correctly configured.
Invalid Input Data:
Supplying malformed JSON in properties like 消息内容 or 卡片内容 may cause API errors. Always validate your JSON structures before use.
Partial Failure Handling:
If "Continue On Fail" is enabled, failed items will appear in the output with an error field. Review these for troubleshooting individual failures.