Feishu Node icon

Feishu Node

Feishu Node

Actions106

Overview

This node integrates with Feishu's task management API to add members to a specified task. It is useful in scenarios where you want to programmatically assign or share tasks with users by specifying their identifiers and roles within the task. For example, automating team collaboration by adding assignees or observers to tasks based on workflow conditions.

Properties

Name Meaning
任务ID The unique identifier of the task to which members will be added.
用户 ID 类型 The type of user identifier used to specify members. Options: Open ID, Union ID, User ID.
成员 JSON array defining the members to add, including their id, role (e.g., assignee), and type.
幂等 Token An optional idempotency token to ensure the operation is performed only once if provided.

Output

The node outputs an array of JSON objects representing the result of adding members to the task. Each output item corresponds to an input item processed. The exact structure depends on the Feishu API response but generally includes confirmation of added members or error details if the operation failed.

No binary data output is produced by this node.

Dependencies

  • Requires an API key credential for authenticating with Feishu's API.
  • The node depends on Feishu's task management API endpoints to perform member additions.
  • Proper configuration of credentials in n8n is necessary for successful execution.

Troubleshooting

  • Common Issues:

    • Invalid or missing task ID can cause the operation to fail.
    • Incorrect user ID type or malformed members JSON may lead to API errors.
    • Missing or invalid API authentication will prevent the node from connecting to Feishu.
  • Error Messages:

    • "未实现方法: task.task:add_members" indicates the operation is not implemented or incorrectly referenced.
    • API errors returned from Feishu are captured and included in the output when "Continue On Fail" is enabled.
  • Resolutions:

    • Verify that the task ID exists and is correct.
    • Ensure the members JSON follows the required schema as per Feishu documentation.
    • Confirm that the API credentials are valid and have sufficient permissions.
    • Use the idempotency token to avoid duplicate member additions in retry scenarios.

Links and References

Discussion