飞书项目 Trigger icon

飞书项目 Trigger

当飞书项目发生指定事件时，通过 Webhook 回调触发工作流

飞书项目 Trigger

AI-generated

Overview

This node acts as a trigger for Feishu Project events, activating workflows when specified events occur in the Feishu Project. It listens for webhook callbacks from Feishu Project and can filter events based on event types, source types, project spaces, work item types, and specific work item fields. This is useful for automating workflows in response to project management activities such as task creation, deletion, updates, plugin events, and more.

Use Case Examples

  1. Automatically trigger a workflow when a new work item is created in a specific Feishu Project space.
  2. Filter and respond only to plugin installation events to automate plugin management tasks.
  3. Verify webhook signatures to ensure callbacks are authentic and secure.

Properties

Name Meaning
监听事件 Select the events to listen for; choosing 'All events' will receive all callbacks.
验证签名 Whether to verify the signature in the callback request to ensure it comes from Feishu Project.
回调 Token The callback token from Feishu Project used for signature verification, required if signature verification is enabled.
选项 Additional filtering options for allowed sources, spaces, work item types, and work item fields.

Output

JSON

  • event_type - The type of the event triggered in Feishu Project.
  • source - The source type of the event (e.g., normal user operation, OpenAPI, system behavior, automation).
  • project_key - The Feishu Project space identifier where the event occurred.
  • work_item_type_key - The type key of the work item involved in the event.
  • field_info
    • ``
      * field_key - Keys of the fields modified in the event, applicable for field modification events.
  • data - The full payload data received from the Feishu Project webhook callback.

Dependencies

  • An API key credential for Feishu Project API access

Troubleshooting

  • Invalid signature error: Ensure the callback token and plugin ID are correctly configured and match the Feishu Project settings.
  • Ignored events: Check that the event type, source, space, work item type, and fields match the configured filters to avoid unintentional ignoring of valid events.
  • Webhook setup: Confirm the webhook URL is correctly set in the Feishu Project callback address configuration.

Discussion