Buat Kontak
Pengembang dapat membuat kontak melalui API.
Metode Permintaan
POST
URL Permintaan
https://livedesk-api.engagelab.com/api/v2/accounts/contacts
Autentikasi
Untuk detail lebih lanjut, lihat deskripsi metode autentikasi di Ikhtisar API.
Permintaan
Contoh Permintaan
curl -X POST https://livedesk-api.engagelab.com/api/v2/accounts/contacts \
-H 'Content-Type: application/json' \
-H 'Authorization: Basic base64(api_key:api_secret)' \
{
"inbox_id": 407,
"name": "Test", // Opsional
"email": "alice@acme.inc",
"phone_number": "+123456789",
"avatar_url": "https://example.com/avatar.png",
"identifier": "1234567890",
}
curl -X POST https://livedesk-api.engagelab.com/api/v2/accounts/contacts \
-H 'Content-Type: application/json' \
-H 'Authorization: Basic base64(api_key:api_secret)' \
{
"inbox_id": 407,
"name": "Test", // Opsional
"email": "alice@acme.inc",
"phone_number": "+123456789",
"avatar_url": "https://example.com/avatar.png",
"identifier": "1234567890",
}
Tampilkan blok kode ini di jendela mengambang
Header Permintaan
| Field | Type | Description |
|---|---|---|
| Authorization | string | Gunakan Authorization: Basic base64(API Key:API Secret) untuk autentikasi. Silakan buka halaman API Key untuk mendapatkan API Key dan API Secret, gabungkan keduanya dengan tanda titik dua, lalu lakukan encoding Base64. |
| Content-Type | application/json | Ini adalah format data permintaan. Gunakan application/json. |
Parameter Body Permintaan
| Field | Type | Required | Description |
|---|---|---|---|
| inbox_id | String | Yes | ID kanal. Ini sesuai dengan Channel ID pada "Pengaturan Proyek - Kanal - kanal tertentu - Pengaturan". |
| name | String | No | Nama kontak. |
| String | No | Alamat email. | |
| phone_number | String | No | Nomor telepon kontak. |
| avatar_url | String | No | Tautan gambar avatar. |
| identifier | String | No | Pengidentifikasi pengguna. |
Respons
Contoh Respons
{
"payload": {
"contact": {
"additional_attributes": {},
"availability_status": "offline",
"email": null,
"id": 2219259,
"name": "Test",
"phone_number": null,
"blocked": false,
"identifier": null,
"thumbnail": "",
"custom_attributes": {},
"created_at": 1766571703,
"contact_inboxes": []
},
"contact_inbox": {
"inbox": null,
"source_id": null
}
}
}
{
"payload": {
"contact": {
"additional_attributes": {},
"availability_status": "offline",
"email": null,
"id": 2219259,
"name": "Test",
"phone_number": null,
"blocked": false,
"identifier": null,
"thumbnail": "",
"custom_attributes": {},
"created_at": 1766571703,
"contact_inboxes": []
},
"contact_inbox": {
"inbox": null,
"source_id": null
}
}
}
Tampilkan blok kode ini di jendela mengambang
Parameter Respons
| Field | Type | Required | Description |
|---|---|---|---|
| additional_attributes | Object | No | Atribut tambahan. |
| availability_status | String | No | Status online. Nilai default adalah offline. |
| String | No | Alamat email. | |
| id | String | No | ID kontak. |
| name | String | No | Nama. |
| phone_number | String | No | Nomor telepon. |
| blocked | String | No | Menunjukkan apakah diblokir. Nilai default adalah false. |
| identifier | String | No | Pengidentifikasi pengguna. |
| thumbnail | String | No | Thumbnail. |
| custom_attributes | String | No | Atribut kustom. |
| created_at | String | No | Stempel waktu pembuatan. |
| contact_inboxes | Array | No | Daftar kotak masuk yang terkait dengan kontak. |
| inbox | String | No | Kanal. |
| source_id | String | No | ID sumber. |
