Dokumen ini sudah diperbarui.
Terjemahan ke Bahasa Indonesia belum selesai.

Bahasa Inggris diperbarui: 11 Agu 2025

Workplace from Meta akan ditiadakan. Anda akan dapat terus menggunakan Workplace hingga 31 Agustus 2025. Kunjungi Pusat Bantuan kami untuk mempelajari selengkapnya.

Anggota

Jalur `/{member-id}`

Mewakili objek pengguna sebagai anggota komunitas atau grup Workplace.

Jalur `/community/members`

Menampilkan daftar semua akun pengguna saat ini. Memerlukan izin Kelola profil pekerjaan.

Memfilter berdasarkan `external_id`

Untuk memfilter pengguna berdasarkan ID eksternal, gunakan parameter external_ids dan berikan daftar ID eksternal pengguna yang diinginkan yang dipisahkan koma.

Jalur `/community/organization_members`

Menampilkan daftar pengguna. Memerlukan izin Baca keanggotaan grup. Secara default, akun pengguna yang aktif akan dicantumkan. Akun pengguna yang dinonaktifkan dapat ditampilkan menggunakan parameter URL inactive=1.

Membaca

Menampilkan satu objek Pengguna yang mewakili pengguna Workplace. Dapat diakses melalui ID Workplace anggota atau alamat email yang digunakan anggota saat login ke Workplace.

/{member_id}
/{email_address}

Izin

Membaca informasi tentang anggota memerlukan izin Baca profil pekerjaan atau Kelola akun. Jika Integrasi menggunakan izin Kelola akun dan dibatasi pada grup tertentu, Integrasi tersebut tidak akan dapat mengakses beberapa kolom Anggota.

Kolom

Nama Kolom	Deskripsi	Jenis
`id`	ID akun pengguna orang ini.	`string`
`first_name`	Nama depan orang tersebut.	`string`
`last_name`	Nama belakang orang tersebut.	`string`
`email`	Alamat email utama orang tersebut, juga digunakan sebagai nama penggunanya di Workplace.	`string`
`title`	Jabatan orang tersebut di Workplace, jika diatur melalui API Pengelolaan Akun.	`string`
`organization`	Organisasi orang tersebut di Workplace, jika diatur melalui API Pengelolaan Akun.	`string`
`division`	Divisi orang tersebut di Workplace, jika diatur melalui API Pengelolaan Akun.	`string`
`department`	Departemen orang tersebut di Workplace, jika diatur melalui API Pengelolaan Akun.	`string`
`primary_phone`	Nomor telepon utama orang tersebut yang tercantum. Dipetakan ke entri `phoneNumbers` yang ditandai sebagai `primary` pada API Pengelolaan Akun.	`string`
`primary_address`	Alamat utama orang tersebut yang tercantum. Dipetakan ke entri `addresses` yang ditandai sebagai `primary` pada API Pengelolaan Akun	`string`
`picture`	Foto profil orang tersebut.	`url`
`link`	Tautan ke profil orang tersebut.	`url`
`locale`	Lokal orang tersebut.	`string`
`name`	Nama lengkap orang tersebut.	`string`
`name_format`	Nama orang tersebut diformat untuk menangani pemesanan dalam bahasa Mandarin, Jepang, atau Korea dengan benar.	`string`
`updated_time`	Waktu yang diperbarui.	`datetime`
`account_invite_time`	Waktu undangan akun dalam format UTC.	`datetime`
`account_claim_time`	Waktu klaim akun dalam format UTC.	`datetime`
`account_deactivate_time`	Waktu penonaktifan akun dalam format UTC	`datetime`
`external_id`	Pengidentifikasi untuk anggota sebagaimana yang ditentukan oleh pelanggan. Setiap anggota BOLEH menyertakan set nilai external_id yang tidak kosong menggunakan API Pengelolaan Akun. Nilai atribut external_id tidak akan pernah ditentukan oleh Workplace.	`string`
`start_date`	Tanggal dan waktu orang tersebut bergabung dengan perusahaan, jika diatur melalui API Pengelolaan Akun.	`datetime`
`about`	Bio orang tersebut.	`string`
`cost_center`	Mengidentifikasi nama pusat biaya.	`string`
`impersonate_token`	Token akses anggota yang memungkinkan integrasi untuk melakukan panggilan atas nama orang tertentu. Izin Menyamar sudah tidak berlaku lagi. Jangan membuat fungsi baru menggunakan izin ini. Izin ini hanya tersedia untuk integrasi khusus yang saat ini mengaktifkannya.	`string`
`claim_link`	Menyediakan tautan yang dapat diikuti pengguna untuk mengeklaim akun Workplace-nya (hanya tersedia untuk pengguna yang belum diklaim).	`string`
`access_code`	Menyediakan kode akses yang dapat diikuti pengguna untuk mengeklaim akun Workplace-nya (hanya tersedia untuk pengguna yang belum diklaim).	`string`
`work_locale`	Lokal pengguna. Ini adalah lokal yang akan digunakan Workplace untuk pengguna ini hingga ada cara lain untuk menentukan lokal pengguna (seperti pengaturan bahasa browser atau perangkat)	`string` Nilai yang valid adalah gabungan kode bahasa dua huruf ISO 639-1 ditambah garis bawah dan kode negara dua huruf ISO 3166-1. Misalnya, en_US menentukan bahasa Inggris dan negara AS.
`frontline`	Informasi tentang status frontline pengguna	`object` (lihat contoh di bawah)
`active`	Apakah akun pengguna aktif	`boolean`

