Feishu Node icon

Feishu Node

Feishu Node

Actions61

Overview

This custom n8n node is designed to interact with Feishu's calendar service, specifically for the resource "日历" (Calendar) and the operation "查询日历信息" (Query Calendar Information). The node allows users to retrieve detailed information about a specific calendar by providing its ID. This can be useful in scenarios where you need to automate workflows involving calendar data, such as synchronizing events, auditing calendar details, or integrating calendar information into other business processes.

Practical Example:
A user wants to fetch metadata about a particular Feishu calendar (e.g., team meetings calendar) to display it on a dashboard or to trigger further automation based on its properties.

Properties

Name Type Meaning
日历 ID String The unique identifier of the calendar. You can obtain this via interfaces like querying the main calendar info, listing calendars, or searching calendars. This property is required.

Output

The node outputs a JSON object containing the calendar information retrieved from Feishu. The exact structure depends on the Feishu API response for the queried calendar, but typically includes fields such as:

{
  "calendar_id": "string",
  "summary": "string",
  "description": "string",
  "permissions": "object",
  ...
}

If an error occurs and "Continue On Fail" is enabled, the output will include an error field describing the issue.

Dependencies

  • Feishu API: Requires access to the Feishu platform.
  • Credentials: Needs valid Feishu API credentials configured in n8n (feishuCredentialsApi).
  • n8n Configuration: Ensure that the Feishu credentials are set up in your n8n instance.

Troubleshooting

  • Missing Method Error: If you see an error like 未实现方法: 日历.查询日历信息, it means the requested resource-operation combination is not implemented. Double-check the resource and operation names.
  • Authentication Errors: Invalid or missing Feishu credentials will prevent the node from accessing the API. Make sure your credentials are correct and have the necessary permissions.
  • API Errors: If the Feishu API returns an error (e.g., invalid calendar ID), the node will output an error message in the result if "Continue On Fail" is enabled, or throw an error otherwise.
  • Common Fixes:
    • Verify the "日历 ID" is correct and accessible.
    • Ensure your Feishu app has the required scopes/permissions.

Links and References

Discussion