ページの一覧

ドキュメント

Webhook の送信先の設定

会話の開始・終了・文字起こし・要約などを自社のシステムに送る Webhook の送信先を、管理画面で登録し、配信記録を確認する手順。

Markdown で見る

Webhook は、会話のイベントを登録した URL に送信する仕組みです。左のメニューの[Webhook]で、今の環境の送信先を管理します。開発者以上のロールで開けます。閲覧者には案内だけが表示されます。

イベント 送るとき
call.started 会話の開始
call.handoff_requested 担当者に転送
call.ended 会話の終了
call.transcript_ready 文字起こしができた
call.summary_ready 要約ができた
call.recording_ready 録音を保存した

イベントの中身と署名の検証は、結果の受け取りを参照してください。

送信先を登録する#

[Webhook]の画面の中に、Webhook の設定画面が表示されます。

  1. 送信先を追加し、受け取る URL を入力します。
  2. 受け取るイベントを選びます。
  3. 保存します。
  4. 送信先の署名シークレットを確認し、自社のサーバーで署名の検証に使います。

この画面では、ほかに本文の変換と、配信記録の確認・再送ができます。

画面の有効期限#

Webhook の設定画面は、開いてから 15 分間操作できます。時間が過ぎたら、右上の[再読み込み]を押してください。

送信の状態を会話ごとに見る#

会話記録の詳細の[Webhook の送信]に、その会話で送ったイベントごとの状態(成功・再送待ち・失敗など)が出ます。1 つでも失敗した送信先があれば「失敗」になります。「送信先なし」のときは、送信先が無いか、そのイベントを受け取る送信先がありません。

本番環境とテスト環境の送信先は別です。