Ikhtisar

Dokumen ini membantu Anda memperoleh pemahaman menyeluruh tentang DingTalk Contacts. Dengan membaca dokumen ini, pengelola organisasi, IT lead, dan developer dapat dengan cepat memahami batasan kemampuan Contacts dan meletakkan dasar bagi integrasi sistem serta inovasi bisnis selanjutnya.

Apa itu DingTalk Contacts

DingTalk Contacts adalah infrastruktur inti untuk pengelolaan terpadu informasi internal organisasi. Contacts merepresentasikan Struktur Organisasi dan informasi Pengguna sebuah Organisasi secara digital, memberikan kemampuan dasar bagi pengguna untuk menemukan orang dengan cepat dan berkolaborasi secara efisien. Untuk detail fitur lebih lanjut, lihat Panduan Pengguna DingTalk - Kontak Organisasi.

Dimensi	Deskripsi
Esensi	Wadah representasi digital dari Struktur Organisasi
Bentuk	Hierarki Departemen berstruktur pohon + basis data informasi Pengguna
Fungsi	Pusat yang menghubungkan orang, urusan, dan sumber daya dalam sebuah Organisasi, mendukung skenario seperti alur Persetujuan, perutean pesan, dan kontrol Izin

Cara melihat Contacts

Perspektif Admin Organisasi

Admin Organisasi dapat mengelola dan melihat Contacts dengan cara berikut:

DingTalk Admin Console: Masuk ke DingTalk Admin Console, lalu buka modul Internal Contacts untuk melakukan pengelolaan dan konfigurasi Contacts secara penuh.
Pengaturan Contacts: Konfigurasikan fitur lanjutan seperti aturan visibilitas Contacts, Bidang kustom, dan mode Eksekutif.

Pengguna reguler

Pengguna Organisasi reguler dapat melihat Contacts melalui endpoint berikut:

DingTalk for PC: Pada klien DingTalk PC, klik tab Contacts untuk melihat Struktur Organisasi dan detail kontak.
DingTalk Mobile: Pada aplikasi DingTalk mobile, buka halaman Contacts untuk menelusuri berdasarkan Departemen atau mencari berdasarkan kata kunci.
DingTalk for Web: Akses fitur Contacts melalui versi web DingTalk.

Ikhtisar kemampuan terbuka

Daftar Open API

Contacts menyediakan kemampuan Open API yang luas. Developer dapat menggunakan API untuk mengintegrasikan Contacts dengan sistem bisnis mereka.

Kontak pengguna

API	Deskripsi	Versi API
Dapatkan profil kontak pengguna	Dapatkan Profil Pengguna Organisasi dalam Contacts.	New

Izin Contacts

API	Deskripsi	Versi API
Dapatkan cakupan izin Contacts	Dapatkan Cakupan izin Contacts.	Legacy

Pengelolaan pengguna

