コール監査エンタープライズAPI: エンドポイントと例

コール監査API v1の実践リファレンス — 監査モジュールとPABXまたは電話プラットフォームを連携するための統合チャネルです。エンタープライズプランの組織と組織のAPIキーが必要です。

認証

キーは /dashboard/organization/auditorias で作成します（OWNER/ADMINのみ。組織ごとに最大10個のアクティブなキー）。すべてのリクエストで送信します:

Authorization: Bearer vpt_live_SUA_CHAVE_DA_ORG

• シークレットは作成時に一度だけ表示されます。当社はハッシュのみを保存します。
• 各キーにはスコープ（audits:write、audits:read、usage:read、analytics:read など）が含まれます。付与されていないものはデフォルトで拒否されます。
• レート制限: キーごとに毎分60リクエスト。

監査を作成する

curl -X POST https://www.vozparatexto.com.br/api/v1/audits \
  -H "Authorization: Bearer vpt_live_SUA_CHAVE_DA_ORG" \
  -H "Content-Type: application/json" \
  -d '{
    "audio_url": "https://pbx.suaempresa.com/gravacoes/8841.mp3",
    "webhook_url": "https://api.suaempresa.com/hooks/auditorias",
    "idempotency_key": "chamada-8841",
    "agent_external_id": "maria.souza",
    "team": "vendas-sp"
  }'

ルール:

• audio_url（httpsのみ、公開URL）または upload_id（下記参照）を受け付けます。
• webhook_urlは必須です。結果はポーリングではなくウェブフックで届きます。
• idempotency_keyは永続的に保存されます。同じキーで再送しても監査が重複しません。
• 即時応答: 202 { "audit_id": "...", "status": "queued" }.

確認: GET /api/v1/audits（一覧）と GET /api/v1/audits/{id}（詳細）。

公開URLがない録音の場合

URLを公開できないPABXの場合は、一時的なアップロードURLをリクエストします:

curl -X POST https://www.vozparatexto.com.br/api/v1/uploads \
  -H "Authorization: Bearer vpt_live_SUA_CHAVE_DA_ORG"

レスポンスに含まれる put_url は1時間有効です。PUTでファイルをアップロードし、監査作成時に返された upload_id を使用してください。

オペレーションの登録とメトリクス

ウェブフックと保証

• 配信はHMAC-SHA256で署名されます（X-VPT-Signature + X-VPT-Event）。処理前に検証してください。
• 試行ごとのタイムアウトは15秒、最大6回再試行し、5分から24時間のバックオフがあります。
• 停止したジョブも消えません。10分以上停止したキューは再キューされ、60分以上停止した処理はエラーウェブフック付きの失敗になります。送信されたすべての音声は最終コールバックを生成します。

詳細は ウェブフックと通知 をご覧ください。

FAQ

関連記事

• コール監査
• ウェブフックと通知
• 文字起こしAPI

解決しませんか？ チケットを開く — サポートチームが迅速に対応します。