Skip to main content

Integrate Feishu Approval Workflows

Connect Feishu approval workflows to NineData so that database DevOps tasks can use Feishu for approval.

Before you begin​

  • You have already created or joined an organization, and the organization has subscribed to DevOps Enterprise. Please ensure that your annual or monthly subscription is still active. For more information, please refer to Manage Organizations.
  • Your current account has been switched to the target organization. For more information, please refer to Switching to an Organization.
  • Sign in to the target Feishu organization with enterprise administrator permissions.
  • Sign in to NineData with system administrator permissions.

Notes​

  • System-reserved fields in the standard template cannot be modified.
  • The mobile phone number or email address of the Feishu account must match the corresponding NineData account.

Step 1: Create and publish a Feishu application​

  1. Open the Feishu Open Platform.
  2. Click Create Enterprise Self-Built App, enter the application name and description, select an icon, and click Create.
  3. In Credentials and Basic Information, record the App ID and App Secret.
  4. In Permission Management, use Batch Import/Export Permissions to grant the permissions required by the approval integration, then submit the request.
  5. Configure the data scope under Application Identity Permissions > Contacts > Data Scope Available to Permissions, and select All Members.
  6. Create and publish a version from Application Release > Version Management and Release.

Step 2: Bind the Feishu application in NineData​

  1. Sign in to the NineData Console.

  2. In the left navigation bar, click DevOps > Policy & Process.
  3. Open the Approval Process tab and click External approve channel.
  4. Under Feishu, click Configure.
  5. Enter the App ID and App Secret from Step 1. Select Auto-Initialize Approval Definitions if you want NineData to initialize the approval definitions, and click OK.
  6. Click the ID next to Configured in the Feishu channel card.
  7. Record the Callback url value.

Step 3: Configure callback events​

  1. Open the Feishu Open Platform and open the application from Step 1.
  2. Click Development Configuration > Events and Callbacks.
  3. Set the subscription method to Send events to the developer server, enter the callback URL from Step 2, and click Save.
  4. In Added Events, click Add Event, search for Approval Instance, select Approval Instance Status Change, and confirm.

Step 4: Adjust the default approval workflow​

  1. Open the Feishu Approval Admin.
  2. In Approval Management, find the default workflow created by NineData in Provided by Other Service Providers, and click its edit icon.
  3. On the Workflow Design tab, configure branches and approvers as required.
  4. Click Publish.

Step 5 (Optional): Create a custom approval workflow​

  1. In the Feishu Approval Admin, click Create Approval > Create Custom Approval.
  2. Configure the basic information, form design, workflow design, and additional settings. Record the definitionCode at the end of the browser URL, then publish the workflow.
  3. In NineData, open the external approval channel settings, open Approval Process Mapping Definition, and click Add Approval Process Definition.
  4. Select the Feishu application, enter a name, paste the definitionCode, map each Feishu field to its NineData field, and configure option mappings when required. Click OK.

Step 6: Enable the approval workflow​

  1. Sign in to the NineData Console.

  2. In the left navigation bar, click DevOps > Policy & Process.
  3. Open Approval Process, select the target workflow, and open Details.
  4. Select the task type, click Edit, enable Launch External Approval Workflow, select Feishu approval, select the corresponding Feishu workflow ID, and click OK.