API	Deskripsi	Versi API
Buat pengguna	Buat pengguna baru.	Legacy
Perbarui informasi pengguna	Perbarui informasi pengguna yang ditentukan.	Legacy
Hapus pengguna	Hapus pengguna tertentu berdasarkan ID pengguna.	Legacy
Kueri detail pengguna	Dapatkan detail pengguna tertentu.	Legacy
Dapatkan informasi dasar pengguna departemen	Dapatkan informasi dasar pengguna dalam Departemen tertentu.	Legacy
Dapatkan daftar ID pengguna suatu departemen	Dapatkan daftar ID pengguna Departemen tertentu.	Legacy
Dapatkan detail pengguna departemen	Dapatkan detail pengguna dalam Departemen tertentu.	Legacy
Dapatkan jumlah karyawan	Dapatkan jumlah Karyawan.	Legacy
Dapatkan daftar karyawan yang belum masuk ke DingTalk	Kueri daftar Karyawan dalam Organisasi yang belum masuk ke DingTalk dalam periode tertentu.	Legacy
Kueri pengguna berdasarkan nomor telepon	Dapatkan ID pengguna berdasarkan nomor telepon.	Legacy
Dapatkan ID pengguna berdasarkan unionId	Dapatkan ID pengguna berdasarkan unionId.	Legacy
Dapatkan daftar Admin	Kueri daftar Admin.	Legacy
Dapatkan cakupan izin Contacts dari seorang Admin	Dapatkan Cakupan izin Contacts dari seorang Admin.	Legacy
Dapatkan izin Kelola Aplikasi dari seorang Admin	Dapatkan izin Kelola Aplikasi dari seorang Admin.	Legacy
Kueri daftar rekaman pengunduran diri	Kueri daftar rekaman pengunduran diri dalam Organisasi.	New
Atur mode Eksekutif	Atur mode Eksekutif untuk seorang Karyawan.	New
Dapatkan pengaturan mode Eksekutif pengguna	Dapatkan detail pengaturan mode Eksekutif seorang pengguna.	New
Hapus pengaturan visibilitas atribut pengguna	Hapus pengaturan visibilitas Bidang atribut seorang Karyawan Organisasi.	New
Dapatkan pengaturan visibilitas atribut pengguna	Dapatkan pengaturan penyembunyian Bidang atribut seorang Karyawan Organisasi.	New
Atur visibilitas atribut pengguna	Tambahkan atau perbarui pengaturan penyembunyian Bidang atribut seorang Karyawan Organisasi.	New
Cari ID pengguna	Cari ID pengguna berdasarkan Nama pengguna.	New
Urutkan ID pengguna Contacts	Urutkan ID pengguna berdasarkan pinyin Nama pengguna.	New

Pengelolaan departemen

API	Deskripsi	Versi API
Buat departemen	Buat Departemen baru.	Legacy
Perbarui departemen	Perbarui informasi Departemen.	Legacy
Hapus departemen	Hapus Departemen tertentu berdasarkan ID Departemen.	Legacy
Cari ID departemen	Cari ID Departemen.	New
Dapatkan detail departemen	Dapatkan detail Departemen tertentu berdasarkan ID Departemen.	Legacy
Dapatkan daftar departemen	Dapatkan informasi dasar tentang Departemen tingkat berikutnya.	Legacy
Dapatkan daftar ID subdepartemen	Dapatkan daftar semua subdepartemen langsung di bawah suatu Departemen Organisasi.	Legacy
Dapatkan semua departemen induk dari departemen tertentu	Dapatkan daftar semua ID departemen induk dari Departemen tertentu.	Legacy
Dapatkan semua departemen induk dari pengguna tertentu	Kueri semua Departemen induk tempat pengguna tertentu bernaung.	Legacy

Pengelolaan peran

API	Deskripsi	Versi API
Buat peran	Buat Peran baru.	Legacy
Buat grup peran	Buat Grup peran.	Legacy
Perbarui nama peran	Perbarui Nama Peran.	Legacy
Tambahkan peran karyawan secara massal	Tambahkan Peran untuk Karyawan secara massal.	Legacy
Hapus peran	Hapus Peran tertentu berdasarkan ID Peran.	Legacy
Hapus peran karyawan secara massal	Hapus Peran untuk Karyawan secara massal.	Legacy
Atur cakupan pengelolaan anggota peran	Atur cakupan pengelolaan pengguna Peran.	Legacy
Dapatkan daftar grup peran	Dapatkan informasi Grup peran.	Legacy
Dapatkan daftar peran	Dapatkan daftar Peran.	Legacy
Dapatkan detail peran	Dapatkan detail Peran tertentu berdasarkan ID Peran.	Legacy
Dapatkan daftar karyawan dari peran tertentu	Dapatkan daftar Karyawan yang ditetapkan ke Peran tertentu.	Legacy

Kontak eksternal

API	Deskripsi	Versi API
Tambahkan kontak eksternal	Tambahkan Kontak eksternal ke Organisasi.	Legacy
Hapus kontak eksternal	Hapus Kontak eksternal dari Organisasi.	Legacy
Perbarui kontak eksternal	Perbarui Kontak eksternal Organisasi.	Legacy
Dapatkan daftar kontak eksternal	Dapatkan daftar Kontak eksternal Organisasi.	Legacy
Dapatkan daftar tag kontak eksternal	Dapatkan Tag Kontak eksternal Organisasi.	Legacy
Dapatkan detail kontak eksternal	Dapatkan detail Kontak eksternal Organisasi.	Legacy

