Search...
Menu

How to integrate

Ensure you have Admin access to both Leiga integration settings and Slack Workspace.

Step1. Create a custom app in Lark

1. Open Feishu Admin Select「Settings-Organization Info」, find 「Organization ID」and copy to LigaAI integration setting page.

2. OpenFeishu Open PlatformClick 「Create Custom App」to open DevOps platform

(1) Click 「Create Custom App」,create an App following the information below

App Name: LigaAI Assistant

Description: Next-generation intelligent development management platform - LigaAI

Icon: Click the link on LigaAI integration setting page to download LigaAI's logo


(2) After creating the app, you will see the newly created app in the list of enterprise self-built apps. Click to enter the app details page; select "Credentials & Basic Info" in the left navigation menu, and fill in the App ID and App Secret on the LigaAI integration setting page.


Step2. Configuration

1. Features configuration

Click 「Features」to unfold the menu in Lark application info

(1) Select "Web Application", click the "Add features" button, and fill in the following addresses in the web application configuration "Desktop homepage" and "Mobile homepage" and save

Desktop homepage:(Check for the LigaAI integration setting page)

Mobile Home Page:(Check for the LigaAI integration setting page)

(2) Select 「Extension scenarios for Web app feature」, enable 「Message shortcut」;Fill in the address in 「Desktop」and 「Mobile」; and Fill in 「Description」according to the infomation listed

(Check for the LigaAI integration setting page)

Action name: Add to LigaAI todo

Action description: Transferring messages to LigaAI todo with one click.


(3) Enable 「Bot」, fill in the address listed in 「Message Card Request URL」and save

(Check for the LigaAI integration setting page)


2. Permissions

Please fill in the authorities below for the Enterprise Self-establish Apps in authorities management

  • Obtain department's organizational structure in contacts
  • Read Contacts as an app
  • Read and send messages in private and group chats
  • Send batch messages to multiple users
  • Obtain private messages sent to the bot
  • Read group chat messages mentioning the bot
  • Obtain group messages mentioning the bot
  • Read private messages sent to the bot
  • Obtain and update group information
  • Read group information
  • Obtain group information


3. Event Subscriptions

Select 「Event Subscriptions」in Feishu app info

(1) Please fill in「Request URL」with the address listed

(Check for the LigaAI integration setting page)

(2) Click on "Event Subscription - Add Event", check the following events in the search results, and then click on "Finish".

Event Name:

  • User and bot chats created for the first time (V1.0)
  • Contact scope updated (V2.0)
  • Contacts updates (V1.0)
  • Message received (V2.0)
  • message.recall (V2.0)
  • Group disbanded (V2.0)
  • Group configuration changed (V2.0)
  • Bot added to group (V2.0)
  • Bot removed from group (V2.0)


4. Security Settings

Select 「Security Settings」in Feishu application info, fill in the listed address in「H5 trusted domains」and save

(Check for the LigaAI integration setting page)


5. App Release

Select 「App Versions」-「Version Management & Release」

(1) Click 「Creat a version」

  • Fill in the application version number and update description (custom); select "Default feature on mobile" as "Bot" and "Default feature on dekstop" as "Web App"
  • Set 「Availability」 according to the need of your team. If you want to change the parameter in the future, you can create a version and release again
  • Save the settings, click 「sumit for release」

(2) Set the application availability range

Note: After the app is successfully published, LigaAI Assistant will send an authorization invitation message to all members within the setting via Feishu.

  • If the entire enterprise will be officially enabled for LigaAI Feishu integration: optionally all members;
  • If only individual departments start using it: some members can be selected, checking only the departments that use it;
  • If you are still in the trial phase, you can check only yourself, or other colleagues participating in the trial, so as not to disturb other colleagues.


(3) After you create version and sumit release, Feishu admins will recieve the request and need to go to Version Management & Release for approval.


6. Authorization

After the app is successfully published, you will receive a LigaAI assistant welcome card. Click the "Go to authorize" button below the welcome card to complete the Feishu authorization operation for your LigaAI account.


Previous
LigaAI for Lark Application
Next
Development Tools
Last modified: 2023-05-26Powered by