＜通話イベント連携API仕様：着信ポップアップパラメータ＞
SimpleConnectは着信されるたびに、特定のURLをポップアップさせる設定が行えます。
ポップアップ設定はスキルグループ単位になります。
ポップアップされたとき、URLに渡すパラメータの仕様は以下になります。
▼着信ポップアップURL付加パラメータ仕様
| パラメータ名（既定） | 説明 | 設定値例 |
| originCallNo | 発信側電話番号 非通知番号の場合は「anonymous」になる |
09012345678 anonymous |
| originCalledNo | 着信側電話番号 | 05012345678 |
| queue | スキルグループID | 10018010 |
| queueName | スキルグループ名 | 窓口A |
| offeringTime | オファリングタイム（分まで） | 2022-07-20 16:43 |
| callSheetId | 通話コード | 292b03d7-3b1a-4865-af39-d17dbaff563a |
| loginName | 座席氏名 | 麹町 太郎 |
| ivrkey | 座席に着信されるまでのIVRキー入力値（複数回のキー入力があった場合、ハイフンで結合されます） フォーマット：[0-9|*|#]-[0-9|*|#]-...-[0-9|*|#] | 1-2-3-#-9 |
＜通話イベント連携API仕様：通話イベントデータ仕様＞
SimpleConnectの通話イベント設定により、以下の時点で通話データを特定のURLに自動送信できます。
|
・通話開始イベント ・通話終了イベント |
Request Method
GET/POST
データ送信形式
・GETの場合：URL query parameter
・POSTの場合：body payload（ヘッダーContent-Type: application/x-www-form-urlencoded）
▼送信データ（通話履歴）
| パラメータ名 | 説明 | 設定値例 | 通話開始 | 通話終了 | ||
| アウト バウンド |
イン バウンド |
アウト バウンド |
イン バウンド |
|||
| CallNo | 発信側電話番号 | 05012345678 |
◯ |
◯ | ◯ | ◯ |
| CalledNo | 受信側電話番号 | 09012345678 | ◯ | ◯ | ◯ | ◯ |
| CallSheetID | 通話履歴ID（一意キー） | 292b03d7-3b1a-4865-af39-d17dbaff563a | ◯ | ◯ | ◯ | ◯ |
| Begin | 通話開始時間（秒まで） | 2023-04-10 18:13:49 | ◯ | ◯ | ◯ | ◯ |
| End | 通話終了時間（秒まで） | 2023-04-10 18:22:57 | − | − | ◯ | ◯ |
| CallType | 通話タイプ | dialout：アウトバウンド normal：インバウンド transfer：インバウンド転送 dialTransfer：アウトバウンド転送 |
dialout | normal | dialout | normal |
| CallState | 通話状態 | Ring：発信中 Ringing：着信中 Link：通話開始 Unlink：通話終了 Hangup：未応答または拒否 |
Link | Link | Unlink Hangup |
Unlink Hangup |
| State | 通話応答ステータス | dealing：応答済み notDeal：不在 leak：アナウンス queueLeak：放棄呼 blackList：ブラックリスト voicemail：留守番（着信のみ、発信時の留守番は応答済みとして扱われる） limit：同時制限（チャンネル数オーバー） ※注意：「dealing」「voicemail」の場合のみ録音が残される |
dealing | Link | dealing notDeal leak blackList limit |
dealing notDeal leak queueLeak blackList voicemail limit |
| FileServer | 通話録音ファイルの保存サーバー | https://pbx-srtp99-https.simpleconnect.jp | ◯ | ◯ | ◯ | ◯ |
| RecordFile | 通話録音ファイルの保存サーバーパス | monitor/aws-srtp-99.1/20230410/20230410-181343_N00000012174_20264567_908075147688_cc-ali-0-1683623622.5776.mp3 | ◯ | ◯ | ◯ | ◯ |
| Agent | 座席番号 | 8004 | ◯ | ◯ | ◯ | ◯ |
| AgentName | 座席氏名 | 麹町 太郎 | ◯ | ◯ | ◯ | ◯ |
| OfferingTime | オファリングタイム | 2023-04-10 18:13:42 | ◯ | ◯ | ◯ | ◯ |
| RingingDate | インバウンド通話のみ 座席への着信時間（秒まで） |
2023-04-10 18:13:49 | − | ◯ | − | ◯ |
| QueueTime | インバウンド通話のみ スキルグループへの着信時間（秒まで） |
2023-04-10 18:13:49 | − | ◯ | − | ◯ |
| Queue | インバウンド通話のみ 通話する座席が所属するスキルグループ名 |
窓口A | − | ◯ | − | ◯ |
| IVRKEY | ※IVRにキー入力が設定された場合のみ設定される 座席に着信されるまでのIVRキー入力値（複数回のキー入力があった場合、ハイフンで結合されます） フォーマット：[0-9|*|#]-[0-9|*|#]-...-[0-9|*|#] | 1-2-3-#-9 | − | ◯ | − | ◯ |
