Incoming Webhook を利用すると、電話システムと MiiTel を連携し、電話システムの応対履歴を MiiTel Analytics で管理、集計、音声解析できます。

Incoming Webhook の使用準備

まず、Incoming webhook の設定に使用する URL を作成します。

1. https://account.miitel.jp/v1/signin にアクセスし、管理者権限があるユーザーで MiiTel Analytics にログインします。

2. 画面右上の [MiiTel Admin を開く] をクリックします。

3. [外部連携] > [Incoming Webhook] をクリックします。
4. [URL を作成] をクリックします。
5. 作成された URL が表示されます。

次に、応対ユーザーとして使用するユーザーに Incoming webhook の利用を許可し、ユーザー ID を取得します。

1. [ユーザー] > [ユーザー設定] をクリックします。
2. 使用するユーザーの    > [編集] をクリックします。
3. 「Incoming Webhook の利用」の [利用許可] にチェックを入れます。
4. [保存] をクリックします。

5. Incoming Webhook の利用を許可したユーザーの    > [ユーザー ID を確認] をクリックします。
6. [ID をコピーする] をクリックします。

Incoming Webhook を使用する

1. Incoming Webhook URL にリクエストを送る

以下 URL にアクセスして、リクエスト形式を確認してください。

https://企業 ID.miitel.jp/openapi/index.html#tag/CallWebhookPbx

(「企業 ID」は、お客様組織の企業 ID に変更してください)

2. 音声ファイルをアップロードする

1. でリクエストの送信に成功すると、音声ファイルアップロード用の URL を取得できます。以下は、アップロードできる音声ファイル形式です。

• オーディオチャンネル: ステレオ、モノラル
• ファイル形式: M4A, MP3, WAV

音声ファイルアップロード用の URL へ音声ファイルを PUT で送信します。

Request

Response

上記設定が完了したら、以下を参考に、MiiTel Analytics の応対履歴に正しく応対履歴が作成されているか、エラーが出ていないか確認してください。

• 「音声ファイルがアップロードされていない、または、アップロード中のため、分析が開始されていません。」というエラーメッセージが表示される場合は「2. 音声ファイルをアップロードする」の設定が実行されていない、または、失敗していると考えられます。

• 「通話時間が短すぎる、または音声に問題があるため、分析結果が表示されていません。」というエラーメッセージが表示される場合は、パラメータの file_type と音声拡張子が一致しない、または、ファイルが壊れていると考えられます。

音声認識結果の話者を入れ替える

"audio_channel_type": "MONAURAL" で音声ファイルのアップロードリクエストを送信している場合、ユーザーと取引先の話者判定が逆になった応対履歴が作成されることがあります。(正しく話者判定された場合、ユーザーが青色、取引先が赤色で表示されます)

話者判定が逆になった場合、以下手順で話者を入れ替え、適切な話者を設定できます。

1. https://account.miitel.jp/v1/signin にアクセスし、MiiTel Analytics にログインします。
2.  [応対履歴] をクリックします。
3. ユーザーと取引先が逆になっている通話履歴を選択します。
4. グラフ右上の [操作] > [ユーザーと取引先を入れ替える] をクリックします。

補足: リクエストのデータ形式

応対履歴生成リクエストのデータ形式は、以下のとおりです。

"call_data": [
    {
        "call_data_id": str,
        "audio_file_type": str,
        "event_type": str,
        "groupname": str or null,
        "queue_name": str or null,
        "call_starts_at": str(datetime),
        "call_answered_at": str(datetime) or null,
        "call_ends_at": str(datetime),
        "circuit_number": str or null,
        "audio_channel_type": stereo or monoral, /*未指定は stereo で処理される*/
        "participants": [
            {
              "type": "FROM" or "TO",
              "stereo_lr": "left" or "right",
              "miitel_user_id": str or null,
              "number": str,
              "name": str or null
            }
        ],
        "tags": [
            {"value": str}
        ]
    }
]