GET/cxtalk/contacts/{contactId}

CXトークの連絡先を取得する。

Authorization

oauth2

Access Token を指定します。 指定の方法や Access Token の取得方法は 共通仕様 を参照してください。

Scope

cxtalk
cxtalk.read

HTTP Request

GEThttps://www.worksapis.com/v1.0/cxtalk/contacts/{contactId}

Path Parameters

ParameterTypeDescription
contactId string 

CXトーク 連絡先 ID


required
example : contact2-a56d-44a4-5304-033e16fca8d1 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 

Response

HTTP 200

CXトーク 連絡先レスポンス

PropertyTypeDescription
contactId string 

CXトーク 連絡先 ID


readOnly : true 
contactName object (contactName) 

連絡先の名前情報


required 
emails array (ContactEmail) 

メールアドレスリスト


minItems : 0
maxItems : 100 
telephones array (ContactTelephone) 

電話番号リスト


minItems : 0
maxItems : 100 
organizations array (ContactOrganization) 

会社/所属リスト


minItems : 0
maxItems : 100 
events array (ContactEvent) 

誕生日・記念日リスト


minItems : 0
maxItems : 100 
locations array (ContactLocation) 

住所リスト


minItems : 0
maxItems : 100 
messengers array (ContactMessenger) 

SNS リスト


minItems : 0
maxItems : 100 
websites array (ContactWebsite) 

Web サイトリスト


minItems : 0
maxItems : 100 
memo string 

メモ


maxLength : 4000 
contactTagIds array (string) 

CXトーク 連絡先タグリスト


minItems : 0 
inquiryChannels array (CxTalkInquiryChannel) 

問い合わせ経路リスト

  • 問い合わせ経路と、その経路での顧客の名前が含まれる。
  • 問い合わせ経路が複数ある場合には、経路での最初の問い合わせ日時を基準に降順でソートされ、すべての経路が含まれる。

minItems : 0
readOnly : true 
cxtalkAccounts array (CxTalkAccount) 

窓口アカウントリスト


minItems : 0
readOnly : true 
createdTime string 

登録日時 (YYYY-MM-DDThh:mm:ssTZD)


format : date-time
readOnly : true 
modifiedTime string 

更新日時 (YYYY-MM-DDThh:mm:ssTZD)


format : date-time
readOnly : true 

contactName

PropertyTypeDescription
firstName string 

名

  • lastName が null の場合には必須

maxLength : 100
nullable : true 
lastName string 

姓

  • firstName が null の場合には必須

maxLength : 100
nullable : true 
phoneticFirstName string 

フリガナ 名


maxLength : 100
nullable : true 
phoneticLastName string 

フリガナ 姓


maxLength : 100
nullable : true 
nickName string 

ニックネーム


maxLength : 100
readOnly : true
nullable : true 
prefix string 

敬称
CXトーク 連絡先リストの取得 および CXトーク 連絡先の検索 では null となる。


maxLength : 100
nullable : true 
suffix string 

呼称
CXトーク 連絡先リストの取得 および CXトーク 連絡先の検索 では null となる。


maxLength : 100
nullable : true 
middleName string 

ミドルネーム
CXトーク 連絡先リストの取得 および CXトーク 連絡先の検索 では null となる。


maxLength : 100
nullable : true 

ContactEmail

PropertyTypeDescription
primary boolean 

代表メールアドレスフラグ

  • リスト内で 1 つのメールアドレスを代表 (primary=true) に指定する。
  • いずれも primary=true を指定しない場合は、最初のメールアドレスが代表メールアドレスとなる。

required 
email string 

メールアドレス


required
maxLength : 256
format : email 

ContactTelephone

PropertyTypeDescription
primary boolean 

代表電話フラグ

  • リスト内で 1 つの電話番号を代表 (primary=true) に指定する。
  • いずれも primary=true を指定しない場合は、最初の電話番号が代表電話となる。

required 
telephone string 

電話番号


