Support:Manual For Integrating Alibaba Cloud Enterprise Service in Feishu

Step 1: Create a Custom App

1. Please log in to [Feishu Open Platform].

2. Create a new Custom App in the platform, define the application name and description (we recommend that you specify Alibaba Cloud Enterprise Service to facilitate queries and access by members of the organization).

Step 2: Add Application Features

In the left navigation bar of the application console, find and click [Add Features]. On this page, add the following two core features to your app:

1. Web app

   1. Purpose: Allows your team to open and use the Alibaba Cloud Enterprise Service application directly in Feishu.

   2. Operation: Find the "Web app" card and click + to add it. You can follow [Step 4] to add the desktop-side link.

2. Bot

   1. Purpose: Enables the Alibaba Cloud Enterprise Service application to send you message notifications so that you do not miss important information.

   2. Operation: Find the "robot" card and click + to add it.

Step 3: Obtain and provide application credentials

To enable the Feishu channel, provide your organization name, App ID, and App Secret.

1. Organization name: In the upper-right corner of the [Feishu Open Platform], the text below your name is the organization name. The organization name also appears below the upper-left corner of the new application as "Production app@ (Organization Name)".

2. After the application is created, find and copy the App ID and App Secret on the Credentials & Basic Info page.

3. Provide the organization name, App ID, and App Secret to your TAM for configuration (self-service configuration will be supported later).

4. Copy your organization name, App ID, and App Secret into the [Alibaba Cloud Value-Added Service Console > My Expert Services > Channel Management > Add Channel > Feishu Channel > Enter Credentials] section.

Step 4: Configure web app link

Enter the desktop homepage URL in the web app configurations. The format is as follows. Replace {appId} with the actual App ID of your web app:

https://ailink.gts.work/feishu/{appId}/workbench

We recommend that you select "New tab in Feishu".

Step 5: Activate application permissions

To ensure that the application functions properly (such as sending message notifications and displaying information cards), enable the following permissions for the application.

{
 "scopes": {
 "tenant": [
 "application:application:self_manage",
 "cardkit:card:write",
 "im:message:send_as_bot",
 "tenant:tenant:readonly"
 ],
 "user": []
 }
}

Permission points：
application:application:self_manage
tenant:tenant:readonly
im:message:send_as_bot
cardkit:card:write

Step 6: Security Settings

To ensure that the application runs properly, complete the following security settings on the Feishu developer page.

https://ailink.gts.work/feishu/{appId}
https://ailink.gts.work/feishu/{appId}/workbench
https://ailink.gts.work/thirdparty/feishu/{appId}/login
https://ailink.gts.work/thirdparty/feishu/{appId}/oauth2/callback
https://ailink.gts.work/feishu/{appId}/person/inviteToGroup

https://ailink.gts.work

Step 7: Version Management and Release

For the initial release and subsequent application changes, enter the version number and update description in [Version Management & Release], and then save and release.

Note: You can set the Application Available Range to all or some members of an organization as needed.

Done! Please contact TAM to enter the group

You have completed all configurations. Contact your Technical Service Manager (TAM) to obtain the group joining link. You can communicate with your TAM in real time through the application, receive ticket notifications, track service progress, and enjoy a seamless support experience.

Special instructions and frequently asked questions

1. [Network Configuration] IP Whitelist (if any)

If your enterprise network environment uses a strict IP or domain name access whitelist, add the application website to the whitelist. Otherwise, the application cannot open in Feishu.

2. [Cost Reminder] Feishu Version and API Call Restrictions

   • If you are using the free version of Feishu, the upper limit of API calls for custom app is 10,000 per month.

   • If you are using the paid version of Feishu, this restriction does not apply.

   • Note: The main API call scenario of this application is to send @ message notifications through the bot. Message notifications are subject to fatigue control, and each user receives at most one notification every 10 minutes. Evaluate this usage based on your team's communication frequency. The 10,000 per month limit applies to the total number of calls across all APIs. If you are using the free version, account for other API calls as well. For charged API details, see https://open.feishu.cn/document/server-docs/api-call-guide/server-api-list?charge=all

Login authorization

Click the application created in [Part 1] to complete authorization (for identification only) and log in.

Service main group

After you activate the Feishu channel service, the system automatically binds the corresponding Enterprise Support Plan service group for you. You can directly contact the Alibaba Cloud Technical Service Manager (TAM) and other support personnel in the group.

Note: If you do not see a service main group in your interface, contact your Technical Service Manager (TAM) to add it for you.

Ticket group

You can communicate with technical engineers about specific issues within the ticket group.

• If the issue is urgent, click [Reminder] to expedite the processing progress.

• For serious incidents such as data loss, data corruption, or business unavailability, click [Emergency] to trigger the emergency response mechanism for priority intervention.

Group Member Management

The [Gourp Member Management] function is available in both the service group and the ticket group.

Communication within the group

In the group chat, you can directly @ Alibaba Cloud service personnel or colleagues to solve problems collaboratively.