Yth. Pelanggan,
Agar Anda dan tim dapat menggunakan Layanan Enterprise Alibaba Cloud di Feishu Workbench secara lancar dan nyaman, harap selesaikan konfigurasi sesuai panduan berikut.


Bagian 1: Langkah-langkah Konfigurasi (sekitar 10 menit)
Operator: Administrator/Developer Aplikasi organisasi Feishu Anda
Tujuan utama: Membuat aplikasi kustom dan memberikan izin yang diperlukan untuk mencapai integrasi aman dengan platform kami.
Langkah 1: Buat Aplikasi Kustom
Masuk ke [Feishu Open Platform].
Buat Custom App baru di platform tersebut, lalu tentukan nama dan deskripsi aplikasi (disarankan menggunakan “Alibaba Cloud Enterprise Service” agar memudahkan pencarian dan akses oleh anggota organisasi).

Langkah 2: Tambahkan Fitur Aplikasi
Temukan dan klik [Add Features] pada bilah navigasi di sisi kiri halaman latar belakang aplikasi. Pada halaman ini, tambahkan dua fitur inti berikut ke aplikasi Anda:

Web app
Tujuan: Setelah ditambahkan, tim Anda dapat langsung membuka dan menggunakan aplikasi "Alibaba Cloud Enterprise Service" di Feishu.
Operasi: Temukan kartu "Web app", lalu klik + untuk menambahkannya. Anda dapat mengikuti [Langkah 4] untuk menambahkan tautan desktop.
Bot
Tujuan: Setelah bot diaktifkan, aplikasi "Alibaba Cloud Enterprise Service" dapat mengirimkan pengingat pesan baru kepada Anda sehingga Anda tidak melewatkan informasi penting.
Operasi: Temukan kartu "robot", lalu klik + untuk menambahkannya.
Langkah 3: Dapatkan dan Berikan Kredensial Aplikasi
Untuk mengaktifkan channel Feishu, harap berikan Nama organisasi, App ID, dan App Secret Anda.
Nama organisasi: Di [Feishu 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)".

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

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/feishu/{appId}/workbench
Disarankan memilih opsi "New tab in Feishu".

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.
Permission Point | Deskripsi Penggunaan | Deskripsi Resmi Izin dari Feishu |
| Mendapatkan informasi dasar tentang bisnis Anda, termasuk:
Tujuan utama: Menampilkan identitas enterprise Anda secara tepat di dalam aplikasi | |
| Mendapatkan informasi aplikasi. | |
| Memungkinkan bot aplikasi mengirim pesan kepada pengguna. | |
| Memungkinkan aplikasi membuat dan memperbarui kartu pesan. |
Metode 1: Impor Massal
Buka [Permissions & Scopes], lalu klik Batch Import/export scopes.

Salin JSON berikut ke dalam kotak impor, lalu klik Add.
{
"scopes": {
"tenant": [
"application:application:self_manage",
"cardkit:card:write",
"im:message:send_as_bot",
"tenant:tenant:readonly"
],
"user": []
}
}

Metode 2: Impor Secara Manual
Anda juga dapat memilih untuk mengklik Add permission scopes to app di [Permissions & Scopes], lalu cari satu per satu titik izin berikut untuk ditambahkan dan diaktifkan.
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 Feishu.

1. Atur Redirect URLs
Tambahkan alamat berikut ke Redirect URLs.
Catatan: Ganti '{appId}' pada URL di atas dengan APP ID aktual yang Anda peroleh di [Langkah 1]. Anda dapat melihatnya di halaman detail aplikasi Feishu.
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/inviteToGroup2. Atur Domain Tepercaya H5
Tambahkan Nama domain berikut di H5 trusted domains:
https://ailink.gts.workLangkah 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. Silakan hubungi Technical Service 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 berkat integrasi tanpa hambatan ini.
Petunjuk Khusus dan Pertanyaan yang Sering Diajukan
[Konfigurasi Jaringan] Daftar Putih IP (jika ada)
Jika lingkungan jaringan enterprise Anda telah menerapkan daftar putih akses IP atau Nama domain yang ketat, pastikan Anda menambahkan website aplikasi kami ke daftar putih tersebut. Jika tidak, aplikasi tidak akan terbuka secara normal di Feishu.
[Pengingat Biaya] Versi Feishu dan Batasan Pemanggilan API
Jika Anda menggunakan versi gratis Feishu, batas maksimum pemanggilan API untuk Custom App adalah
10.000 per bulan.Jika Anda menggunakan versi berbayar Feishu, tidak ada batasan tersebut.
Catatan: Skenario utama pemanggilan API aplikasi kami adalah mengirim
@pengingat pesan melalui Bot. Pengiriman pengingat akan dikontrol agar tidak mengganggu, dan setiap pengguna akan 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 pemanggilan semua API. Jika Anda menggunakan versi gratis, pertimbangkan juga pemanggilan lainnya. Referensi API berbayar:https://open.feishu.cn/document/server-docs/api-call-guide/server-api-list?charge=all
Bagian 2 [Layanan Enterprise Alibaba Cloud] Panduan Penggunaan Aplikasi
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 Feishu, sistem akan secara otomatis mengaitkan grup layanan paket dukungan enterprise yang sesuai untuk Anda. Anda dapat langsung menghubungi Technical Service Manager (TAM) Alibaba Cloud dan personel dukungan lainnya di dalam grup tersebut.
Catatan: Jika antarmuka Anda tidak menampilkan Service Master Group, silakan hubungi Technical Service Manager (TAM) Anda untuk menambahkannya.

Workstation Layanan Enterprise
Klik [Enterprise Service Workstation] di dalam grup layanan untuk melihat semua Tiket kerja terkait dan peserta dalam grup tersebut.

Buat Tiket
Klik [Create Ticket] di dalam grup layanan. Sistem akan secara otomatis membuat grup Tiket dan menugaskan teknisi layanan teknis untuk menangani masalah Anda.

Grup Tiket
Anda dapat berkomunikasi dengan teknisi 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 layanan online tidak tersedia, silakan klik [Emergency]. Kami akan mengaktifkan mekanisme respons darurat dan melakukan intervensi prioritas.

Manajemen Anggota Grup
Fungsi [Group Member Management] didukung baik di grup layanan maupun grup Tiket.
Tambah Orang
Klik [Add people], lalu salin tautan di panel drawer untuk mengundang rekan kerja bergabung (tautan berlaku selama 24 jam).

Lihat Daftar Anggota
Di [Group Member Management], Anda dapat melihat:
Anggota organisasi Anda (rekan kerja)
Personel tim layanan Alibaba Cloud


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