Feishu Node icon

Feishu Node

Feishu Node

Actions61

Overview

This n8n custom node allows you to query a specific record from a Feishu (Lark) 多维表格 (Bitable) by its 记录ID (Record ID). It is useful for retrieving detailed information about a single row in a Bitable, such as when you need to look up or process data related to a particular entry. Common scenarios include fetching user-submitted form responses, looking up inventory items, or integrating with other systems that require precise record retrieval.

Practical Example:
You have a Feishu Bitable storing customer orders. Using this node, you can fetch the full details of an order by providing its Record ID, and then use the data in subsequent workflow steps (e.g., sending a confirmation email or updating another system).

Properties

Name Type Meaning
多维表格 Token String The unique token identifying your Feishu Bitable App. Required for authentication.
多维表格 ID String The unique identifier of the Bitable table you want to query.
记录ID String The unique ID of the record (row) you wish to retrieve from the table.
用户 ID 类型 Options The type of user ID to use (Open ID, Union ID, or User ID). Determines user context.
是否返回记录的分享链接 Boolean Whether to include a shareable link to the record in the response.
是否返回自动计算的字段 Boolean Whether to include automatically calculated fields in the returned data.

Output

  • The node outputs a JSON object containing the details of the requested record.
  • If "是否返回记录的分享链接" is enabled, the output will include a field with the shareable URL.
  • If "是否返回自动计算的字段" is enabled, the output will include computed fields.
  • In case of errors (and if "Continue On Fail" is enabled), the output will contain an error field with the error message.

Example Output:

{
  "fields": {
    "Name": "Alice",
    "Email": "alice@example.com"
    // ...other fields...
  },
  "record_id": "rec1234567890",
  "shared_url": "https://bitable.feishu.cn/..."
}

Note: Actual field names and structure depend on your Bitable schema and selected options.

Dependencies

  • Feishu (Lark) API: Requires access to Feishu's Bitable API.
  • API Credentials: You must configure feishuCredentialsApi in n8n with appropriate permissions.
  • Environment: No special environment variables are required beyond standard n8n credential setup.

Troubleshooting

  • Missing Method Error:

    • Message: 未实现方法: bitable.bitable:table:record:get
    • Cause: The specified resource/operation combination is not implemented in the node.
    • Solution: Double-check that you selected the correct Resource and Operation.

  • Authentication Errors:

    • Message: Errors related to invalid or missing credentials.
    • Solution: Ensure your Feishu credentials are correctly set up in n8n and have access to the target Bitable.

  • Record Not Found:

    • Message: Error indicating the record does not exist.
    • Solution: Verify the 记录ID (Record ID) is correct and exists in the specified table.

  • Field Mapping Issues:

    • If expected fields are missing, check your Bitable schema and ensure the correct options are selected for including shared links or automatic fields.

Links and References

Discussion