required
maxLength : 100
pattern : [0-9\+\-*#PTpt()\u3000 ]+ 
type string 

電話番号タイプ

  • CELLPHONE: 携帯電話
  • WORK: 会社
  • HOME: 自宅
  • WORK_FAX: 会社 FAX
  • HOME_FAX: 自宅 FAX
  • OTHER: その他
  • CUSTOM: カスタム

default : CUSTOM
Allowed values : CELLPHONE, WORK, HOME, WORK_FAX, HOME_FAX, OTHER, CUSTOM 
customType string 

カスタム電話番号タイプ

  • 電話番号タイプが CUSTOM の場合に指定可能

maxLength : 100
nullable : true 

ContactOrganization

PropertyTypeDescription
primary boolean 

代表会社フラグ

  • リスト内で 1 つの会社/所属を代表 (primary=true) に指定する。
  • いずれも primary=true を指定しない場合は、最初の会社/所属が代表会社/代表所属となる。

required 
name string 

会社名


maxLength : 100 
department string 

部署名


maxLength : 100 
title string 

役職名


maxLength : 100 

ContactEvent

PropertyTypeDescription
primary boolean 

代表イベントフラグ

  • リスト内で 1 つのイベントを代表 (primary=true) に指定する。
  • いずれも primary=true を指定しない場合は、最初のイベントが代表イベントとなる。

required 
date string 

日付 (YYYY-MM-DD)


required
format : date 
type string 

イベントタイプ

  • BIRTHDAY: 誕生日
  • ANNIVERSARY: 記念日
  • OTHER: その他
  • CUSTOM: カスタム

default : CUSTOM
Allowed values : BIRTHDAY, ANNIVERSARY, OTHER, CUSTOM 
customType string 

カスタムイベントタイプ

  • イベントタイプが CUSTOM の場合に指定可能

maxLength : 100
nullable : true 
dayType string 

日付形式

  • SOLAR : 西暦
  • LUNAR : 旧暦

default : SOLAR
Allowed values : SOLAR, LUNAR 

ContactLocation

PropertyTypeDescription
primary boolean 

代表住所フラグ

  • リスト内で 1 つの住所を代表 (primary=true) に指定する。
  • いずれも primary=true を指定しない場合は、最初の住所が代表住所となる。

required 
address string 

住所


required
maxLength : 100 
type string 

住所タイプ

  • WORK: 会社
  • HOME: 自宅
  • OTHER: その他
  • CUSTOM: カスタム

default : CUSTOM
Allowed values : WORK, HOME, OTHER, CUSTOM 
zipCode string 

郵便番号


maxLength : 100 
customType string 

カスタム住所タイプ

  • 住所タイプが CUSTOM の場合に指定可能

maxLength : 100
nullable : true 

ContactMessenger

PropertyTypeDescription
primary boolean 

代表 SNS フラグ

  • リスト内で 1 つの SNS を代表 (primary=true) に指定する。
  • いずれも primary=true を指定しない場合は、最初の SNS が代表 SNS となる。

required 
id string 

SNS ID


required
maxLength : 100 
type string 

SNSタイプ

  • FACEBOOK: Facebook
  • LINE: LINE
  • X: X(Twitter)
  • CUSTOM: カスタム

default : CUSTOM
Allowed values : FACEBOOK, LINE, X, CUSTOM 
customType string 

カスタム SNS タイプ

  • SNS タイプが CUSTOM の場合に指定可能

maxLength : 100
nullable : true 

ContactWebsite

PropertyTypeDescription
primary boolean 

代表 Web サイトフラグ

  • リスト内で 1 つの Web サイトを代表 (primary=true) に指定する。
  • いずれも primary=true を指定しない場合は、最初の Web サイトが代表 Web サイトとなる。

required 
url string 

Web サイト URL


required
maxLength : 100
format : uri 

CxTalkInquiryChannel

PropertyTypeDescription
channelType string 

問い合わせ経路の種類

  • LINE_OA: LINE公式アカウント
  • WORKS: 外部の LINE WORKS アカウント
  • MAIL: メール

required
Allowed values : LINE_OA, WORKS, MAIL 
displayName string 

問い合わせ経路における顧客の名前

  • MAIL の場合には、メールアドレス

nullable : true 

CxTalkAccount

PropertyTypeDescription
name string 

窓口アカウント名


required 

Response Example

example

1{2  "contactId": "contact2-a56d-44a4-5304-033e16fca8d1",3  "contactName": {4    "lastName": "顧客",5    "firstName": "太郎",6    "nickName": "顧客太郎",7    "phoneticFirstName": null,8    "phoneticLastName": null,9    "prefix": null,10    "suffix": null,11    "middleName": null12  },13  "emails": [14    {15      "email": "example@example.com",16      "primary": true17    }18  ],19  "telephones": [20    {21      "type": "CELLPHONE",22      "telephone": "090-0000-0001",23      "primary": true,24      "customType": null25    }26  ],27  "organizations": [28    {29      "name": "example company name",30      "department": "department",31      "title": "title",32      "primary": true33    }34  ],35  "locations": [36    {37      "address": "example address",38      "zipCode": "100-0001",39      "type": "WORK",40      "primary": true,41      "customType": null42    }43  ],44  "events": [45    {46      "date": "2026-01-09",47      "dayType": "SOLAR",48      "type": "BIRTHDAY",49      "primary": true,50      "customType": null51    }52  ],53  "messengers": [54    {55      "id": "example1",56      "type": "LINE",57      "primary": true,58      "customType": null59    }60  ],61  "websites": [62    {63      "url": "https://example.com",64      "primary": true65    }66  ],67  "memo": "memo",68  "contactTagIds": [69    "ctag2a81-94b6-4642-6903-03aa7977da91"70  ],71  "inquiryChannels": [72    {73      "channelType": "LINE_OA",74      "displayName": "顧客太郎"75    },76    {77      "channelType": "MAIL",78      "displayName": "example@example.com"79    }80  ],81  "cxtalkAccounts": [82    {83      "name": "商品問い合わせ窓口"84    }85  ],86  "createdTime": "2026-08-10T11:05:41+09:00",87  "modifiedTime": "2026-08-10T11:09:37+09:00"88}

HTTP 403

Forbidden

HTTP 404

Not Found