コールセンターcustomer_tokenクエリアPI - Udesk

Udesk コールセンターは、電話通話開始時に、顧客のサードパーティインターフェースをクエリし、その番号に対応するサードパーティ側の一意のトークンを取得して、ユーザーをマークすることをサポートしています。

基本的な使い方

ステップ1：プッシュするフィールドの設定

Udeskカスタマーサービスシステムの管理者アカウントでログインし、管理センター -> コールセンター -> その他の設定 -> 顧客customer_tokenクエリアクセスAPIに移動し、プッシュスイッチをオンにして、プッシュアドレスを入力します。

ステップ2：通話イベントプッシュの使用

クエリインターフェースアドレスを設定し、通話開始時にインターフェースをクエリしてcustomer_tokenを取得し、顧客のopen_api_tokenを更新します。

インターフェース開発仕様

サードパーティシステムは、以下の仕様に従ってインターフェースを開発する必要があります。

リクエスト方法

インターフェースは POST メソッドをサポートしている必要があります。Udeskがインターフェースをリクエストする際、リクエストパラメータをJSON形式でリクエストボディに配置し、リクエストの Content-Type は application/json;charset=utf8 になります。

リクエストアドレス

ユーザー定義ですが、プロトコルはHTTPSまたはHTTPである必要があります（つまり、インターフェースアドレスは http:// または https:// で始まる必要があります）。例：https://api.udesk.cn/callcenter

リクエストパラメータ説明

リクエストボディの形式は以下のように固定されています。

timestamp:
number:

各パラメータの説明：

パラメータ名	パラメータの意味	パラメータタイプ
timestamp	UNIXタイムスタンプ	Integer
number	顧客電話番号	String

リクエスト例

POST https://api.udesk.cn/callcenter

Content-Type: application/json;charset=utf8
Content-Length: 190

{
  "timestamp": 1501124998,
  "number": 18888888888
}

レスポンス形式

インターフェースが返すHTTPレスポンスは JSON 形式である必要があります。

  customer_token: "xxxx-1234-5511"