Akun Perusahaan

API	Deskripsi	Versi API
Buat Akun Perusahaan SSO	Buat pengguna baru dengan Akun Perusahaan Single Sign-On.	Legacy
Ubah DingTalk ID dari Akun Perusahaan	Ubah DingTalk ID dari sebuah Akun Perusahaan.	New
Buat Akun Perusahaan bawaan DingTalk	Buat pengguna baru dengan Akun Perusahaan bawaan DingTalk.	Legacy
Perbarui informasi pengguna Akun Perusahaan	Perbarui informasi pengguna Akun Perusahaan yang ditentukan.	Legacy
Kueri detail pengguna Akun Perusahaan	Dapatkan detail pengguna Akun Perusahaan tertentu.	Legacy
Aktifkan Akun Perusahaan	Aktifkan Akun Perusahaan tertentu.	New
Nonaktifkan Akun Perusahaan	Nonaktifkan Akun Perusahaan tertentu.	New
Paksa keluar Akun Perusahaan	Paksa keluar Akun Perusahaan tertentu.	New
Kueri status Akun Perusahaan	Kueri status aktif dari sebuah Akun Perusahaan.	New
Kueri organisasi yang dimiliki Akun Perusahaan	Kueri Organisasi tempat Akun Perusahaan memegang peran pembuat, dan dapatkan informasi tentang Organisasi tersebut.	New
Otorisasi Akun Perusahaan untuk bergabung ke beberapa organisasi	Otorisasi Akun Perusahaan untuk bergabung ke beberapa Organisasi.	New
Undang Akun Perusahaan dari organisasi lain untuk bergabung	Tambahkan Akun Perusahaan dari Organisasi lain ke Organisasi ini.	Legacy
Dapatkan detail pengguna Akun Perusahaan suatu departemen	Dapatkan detail pengguna dalam Departemen tertentu.	Legacy
Kueri pengguna Akun Perusahaan berdasarkan nomor telepon	Dapatkan ID pengguna dari pengguna Akun Perusahaan berdasarkan nomor telepon.	Legacy
Transfer Akun Perusahaan ke Super Admin (pembuat)	Transfer kepemilikan Organisasi yang dimiliki oleh sebuah Akun Perusahaan di Organisasi ini ke Akun Perusahaan lain.	New
Kueri dingId asli berdasarkan dingId yang telah dimigrasi	Kueri dingId asli berdasarkan dingId yang telah dimigrasi.	New
Kueri unionId asli berdasarkan unionId yang telah dimigrasi	Kueri unionId asli berdasarkan unionId yang telah dimigrasi.	New
Kueri dingId yang telah dimigrasi berdasarkan dingId asli	Kueri dingId yang telah dimigrasi berdasarkan dingId asli.	New
Kueri unionId yang telah dimigrasi berdasarkan unionId asli	Kueri unionId yang telah dimigrasi berdasarkan unionId asli.	New
Otorisasi organisasi lain untuk melihat informasi Akun Perusahaan organisasi ini	Tentukan Bidang informasi Akun Perusahaan Organisasi ini yang dapat dilihat oleh Organisasi lain.	New

Pengelolaan organisasi

API	Deskripsi	Versi API
Dapatkan informasi Autentikasi Organisasi	Dapatkan informasi Autentikasi Organisasi.	New
Dapatkan informasi undangan Organisasi	Dapatkan informasi undangan Organisasi.	New
Dapatkan DingTalk Index terbaru dari Organisasi	Dapatkan DingTalk Index terbaru dari Organisasi.	New
Periksa apakah seorang Admin memiliki izin Kelola Aplikasi	Periksa apakah seorang Admin Organisasi memiliki izin Kelola Aplikasi.	New

API	Deskripsi	Versi API
Dapatkan detail departemen	Dapatkan detail Departemen berdasarkan ID Departemen.	Legacy
Dapatkan daftar pengguna suatu departemen	Dapatkan daftar pengguna suatu Departemen.	Legacy
Dapatkan daftar departemen	Dapatkan Daftar departemen Contacts industri berdasarkan ID Departemen.	Legacy
Dapatkan detail pengguna departemen	Dapatkan detail pengguna Departemen.	Legacy
Dapatkan informasi Organisasi	Dapatkan informasi Organisasi dari Contacts industri.	Legacy