Penerbitan

Lihat API Pengelolaan Akun (Grafik)

Menghapus

Lihat API Pengelolaan Akun (Grafik)

Memperbarui

Lihat API Pengelolaan Akun (Grafik)

Edge

Nama Edge	Deskripsi
`/events`	Peristiwa untuk orang ini. Secara default ini tidak mencakup peristiwa yang ditolak atau tidak dibalas oleh orang tersebut.
`/feed`	Kabar postingan (termasuk pembaruan status) dan tautan yang diterbitkan oleh orang ini.
`/conversations`	Pesan Workplace seseorang atau halaman bot. Memerlukan izin Baca semua pesan untuk melihat percakapan seseorang.
`/managers`	Manajer atau para manajer yang tercantum pada seseorang.
`/reports`	Bawahan yang tercantum pada seseorang.
`/photos`	Foto profil anggota tersebut.
`/groups`	Grup yang terkait dengan anggota.
`/phones`	Nomor telepon yang terkait dengan anggota.
`/skills`	Keterampilan anggota.
`/badges`	Lencana yang diberikan kepada pengguna
`/logout`	Keluarkan pengguna dari Workplace. Hanya `POST`
`/remove_profile_information`	Hapus informasi profil untuk pengguna yang dinonaktifkan. Hanya `POST`

Contoh

Mengambil informasi tentang anggota komunitas

Dapatkan nama dan alamat email anggota tertentu.

GET /{member_id}?fields=email,name HTTP/1.1
Host: graph.facebook.com

Dapatkan ID anggota dari alamat email mereka

GET /{email_address} HTTP/1.1
Host: graph.facebook.com

Buat daftar anggota perusahaan berdasarkan id eksternal pengguna

GET /community/members?external_ids=12356,abc123 HTTP/1.1
Host: graph.facebook.com

Buat daftar anggota perusahaan termasuk akun yang dinonaktifkan

GET /community/organization_members?inactive=1 HTTP/1.1
Host: graph.facebook.com

Dapatkan peristiwa anggota:

GET graph.facebook.com
      /{member-id}/events

Mengambil informasi tentang Manajer dan Bawahan pengguna

Dapatkan bawahan anggota tertentu

GET /{member_id}/reports HTTP/1.1
Host: graph.facebook.com

Dapatkan manajer anggota tertentu

GET /{member_id}/managers HTTP/1.1
Host: graph.facebook.com

Mengambil pesan untuk anggota

Dapatkan percakapan untuk anggota, termasuk pesan, pengirim, dan lampiran:

Memerlukan token integrasi khusus dengan izin Baca semua pesan:

GET graph.facebook.com
      /{member-id}/conversations?fields=messages{message,attachments,from}

Dapatkan ID utas percakapan untuk anggota berdasarkan utas:

Memerlukan token integrasi khusus dengan izin Baca semua pesan:

GET graph.facebook.com
      /{member-id}/conversations

Dapatkan pesan untuk ID utas tertentu, untuk pengguna tertentu:

Memerlukan token integrasi khusus dengan izin Baca semua pesan:

GET graph.facebook.com
      /{thread-id}/messages?user={user-id}

Dapatkan percakapan untuk halaman bot, termasuk pesan dan lampiran:

GET graph.facebook.com
      /me/conversations?fields=messages{message,attachments}

Alias /me menunjuk ke halaman bot saat menggunakan token integrasi khusus

Hapus pesan tertentu di kotak masuk anggota menggunakan token integrasi khusus:

Memerlukan token integrasi khusus dengan izin Hapus pesan obrolan

DELETE graph.facebook.com
      /{message-id}?user={user-id}

Menghapus pesan hanya menghapus pesan dari tampilan anggota yang ditentukan dalam permintaan. Untuk menghapus pesan seluruhnya, tampilan setiap anggota terhadap pesan tersebut harus dihapus.

Dapatkan tanggal dan waktu saat anggota diundang dan mengeklaim akunnya:

Memerlukan token integrasi khusus dengan izin Kelola Akun:

GET graph.facebook.com
      /{member-id}?fields=account_invite_time,account_claim_time

Kolom ini hanya ada jika anggota diundang atau mengeklaim akunnya

Dapatkan tanggal dan waktu saat akun anggota dinonaktifkan:

