# Webhook の送信先の設定

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

Source: https://voicast.jp/docs/dashboard-webhooks

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

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

イベントの中身と署名の検証は、[結果の受け取り](https://voicast.jp/docs/results.md#webhook)を参照してください。

## 送信先を登録する

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

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

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

## 画面の有効期限

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

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

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

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