送信先を追加する
管理画面の「設定 → API」の「Webhook」か、送信先を追加するで、受け取るURLを登録します。secret(whsec_…)は署名の確認に使います。この応答でだけ返るので、安全な場所に保管してください。
- URLは外部から届く
https://のみです。 - 送信先は1アカウント5件までです。
イベント
届く内容
POST で、次の JSON が届きます。data は通話を取得すると同じ形で、文字起こしを含みます。
署名を確かめる
v1 は、シークレットを鍵にした "<t>.<受け取った本文そのまま>" の HMAC-SHA256(16進)です。本文は JSON として解析する前の文字列のまま使ってください。t が5分以上ずれているものは受け付けないでください。
受け取ったら
- 10秒以内に
2xxを返してください。重い処理は受け取ったあとに別で行ってください。 2xx以外(タイムアウト・リダイレクトを含む)は、1分・5分・15分・1時間・3時間・6時間・12時間後に送り直します(計8回、約1日)。それでも届かなければ失敗として記録します。- 同じイベントが二度届くことがあります。
idで重複を除いてください。届く順番は保証しません。 - 送信の結果は、管理画面の「最近の送信」か送信記録で確かめられます(30日間保存)。