This page has been moved to MiiTel Developers. Please see "Incoming Webhook" page.

Note that this page will not be updated in the future.

With Incoming Webhook, you can integrate MiiTel with the phone system, and then you can manage, collect the data, and analyze the call histories made by the phone system on MiiTel Analytics.

Before using Incoming Webhook

First, you would need to create a URL that you will use to set Incoming Webhook.

1. Visit https://account.miitel.jp/v1/signin and log in to MiiTel Analytics.
2. Click  Open MiiTel Admin on the top right of the page.
3. Click Third Party Integration > Incoming Webhook.
4. Click Create URL.
5. The URL will appear on the settings screen.

Next, permit the user who will use Incoming Webhook, then receive the user ID.

1. Click User > User List.
2. Click [ ] on the user who will use Incoming Webhook > Edit.
3. Check Enable for Use Incoming Webhook.
4. Click Save.

5. Click [ ] on the user who received permission to use Incoming Webhook > Check User ID.
6. Click Copy ID.

Set up Incoming Webhook

1. Send a request to Incoming Webhook URL

Access the following URL and check the request method.

https://your_companyID.miitel.jp/openapi/index.html#tag/CallWebhookPbx

(Change your_companyID to your company ID.)

2. Upload the audio file

After you successfully send the request, you will receive the URL for uploading the audio file. You can upload the following file format.

• Audio channel: stereo, mono
• File format: M4A, MP3, WAV

Send the audio file by PUT in the URL above.

Request

Response

After you complete the settings above, please check if the call history is successfully created on the call history in MiiTel Analytics and see if there are no errors. For errors, please check the examples below for details.

• If you see the message Analytics engine is not started because the audio file has not been uploaded or is uploading, you may not have finished setting 2. Upload the audio file or the file upload may have failed.
• If you see the error message Failed to Analyze data because of call duration is too short to analyze or a problem in recording, the extension of the audio file and the file_type of the parameter may not be the same, or something may be wrong with the file.

Switch the speaker in the speech recognition results

If you are sending an audio file upload request with "audio_channel_type": "MONAURAL", the call history may be created with the user and customer's speeches being the opposite. (If the speaker is determined correctly, the user will be displayed in blue, and the customer will be displayed in red.

If the speakers in the call history were the opposite, you can follow the steps below to switch the speakers.

1. Visit https://account.miitel.jp/v1/signin and log in to MiiTel Analytics.
2. Click Call History .
3. Select the call history in which the speeches of the user and customer are the opposite.
4. Click Operation located on the top right of the graph > Swap user and customer.

Additional information: Data format for requests

The data format for requesting to create a call history is the following.

"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 MONAURAL, /*Unspecified is processed in 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}
        ]
    }
]