Support:Panduan Integrasi Layanan Enterprise Alibaba Cloud di Lark

Langkah 1: Buat Aplikasi Kustom

1. Masuk ke [Lark Developer Platform].

2. Buat Custom App baru di platform tersebut, lalu tentukan nama dan deskripsi aplikasi (kami menyarankan menyertakan “Alibaba Cloud Enterprise Service” agar memudahkan pencarian dan akses oleh anggota organisasi).

Langkah 2: Tambahkan Fitur Aplikasi

Temukan dan klik [Add Features] di bilah navigasi sebelah kiri halaman latar belakang aplikasi. Pada halaman ini, tambahkan dua fitur inti berikut ke aplikasi Anda:

1. Web app

   1. Tujuan: Setelah ditambahkan, tim Anda dapat langsung membuka dan menggunakan aplikasi "Alibaba Cloud Enterprise Service" di Lark.

   2. Operasi: Temukan kartu "Web app", lalu klik + untuk menambahkannya. Anda dapat mengikuti [Langkah 4] untuk menambahkan tautan desktop.

2. Bot

   1. Tujuan: Setelah bot diaktifkan, aplikasi "Alibaba Cloud Enterprise Service" dapat mengirimkan pengingat pesan baru kepada Anda agar tidak melewatkan informasi penting.

   2. Operasi: Temukan kartu "robot", lalu klik + untuk menambahkannya.

Langkah 3: Dapatkan dan Berikan Kredensial Aplikasi

Untuk mengaktifkan channel Lark, harap berikan nama organisasi, App ID, dan App Secret Anda.

1. Nama organisasi: Di [Lark Open Platform], nama organisasi terletak di pojok kanan atas di bawah nama Anda; nama organisasi juga akan ditampilkan di pojok kiri atas halaman aplikasi baru dalam format "Production app@ (Nama Organisasi)".

2. Setelah aplikasi berhasil dibuat, temukan dan salin App ID serta App Secret pada halaman Credentials & Basic Info.

1. Salin nama organisasi, App ID aplikasi, dan App Secret, lalu kirimkan ke TAM Anda untuk dikonfigurasi (konfigurasi self-service akan didukung di masa mendatang).

Langkah 4: Konfigurasi Tautan Web App

Isi desktop homepage pada konfigurasi web app. Format tautan halaman utama adalah sebagai berikut. Perhatikan bahwa {appId} harus diganti dengan App ID web app Anda:

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

Disarankan memilih opsi "New tab in Lark".

Langkah 5: Aktifkan Izin Aplikasi

Untuk memastikan fungsi aplikasi berjalan normal (seperti mengirim pengingat pesan dan menampilkan kartu informasi), aktifkan izin berikut untuk aplikasi Anda.

{
 "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

Langkah 6: Pengaturan Keamanan

Untuk memastikan aplikasi berjalan normal, lengkapi pengaturan keamanan berikut di halaman developer Lark.

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

https://ailink.gts.work

Langkah 7: Manajemen Versi dan Rilis

Untuk perubahan pertama maupun selanjutnya pada aplikasi, isi nomor versi dan deskripsi pembaruan di [Version Management & Release], lalu simpan rilis tersebut.

Catatan: Anda dapat mengatur Application Available Range untuk semua atau sebagian anggota organisasi sesuai kebutuhan.

Selesai! Silakan Hubungi TAM untuk Bergabung ke Grup

Anda telah menyelesaikan seluruh konfigurasi. Harap hubungi Technical Account Manager (TAM) Anda untuk mendapatkan tautan bergabung ke grup. Anda dapat berkomunikasi dengan TAM secara real-time di dalam aplikasi, menerima Notifikasi Tiket, melacak progres layanan, serta menikmati pengalaman dukungan eksklusif dari integrasi tanpa hambatan ini.

Petunjuk Khusus dan Pertanyaan Umum

1. [Konfigurasi Jaringan] Daftar Putih IP (jika ada)

Jika lingkungan jaringan enterprise Anda telah menerapkan daftar putih akses IP atau Nama domain yang ketat, pastikan untuk menambahkan website aplikasi kami ke daftar putih tersebut. Jika tidak, aplikasi tidak akan terbuka secara normal di Lark.

2. [Pengingat Biaya] Versi Lark dan Batasan Pemanggilan API

   • Jika Anda menggunakan versi gratis Lark, batas maksimum pemanggilan API untuk custom app adalah 10.000 per bulan.

   • Jika Anda menggunakan versi berbayar Lark, tidak ada batasan tersebut.

   • Catatan: Skenario utama pemanggilan API aplikasi kami adalah mengirim pengingat pesan @ melalui Bot. Pengiriman pengingat akan dikontrol untuk menghindari kelelahan, dan setiap pengguna menerima paling banyak satu kali setiap 10 menit. Harap evaluasi volume ini berdasarkan frekuensi komunikasi tim Anda. Angka 10.000 per bulan di atas merupakan total seluruh pemanggilan API. Jika Anda menggunakan versi gratis, pertimbangkan juga pemanggilan lainnya. Referensi API berbayar: https://open.larksuite.com/document/server-docs/getting-started/server-api-list?chargeMethod=advanced

Otorisasi Login

Klik aplikasi yang baru dibuat di [Bagian 1] untuk menyelesaikan otorisasi (hanya untuk identifikasi) dan login.

Grup Layanan Utama

Setelah Anda mengaktifkan layanan channel Lark, sistem akan secara otomatis mengikat grup layanan paket dukungan enterprise yang sesuai untuk Anda. Anda dapat langsung menghubungi Technical Account Manager (TAM) Alibaba Cloud dan personel dukungan lainnya di dalam grup tersebut.

Catatan: Jika antarmuka Anda tidak menampilkan Service Master Group, harap hubungi Technical Account Manager (TAM) Anda untuk menambahkannya.

Grup Tiket

Anda dapat berkomunikasi dengan insinyur teknis mengenai isu spesifik di dalam grup Tiket.

• Jika masalah lebih mendesak, Anda dapat mengklik [Reminder] untuk mempercepat progres penanganan;

• Jika terjadi kegagalan serius seperti kehilangan data, korupsi data, atau ketidaktersediaan bisnis online, silakan klik [Emergency]. Kami akan mengaktifkan mekanisme respons darurat dan melakukan intervensi prioritas.

Manajemen Anggota Grup

Fungsi [Group Member Management] tersedia baik di grup layanan maupun grup Tiket.

Komunikasi dalam Grup

Di chat grup, Anda dapat langsung @ personel layanan Alibaba Cloud terkait atau rekan kerja untuk menyelesaikan masalah secara efisien dan kolaboratif.