Terjemahan ID Contacts

API	Deskripsi	Versi API
Terjemahkan ID Contacts secara asinkron	Mulai terjemahan asinkron konten ID Contacts, mengganti ID pengguna dan ID Departemen dalam Cakupan izin Contacts dari penyedia solusi produk.	New
Dapatkan hasil tugas terjemahan asinkron	Dapatkan hasil tugas terjemahan yang telah dikirim.	New

Pengelolaan visibilitas Contacts

API	Deskripsi	Versi API
Dapatkan pengaturan penyembunyian Contacts	Dapatkan daftar pengaturan penyembunyian Contacts secara massal.	New
Hapus pengaturan penyembunyian Contacts	Hapus pengaturan penyembunyian Contacts.	New
Tambahkan atau perbarui pengaturan penyembunyian Contacts	Tambahkan atau perbarui pengaturan penyembunyian Contacts.	New
Atur prioritas visibilitas Departemen	Atur prioritas visibilitas Departemen Contacts.	New
Tambahkan atau ubah pengaturan pembatasan tampilan Contacts	Tambahkan atau ubah pengaturan pembatasan tampilan Contacts.	New
Dapatkan daftar pengaturan pembatasan tampilan Contacts	Dapatkan daftar pengaturan pembatasan tampilan Contacts.	New
Hapus pengaturan pembatasan tampilan Contacts	Hapus pengaturan pembatasan tampilan Contacts.	New

API	Deskripsi	Versi API
Buat organisasi hulu-hilir	Buat Organisasi hulu-hilir.	New
Hapus Asosiasi dengan suatu organisasi	Hapus hubungan Asosiasi dengan suatu Organisasi.	New
Dapatkan informasi undangan organisasi hulu-hilir	Dapatkan Tautan undangan Organisasi hulu-hilir.	New
Setujui aplikasi bergabung organisasi mitra secara massal	Setujui aplikasi bergabung Organisasi mitra ke Organisasi hulu-hilir secara massal.	New
Perbarui informasi atribut organisasi mitra dalam organisasi hulu-hilir	Perbarui informasi Atribut Organisasi mitra dalam Organisasi hulu-hilir.	New
Atur cakupan visibilitas organisasi mitra dalam organisasi hulu-hilir	Atur cakupan visibilitas Organisasi mitra dalam Organisasi hulu-hilir.	New
Dapatkan informasi organisasi hulu-hilir yang telah diikuti atau diajukan Organisasi untuk bergabung	Dapatkan informasi Organisasi hulu-hilir yang telah diikuti Organisasi, atau dapatkan informasi Organisasi hulu-hilir yang telah diajukan Organisasi untuk bergabung.	New
Dapatkan informasi organisasi dan pengguna yang telah bergabung atau sedang mengajukan untuk bergabung ke organisasi hulu-hilir	Dapatkan informasi Organisasi dan pengguna yang telah bergabung atau sedang mengajukan untuk bergabung ke Organisasi hulu-hilir berdasarkan ID Organisasi hulu-hilir.	New

API	Deskripsi	Versi API
Hapus Asosiasi dengan suatu organisasi	Hapus hubungan Asosiasi dengan suatu Organisasi.	New
Dapatkan daftar organisasi induk	Dapatkan daftar Organisasi induk.	New
Dapatkan daftar organisasi cabang	Dapatkan daftar Organisasi cabang.	New
Setujui aplikasi bergabung organisasi mitra secara massal	Setujui aplikasi bergabung Organisasi cabang ke Organisasi induk secara massal.	New
Dapatkan data otorisasi untuk cabang organisasi hulu-hilir	Dapatkan data otorisasi untuk cabang Organisasi hulu-hilir.	New
Atur cakupan visibilitas organisasi cabang dalam organisasi induk	Atur cakupan visibilitas Organisasi cabang dalam Organisasi induk.	New
Perbarui informasi atribut organisasi cabang dalam organisasi induk	Perbarui informasi Atribut Organisasi cabang dalam Organisasi induk.	New

Daftar peristiwa callback

