Feishu Node icon

Feishu Node

Feishu Node

Actions106

Overview

This node interacts with the Feishu platform to retrieve user IDs based on provided phone numbers or email addresses. It is particularly useful in scenarios where you need to map contact information (phone or email) to internal user identifiers within Feishu, such as for syncing user data, managing access, or integrating with other systems that require user IDs.

For example, if you have a list of employee emails or mobile numbers and want to fetch their corresponding Feishu user IDs (Open ID, Union ID, or User ID), this node can perform batch queries efficiently, supporting up to 50 entries per request.

Properties

Name Meaning
返回的用户ID类型 The type of user ID to return. Options: Open ID, Union ID, User ID.
用户邮箱列表 List of user emails to query, up to 50 entries.
用户手机号列表 List of user mobile phone numbers to query, up to 50 entries.
是否包含离职员工 Whether to include users who have resigned (boolean).

Output

The node outputs an array of JSON objects, each containing the user ID(s) corresponding to the input emails or mobile numbers. The exact structure depends on the Feishu API response but generally includes mappings from the queried contact info to the requested user ID type.

If any errors occur during processing individual items, error details are included in the output for those items when "continue on fail" is enabled.

No binary data output is produced by this node.

Dependencies

  • Requires an API key credential for Feishu platform authentication.
  • Needs proper configuration of Feishu API credentials in n8n.
  • Relies on Feishu's user management API endpoints to fetch user IDs.

Troubleshooting

  • Common issues:

    • Exceeding the maximum number of emails or mobiles (more than 50) will likely cause errors.
    • Providing invalid or incorrectly formatted emails or phone numbers may result in no matches or API errors.
    • Missing or incorrect API credentials will cause authentication failures.

  • Error messages:

    • "未实现方法: resource.operation" indicates that the selected resource-operation combination is not implemented.
    • API-related errors will be surfaced with messages from Feishu's API; ensure credentials and parameters are correct.
    • If "continue on fail" is disabled, the node stops execution on the first error; enabling it allows partial success.

Links and References

Discussion