---
title: "POST /api/call/v2/webhook_pbx/{id}"
method: POST
path: "/api/call/v2/webhook_pbx/{id}"
tags: ["Call/WebhookPbx"]
---

# POST /api/call/v2/webhook_pbx/{id}

`POST /api/call/v2/webhook_pbx/{id}`

MiiTel Incoming Webhook 用のエンドポイントです。通話履歴を生成し、音声ファイルをアップロードするためのエンドポイントを返却します。
※ご契約いただいた一部のお客様のみご利用いただけます。詳細についてはお問い合わせください。

## Path parameters

- `id` string, required

## Request body

- WebhookPbxCreateCall
  - `call_data` object[], required — 発信または着信から切電までの全ての通話履歴のデータ
    - `call_data_id` string, required — それぞれの通話履歴データを一意に識別するための、call_data内で一意になる任意の文字列
    - `audio_file_type` 'wav' | 'm4a' | 'mp3', required — m4a, mp3, wav (pcm, μ-law)
    - `audio_channel_type` 'MONAURAL' | 'STEREO' — - 音声ファイルのチャンネル種別 - 未設定の場合は STEREO
    - `event_type` 'EXTENSION' | 'OUTGOING_CALL' | 'INCOMING_CALL' | 'AUTOMATIC_TRANSFER' | 'AUTOMATIC_RECORD' | 'EXTENSION_TRANSFER' | 'OUTGOING_TRANSFER', required
    - `group_name` string, nullable, required — 内線及び内線転送時に使用されたグループ名
    - `queue_name` string, nullable, required — 着信時に使用されたキュー名
    - `call_starts_at` string, date-time, required — 発信者の発信開始時間 Timezone UTC ISO 8601形式
    - `call_answered_at` string, date-time, nullable, required — 着信者の応答開始時間 Timezone UTC ISO 8601形式
    - `call_ends_at` string, date-time, required — 通話の終了時間 Timezone UTC ISO 8601形式
    - `circuit_number` string, nullable, required — 回線番号 例 - '+81312345678' - '*101' - '09009999999'
    - `participants` object[], required
      - `type` 'FROM' | 'TO', required — 'FROM' ... participant が発信側であることを示す 'TO' ... participant が着信側であることを示す
      - `stereo_lr` 'left' | 'right' — 'left' ... participant の音声が左チャンネルであることを示す 'right' ... participant の音声が右チャンネルであることを示す
      - `miitel_user_id` string, uuid, nullable, required — MiiTel Admin から取得した id
      - `number` string, required — 回線番号 例 - '+81312345678' - '*101' - '09009999999' - 'Anonymous'
      - `name` string, nullable, required — 話者名 取引先の名前を MiiTel Analytics に表示するには[連絡先を作成](https://support.miitel.jp/hc/ja/articles/360029561252)が必要
    - `tags` object[]
      - `value` string, required — タグ
  - `audio_upload_urls` object[] — 音声ファイルをアップロードし、解析を実行するためのパラメーターとエンドポイント
    - `singlepart` object — - 音声ファイルを分割しない場合のパラメーターとエンドポイント - url に音声ファイルをPUTすると解析が開始 - call_id: 通話履歴を含む、コールフロー全体を指すID - call_detail_id: 通話履歴のID
      - `url` string
      - `call_data_id` string
      - `call_id` string
      - `call_detail_id` string

## Response `201`

- WebhookPbxCreateCall
  - `call_data` object[], required — 発信または着信から切電までの全ての通話履歴のデータ
    - `call_data_id` string, required — それぞれの通話履歴データを一意に識別するための、call_data内で一意になる任意の文字列
    - `audio_file_type` 'wav' | 'm4a' | 'mp3', required — m4a, mp3, wav (pcm, μ-law)
    - `audio_channel_type` 'MONAURAL' | 'STEREO' — - 音声ファイルのチャンネル種別 - 未設定の場合は STEREO
    - `event_type` 'EXTENSION' | 'OUTGOING_CALL' | 'INCOMING_CALL' | 'AUTOMATIC_TRANSFER' | 'AUTOMATIC_RECORD' | 'EXTENSION_TRANSFER' | 'OUTGOING_TRANSFER', required
    - `group_name` string, nullable, required — 内線及び内線転送時に使用されたグループ名
    - `queue_name` string, nullable, required — 着信時に使用されたキュー名
    - `call_starts_at` string, date-time, required — 発信者の発信開始時間 Timezone UTC ISO 8601形式
    - `call_answered_at` string, date-time, nullable, required — 着信者の応答開始時間 Timezone UTC ISO 8601形式
    - `call_ends_at` string, date-time, required — 通話の終了時間 Timezone UTC ISO 8601形式
    - `circuit_number` string, nullable, required — 回線番号 例 - '+81312345678' - '*101' - '09009999999'
    - `participants` object[], required
      - `type` 'FROM' | 'TO', required — 'FROM' ... participant が発信側であることを示す 'TO' ... participant が着信側であることを示す
      - `stereo_lr` 'left' | 'right' — 'left' ... participant の音声が左チャンネルであることを示す 'right' ... participant の音声が右チャンネルであることを示す
      - `miitel_user_id` string, uuid, nullable, required — MiiTel Admin から取得した id
      - `number` string, required — 回線番号 例 - '+81312345678' - '*101' - '09009999999' - 'Anonymous'
      - `name` string, nullable, required — 話者名 取引先の名前を MiiTel Analytics に表示するには[連絡先を作成](https://support.miitel.jp/hc/ja/articles/360029561252)が必要
    - `tags` object[]
      - `value` string, required — タグ
  - `audio_upload_urls` object[] — 音声ファイルをアップロードし、解析を実行するためのパラメーターとエンドポイント
    - `singlepart` object — - 音声ファイルを分割しない場合のパラメーターとエンドポイント - url に音声ファイルをPUTすると解析が開始 - call_id: 通話履歴を含む、コールフロー全体を指すID - call_detail_id: 通話履歴のID
      - `url` string
      - `call_data_id` string
      - `call_id` string
      - `call_detail_id` string

---

[API](https://skmtc.net/miitel/apis/miitel-account-api.md) · [All operations](https://skmtc.net/miitel/apis/miitel-account-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/miitel/miitel-account-api/versions/19b9b4ab780a/schema)