Contacts mendukung peristiwa callback seperti perubahan pengguna, perubahan Departemen, perubahan Peran, dan perubahan informasi Organisasi. Untuk peristiwa lainnya, lihat ikhtisar Langganan peristiwa.

Tutorial

DingTalk menyediakan contoh alur integrasi untuk API Contacts.

Buat, dapatkan, perbarui, dan hapus karyawan organisasi
Buat, dapatkan, perbarui, dan hapus departemen organisasi
Sinkronkan sistem OA perusahaan dengan DingTalk Contacts
Dapatkan informasi pengguna yang telah masuk dari Mini program personal pihak ketiga

Glosarium

ID Karyawan

Kode Bidang yang berkaitan dengan ID Karyawan adalah job_number. ID Karyawan seorang Karyawan dalam sebuah Organisasi tidak harus unik, sehingga tidak dapat digunakan sebagai pengenal unik Karyawan dalam Organisasi. Admin Organisasi masuk ke DingTalk Admin Console, dan pada halaman Contacts, klik Nama Karyawan untuk melihat ID Karyawan. Bidang ID Karyawan bersifat Opsional.

unionId

Pengenal unik seorang pengguna dalam cakupan akun DingTalk Open Platform saat ini. Satu akun DingTalk Open Platform dapat memuat beberapa App terbuka, termasuk App suite ISV dan Aplikasi internal. unionId dapat diperoleh dengan memanggil API Kueri detail pengguna.

Grup peran dan peran

Grup peran dan Peran didefinisikan dalam Organisasi untuk memudahkan pengelolaan informasi identitas Karyawan. Seorang Karyawan dapat memegang beberapa identitas Peran secara bersamaan. Admin Organisasi masuk ke DingTalk Admin Console, buka halaman Contacts > Internal Contacts Management, lalu klik Role untuk melihat Grup peran dan Peran.

Bidang ekstensi Contacts

Anda dapat menambahkan Bidang ekstensi ke Contacts. Admin Organisasi masuk ke DingTalk Admin Console, dan buka Internal Contacts Settings > Contacts Information > Add Custom Field untuk menambahkan Bidang kustom.

Panduan pemanggilan API

Autentikasi & otorisasi

Kontak

Kalender

Konferensi

AI Table

Dokumen & file

IM

Apa itu DingTalk Contacts

Cara melihat Contacts

Perspektif Admin Organisasi

Pengguna reguler

Ikhtisar kemampuan terbuka

Daftar Open API

Kontak pengguna

Izin Contacts

Pengelolaan pengguna

Pengelolaan departemen

Pengelolaan peran

Kontak eksternal

Akun Perusahaan

Pengelolaan organisasi

Terjemahan ID Contacts

Pengelolaan visibilitas Contacts

Daftar peristiwa callback

Tutorial

Glosarium

ID Karyawan

unionId

Grup peran dan peran

Bidang ekstensi Contacts

​Apa itu DingTalk Contacts

​Cara melihat Contacts

​Perspektif Admin Organisasi

​Pengguna reguler

​Ikhtisar kemampuan terbuka

​Daftar Open API

​Kontak pengguna

​Izin Contacts

​Pengelolaan pengguna

​Pengelolaan departemen

​Pengelolaan peran

​Kontak eksternal

​Akun Perusahaan

​Pengelolaan organisasi

​Terjemahan ID Contacts

​Pengelolaan visibilitas Contacts

​Daftar peristiwa callback

​Tutorial

​Glosarium

​ID Karyawan

​unionId

​Grup peran dan peran

​Bidang ekstensi Contacts

Apa itu DingTalk Contacts

Cara melihat Contacts

Perspektif Admin Organisasi

Pengguna reguler

Ikhtisar kemampuan terbuka

Daftar Open API

Kontak pengguna

Izin Contacts

Pengelolaan pengguna

Pengelolaan departemen

Pengelolaan peran

Kontak eksternal

Akun Perusahaan

Pengelolaan organisasi

Terjemahan ID Contacts

Pengelolaan visibilitas Contacts

Daftar peristiwa callback

Tutorial

Glosarium

ID Karyawan

unionId

Grup peran dan peran

Bidang ekstensi Contacts