Skip to main content

送信先を追加する

管理画面の「設定 → 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日間保存)。