> ## Documentation Index > Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt > Use this file to discover all available pages before exploring further. # Ikhtisar > Ditujukan untuk admin, IT lead, dan developer, artikel ini menguraikan kemampuan DingTalk Contacts, cara melihat direktori, lanskap open API, tutorial, serta terminologi utama untuk integrasi sistem. 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](https://docs.dingtalk.io/i/p/Y7kmbokZp3pgGLq2/docs/Y7kmbpxy30LLzLq2?dontjump=true#). | **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](https://oa.dingtalk.io/), 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](/id/open/development/user-information-creation) | Buat pengguna baru. | Legacy | | [Perbarui informasi pengguna](/id/open/development/user-information-update) | Perbarui informasi pengguna yang ditentukan. | Legacy | | [Hapus pengguna](/id/open/development/delete-a-user) | Hapus pengguna tertentu berdasarkan ID pengguna. | Legacy | | [Kueri detail pengguna](/id/open/development/query-user-details) | Dapatkan detail pengguna tertentu. | Legacy | | [Dapatkan informasi dasar pengguna departemen](/id/open/development/queries-the-simple-information-of-a-department-user) | Dapatkan informasi dasar pengguna dalam Departemen tertentu. | Legacy | | [Dapatkan daftar ID pengguna suatu departemen](/id/open/development/query-the-list-of-department-userids) | Dapatkan daftar ID pengguna Departemen tertentu. | Legacy | | [Dapatkan detail pengguna departemen](/id/open/development/queries-the-complete-information-of-a-department-user) | Dapatkan detail pengguna dalam Departemen tertentu. | Legacy | | [Dapatkan jumlah karyawan](/id/open/development/user-management-acquires-number-employees) | Dapatkan jumlah Karyawan. | Legacy | | [Dapatkan daftar karyawan yang belum masuk ke DingTalk](/id/open/development/queries-the-inactive-users-or-active-users-under-an-enterprise) | Kueri daftar Karyawan dalam Organisasi yang belum masuk ke DingTalk dalam periode tertentu. | Legacy | | [Kueri pengguna berdasarkan nomor telepon](/id/open/development/query-users-by-phone-number) | Dapatkan ID pengguna berdasarkan nomor telepon. | Legacy | | [Dapatkan ID pengguna berdasarkan unionId](/id/open/development/query-a-user-by-the-union-id) | Dapatkan ID pengguna berdasarkan unionId. | Legacy | | [Dapatkan daftar Admin](/id/open/development/query-the-administrator-list) | Kueri daftar Admin. | Legacy | | [Dapatkan cakupan izin Contacts dari seorang Admin](/id/open/development/query-permissions-of-the-administrator-address-book) | Dapatkan Cakupan izin Contacts dari seorang Admin. | Legacy | | [Dapatkan izin Kelola Aplikasi dari seorang Admin](/id/open/development/obtains-the-administrator-s-microapplication-management-permission) | Dapatkan izin Kelola Aplikasi dari seorang Admin. | Legacy | | [Kueri daftar rekaman pengunduran diri](/id/open/development/query-the-details-of-employees-who-have-left-office) | Kueri daftar rekaman pengunduran diri dalam Organisasi. | New | | [Atur mode Eksekutif](/id/open/development/update-executive-settings) | Atur mode Eksekutif untuk seorang Karyawan. | New | | [Dapatkan pengaturan mode Eksekutif pengguna](/id/open/development/get-user-executive-mode-settings) | Dapatkan detail pengaturan mode Eksekutif seorang pengguna. | New | | [Hapus pengaturan visibilitas atribut pengguna](/id/open/development/delete-enterprise-employee-attribute-field-visibility-settings) | Hapus pengaturan visibilitas Bidang atribut seorang Karyawan Organisasi. | New | | [Dapatkan pengaturan visibilitas atribut pengguna](/id/open/development/pull-hidden-property-field-for-enterprise-employees) | Dapatkan pengaturan penyembunyian Bidang atribut seorang Karyawan Organisasi. | New | | [Atur visibilitas atribut pengguna](/id/open/development/add-or-update-the-hidden-settings-of-the-employee-property) | Tambahkan atau perbarui pengaturan penyembunyian Bidang atribut seorang Karyawan Organisasi. | New | | [Cari ID pengguna](/id/open/development/address-book-search-user-id) | Cari ID pengguna berdasarkan Nama pengguna. | New | | [Urutkan ID pengguna Contacts](/id/open/development/address-book-userid-sorting) | Urutkan ID pengguna berdasarkan pinyin Nama pengguna. | New | #### Pengelolaan departemen | API | Deskripsi | Versi API | | ----------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | --------- | | [Buat departemen](/id/open/development/address-book-creation-department-established-department) | Buat Departemen baru. | Legacy | | [Perbarui departemen](/id/open/development/address-book-update-department) | Perbarui informasi Departemen. | Legacy | | [Hapus departemen](/id/open/development/address-book-deletion-department) | Hapus Departemen tertentu berdasarkan ID Departemen. | Legacy | | [Cari ID departemen](/id/open/development/address-book-search-department-id) | Cari ID Departemen. | New | | [Dapatkan detail departemen](/id/open/development/query-department-details0-v2) | Dapatkan detail Departemen tertentu berdasarkan ID Departemen. | Legacy | | [Dapatkan daftar departemen](/id/open/development/user-management-acquires-the-list-departments) | Dapatkan informasi dasar tentang Departemen tingkat berikutnya. | Legacy | | [Dapatkan daftar ID subdepartemen](/id/open/development/obtain-the-list-of-sub-department-ids) | Dapatkan daftar semua subdepartemen langsung di bawah suatu Departemen Organisasi. | Legacy | | [Dapatkan semua departemen induk dari departemen tertentu](/id/open/development/query-the-list-of-all-parent-departments-of-a-department) | Dapatkan daftar semua ID departemen induk dari Departemen tertentu. | Legacy | | [Dapatkan semua departemen induk dari pengguna tertentu](/id/open/development/queries-the-list-of-all-parent-departments-of-a-user) | 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](/id/open/development/create-an-sso-account) | Buat pengguna baru dengan Akun Perusahaan Single Sign-On. | Legacy | | [Ubah DingTalk ID dari Akun Perusahaan](/id/open/development/api-changedingtalkid) | Ubah DingTalk ID dari sebuah Akun Perusahaan. | New | | [Buat Akun Perusahaan bawaan DingTalk](/id/open/development/create-dingtalk-user-created-dedicated-account) | Buat pengguna baru dengan Akun Perusahaan bawaan DingTalk. | Legacy | | [Perbarui informasi pengguna Akun Perusahaan](/id/open/development/update-dedicated-accounts-information) | Perbarui informasi pengguna Akun Perusahaan yang ditentukan. | Legacy | | [Kueri detail pengguna Akun Perusahaan](/id/open/development/queries-the-details-of-a-dedicated-account) | Dapatkan detail pengguna Akun Perusahaan tertentu. | Legacy | | [Aktifkan Akun Perusahaan](/id/open/development/enable-a-dedicated-account) | Aktifkan Akun Perusahaan tertentu. | New | | [Nonaktifkan Akun Perusahaan](/id/open/development/disable-an-exclusive-account) | Nonaktifkan Akun Perusahaan tertentu. | New | | [Paksa keluar Akun Perusahaan](/id/open/development/force-logout-from-dedicated-account) | Paksa keluar Akun Perusahaan tertentu. | New | | [Kueri status Akun Perusahaan](/id/open/development/query-dedicated-account-status-1) | Kueri status aktif dari sebuah Akun Perusahaan. | New | | [Kueri organisasi yang dimiliki Akun Perusahaan](/id/open/development/you-can-call-this-operation-to-query-the-organization-that) | Kueri Organisasi tempat Akun Perusahaan memegang peran pembuat, dan dapatkan informasi tentang Organisasi tersebut. | New | | [Otorisasi Akun Perusahaan untuk bergabung ke beberapa organisasi](/id/open/development/authorize-a-dedicated-account-to-join-multiple-organizations) | Otorisasi Akun Perusahaan untuk bergabung ke beberapa Organisasi. | New | | [Undang Akun Perusahaan dari organisasi lain untuk bergabung](/id/open/development/invite-other-organization-specific-accounts-to-join) | Tambahkan Akun Perusahaan dari Organisasi lain ke Organisasi ini. | Legacy | | [Dapatkan detail pengguna Akun Perusahaan suatu departemen](/id/open/development/queries-account-details) | Dapatkan detail pengguna dalam Departemen tertentu. | Legacy | | [Kueri pengguna Akun Perusahaan berdasarkan nomor telepon](/id/open/development/obtain-the-userid-of-your-mobile-phone-number) | Dapatkan ID pengguna dari pengguna Akun Perusahaan berdasarkan nomor telepon. | Legacy | | [Transfer Akun Perusahaan ke Super Admin (pembuat)](/id/open/development/transfer-exclusive-account-to-main-administrator-creator) | 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](/id/open/development/api-orgaccountmobilevisibleinotherorg) | 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](/id/open/development/check-whether-the-administrator-has-application-management-permissions) | 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](/id/open/development/asynchronous-address-book-file-content-translation) | 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](/id/open/development/obtains-the-results-of-an-asynchronous-translation-task) | 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](/id/open/development/address-book-employee-operations) * [Buat, dapatkan, perbarui, dan hapus departemen organisasi](/id/open/development/operations-related-to-address-book-departments) * [Sinkronkan sistem OA perusahaan dengan DingTalk Contacts](/id/open/development/synchronization-between-enterprise-oa-system-and-dingtalk-address-book) * 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](https://oa.dingtalk.io/), 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](/id/open/development/query-user-details). ### 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](https://oa.dingtalk.io/), 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](https://oa.dingtalk.io/), dan buka **Internal Contacts Settings > Contacts Information > Add Custom Field** untuk menambahkan Bidang kustom.