Memerlukan token integrasi khusus dengan izin Kelola Akun:

GET graph.facebook.com
      /{member-id}?fields=account_deactivate_time

Bidang ini hanya ada jika akun anggota telah dinonaktifkan

Keluarkan pengguna dari Workplace

Memerlukan token akses dengan izin Logout:

POST graph.facebook.com
      /{member-id}/logout

Atur foto profil

Memerlukan token akses dengan izin Kelola Profil Pekerjaan. Mendukung URL file dan unggahan file dalam permintaan.

POST graph.facebook.com
      /{member-id}/profile_pictures?
      image_url={...}&
      caption={...}

POST graph.facebook.com
      /{member-id}/profile_pictures?
      caption={...}
Content-Type: multipart/form-data;
Content-Disposition: form-data; name="image_data"; filename="/profile_picture.png

Tambahkan telepon anggota

Memerlukan token akses dengan izin Kelola Profil Pekerjaan.

POST graph.facebook.com
      /{member-id}/phones?
      type={...}&
      primary={...}&
      number={...}

Dapatkan keterampilan anggota

Memerlukan token akses dengan izin Baca Profil Pekerjaan.

GET graph.facebook.com
      /{member-id}/skills

Tambahkan keterampilan

Memerlukan token akses dengan izin Kelola Profil Pekerjaan.

POST graph.facebook.com
      /{member-id}/skills?name={...}

Hapus keterampilan

Memerlukan token akses dengan izin Kelola Profil Pekerjaan.

DELETE graph.facebook.com
      /{member-id}/skills?name={...}

Dapatkan lencana anggota

Memerlukan token akses dengan izin Baca Profil Pekerjaan.

GET graph.facebook.com
      /{member-id}/badges?fields=id,name,description,icon,category

Berikan lencana bawaan kepada pengguna

Memerlukan token akses dengan izin Kelola lencana. Lihat dokumentasi komunitas untuk mencantumkan lencana yang tersedia dan ID-nya.

POST graph.facebook.com
      /{member-id}/badges?badge=workplace_champion

Berikan lencana khusus kepada pengguna

Memerlukan token akses dengan izin Kelola lencana. Lihat dokumentasi komunitas untuk mencantumkan lencana yang tersedia dan ID-nya. Perhatikan bahwa # di URL perlu dikodekan URL.

POST graph.facebook.com
      /{member-id}/badges?badge=workplace_custom#{badge_id}

Nonaktifkan anggota

Memerlukan token akses dengan izin Akun Pengguna Penyediaan.

POST graph.facebook.com
      /{member-id}?active=false

Hapus anggota

Memerlukan token akses dengan izin Akun Pengguna Penyediaan.

DELETE graph.facebook.com
      /{member-id}

Hanya anggota yang tidak diklaim yang tersedia untuk dihapus.

Dapatkan status frontline pengguna

GET graph.facebook.com
      /{user-id}?fields=frontline
      
    {
      "frontline": {
        "is_frontline": true
      },
    "id": "100038142594104"
    }

Anggota

Jalur /{member-id}

Jalur /community/members

Memfilter berdasarkan external_id

Jalur /community/organization_members

Membaca

Izin

Kolom

Penerbitan

Menghapus

Memperbarui

Edge

Contoh

Mengambil informasi tentang anggota komunitas

Dapatkan nama dan alamat email anggota tertentu.

Dapatkan ID anggota dari alamat email mereka

Buat daftar anggota perusahaan berdasarkan id eksternal pengguna

Buat daftar anggota perusahaan termasuk akun yang dinonaktifkan

Dapatkan peristiwa anggota:

Mengambil informasi tentang Manajer dan Bawahan pengguna

Dapatkan bawahan anggota tertentu

Dapatkan manajer anggota tertentu

Mengambil pesan untuk anggota

Dapatkan percakapan untuk anggota, termasuk pesan, pengirim, dan lampiran:

Dapatkan ID utas percakapan untuk anggota berdasarkan utas:

Dapatkan pesan untuk ID utas tertentu, untuk pengguna tertentu:

Dapatkan percakapan untuk halaman bot, termasuk pesan dan lampiran:

Hapus pesan tertentu di kotak masuk anggota menggunakan token integrasi khusus:

Dapatkan tanggal dan waktu saat anggota diundang dan mengeklaim akunnya:

Dapatkan tanggal dan waktu saat akun anggota dinonaktifkan:

Keluarkan pengguna dari Workplace

Atur foto profil

Tambahkan telepon anggota

Dapatkan keterampilan anggota

Tambahkan keterampilan

Hapus keterampilan

Dapatkan lencana anggota

Berikan lencana bawaan kepada pengguna

Berikan lencana khusus kepada pengguna

Nonaktifkan anggota

Hapus anggota

Dapatkan status frontline pengguna

Jalur `/{member-id}`

Jalur `/community/members`

Memfilter berdasarkan `external_id`

Jalur `/community/organization_members`