連絡先を検索
開発者は LiveDesk API を使用して、アカウント内の連絡先リストを照会し、連絡先のメールアドレス、電話番号、名前、または識別子で検索できます。
リクエストメソッド
GET
リクエスト URL
https://livedesk-api.engagelab.com/api/v2/accounts/contacts
認証
詳細については、API Overview の認証手順を参照してください。
リクエスト
リクエスト例
curl -X GET 'https://livedesk-api.engagelab.com/api/v2/accounts/contacts?q=support@engagelab.com' \
-H 'Content-Type: application/json' \
-H 'Authorization: Basic base64(api_key:api_secret)'
curl -X GET 'https://livedesk-api.engagelab.com/api/v2/accounts/contacts?q=support@engagelab.com' \
-H 'Content-Type: application/json' \
-H 'Authorization: Basic base64(api_key:api_secret)'
このコードブロックはフローティングウィンドウ内に表示されます
リクエストヘッダー
| Field | Type | Description |
|---|---|---|
| Authorization | string | Authorization: Basic base64(API Key:API Secret) を使用して認証します。API Keys ページで API key と API secret を取得し、コロンで連結して Base64 でエンコードしてください。 |
| Content-Type | application/json | データ形式です。JSON データには application/json を使用します。 |
クエリパラメータ
| Field | Type | Required | Description |
|---|---|---|---|
| q | string | No | 検索クエリです。連絡先の属性フィールドには email、phone_number、name、identifier が含まれます。 |
| page | integer | No | ページ番号です。デフォルトは 1 で、1 ページあたり 15 件です。 |
| labels | string / string[] | No | ラベルでフィルタリングします。複数のラベルに対応しており、いずれかのラベルに一致する連絡先が返されます。 |
| include_contact_inboxes | boolean | No | contact_inboxes を返すかどうかを指定します。デフォルトは true です。 |
| sort | string | No | ソートフィールドです。指定可能な値は email、name、phone_number、last_activity_at、created_at、company、city、country です。 |
| direction | string | No | ソート方向です。asc または desc を指定します。 |
レスポンス例
{
"meta": {
"count": 1,
"current_page": 1
},
"payload": [
{
"additional_attributes": {
"source_id": "email:ed5c8362-425c-4589-8adb-61a033d8c5fb.support@engagelab.com"
},
"availability_status": "offline",
"email": "support@engagelab.com",
"id": 64464046,
"name": "support",
"phone_number": null,
"blocked": false,
"identifier": null,
"thumbnail": "",
"custom_attributes": {},
"last_activity_at": 1778572024,
"created_at": 1778570103,
"contact_inboxes": [
{
"source_id": "support@engagelab.com",
"inbox": {
"id": 985,
"channel_id": 107,
"name": "Email",
"channel_type": "Channel::Email",
"provider": null
}
}
]
}
]
}
{
"meta": {
"count": 1,
"current_page": 1
},
"payload": [
{
"additional_attributes": {
"source_id": "email:ed5c8362-425c-4589-8adb-61a033d8c5fb.support@engagelab.com"
},
"availability_status": "offline",
"email": "support@engagelab.com",
"id": 64464046,
"name": "support",
"phone_number": null,
"blocked": false,
"identifier": null,
"thumbnail": "",
"custom_attributes": {},
"last_activity_at": 1778572024,
"created_at": 1778570103,
"contact_inboxes": [
{
"source_id": "support@engagelab.com",
"inbox": {
"id": 985,
"channel_id": 107,
"name": "Email",
"channel_type": "Channel::Email",
"provider": null
}
}
]
}
]
}
このコードブロックはフローティングウィンドウ内に表示されます
レスポンスパラメータ
| Field | Type | Required | Description |
|---|---|---|---|
| count | Int | No | クエリ結果の件数です。 |
| current_page | Int | No | クエリ結果のページ番号です。 |
| payload | Object | No | プロパティ構造です。 |
| additional_attributes | Object | No | 追加属性です。 |
| availability_status | String | No | オンラインステータスです。デフォルトは offline です。 |
| String | No | メールアドレスです。 | |
| id | String | No | 連絡先 ID です。 |
| name | String | No | 名前です。 |
| phone_number | String | No | 電話番号です。 |
| blocked | String | No | 連絡先がブロックされているかどうかを示します。デフォルトは false です。 |
| identifier | String | No | 連絡先の外部一意識別子です。インターフェースに表示される User ID に対応します。 |
| thumbnail | String | No | アバター URL です。 |
| custom_attributes | String | No | 連絡先属性です。 |
| created_at | String | No | 作成タイムスタンプです。 |
| last_activity_at | String | No | 最終更新タイムスタンプです。 |
| contact_inboxes | Array | No | 関連付けられたチャネル情報です。include_contact_inboxes=true の場合にのみ返されます。 |
| source_id | String | No | チャネル ID です。 |
| inbox | Object | No | チャネル情報です。 |
| id | String | No | チャネル ID です。 |
| name | String | No | チャネル名です。 |
| channel_type | String | No | チャネルタイプです。 |
| provider | String | No | プロバイダーです。たとえば、チャネルが WhatsApp の場合、値は whatsapp_cloud、engagelab_whatsapp、または twilio です。特定のプロバイダーがないチャネルの場合、値は null です。 |
