Lark Integration

Modified on Wed, 15 May 2024 at 03:36 AM

Integrating Lark with Josys enables the IT Admin to view the user accounts.


 

Key benefits


When you integrate Josys with Lark, you can view a list of user accounts, including their status, roles, department, and designation.


Note: Josys supports multiple Lark integrations.


Prerequisites  


Before you begin with the integration, make sure that you have:

  • A Lark admin account
  • A Starter, Pro, or an Enterprise plan
  • The Client ID and Client Secret details


Get the Client ID and Client Secret


Step 1: Log in to Lark using an admin account. Click Create App.



Step 2: Click Create Custom App.


 

Step 3: Enter a Name and Description for the app, and select or upload a desired Icon. Click Create



Step 4: Select the Permissions & Scopes option from Development Configuration. Enter the following scopes and click Add in bulk.


contact:contact.base:readonly

contact:department.base:readonly

contact:department.organize:readonly

contact:user.base:readonly

contact:user.department:readonly

contact:user.department_path:readonly

contact:user.dotted_line_leader_info.read

contact:user.email:readonly

contact:user.employee:readonly

contact:user.employee_id:readonly

contact:user.gender:readonly

contact:user.phone:readonly

contact:user.user_geo

tenant:tenant:readonly

contact:group:readonly

admin:app.info:readonly



Step 5: Click Confirm.



Step 6: Select the Security Settings option from Development Configuration. Enter the following Redirect URL and click Add.

https://app.josys.it/admin/integrations/callback/lark



Step 7: Select the Version Management & Release option from App Versions and click Create a version.



Step 8: Enter the App version, Update Notes, and click Save.



Step 9: Click Submit for release.


Step 10: Select the Credentials & Basic Info option from Basic Info. Copy the App Id and App Secret to use later in the integration steps.




Steps to Integrate 

 

Step 1: Select Lark from the App Catalog in the Apps section.



Step 2: Provide a suitable Label for identification. Enter the Client ID and Client Secret as copied in the previous section. Click Next to proceed.



Step 3: Log in to Lark using an admin account. Follow the guided steps to authorize Josys and complete the integration.



Step 4After the integration is complete, allow some time for data synchronization. You can now view and perform required actions from the Managed Apps in the Apps section.




Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select atleast one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article