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

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

Dengan Incoming Webhook, Anda bisa integrasikan MiiTel dengan external phone system, dan manage, mengumpulkan data, dan menganalisis riwayat panggilan yang dibuat oleh external phone system di MiiTel Analytics

Sebelum menggunakan Incoming Webhook

Pertama, Anda perlu membuat URL yang akan Anda gunakan untuk mengatur Incoming Webhook.

1. Kunjungi https://account.miitel.jp/v1/signin dan log in ke MiiTel Analytics.
2. Klik  Open MiiTel Admin di kanan atas halaman.
3. Klik Third Party Integration > Incoming Webhook.
4. Klik Create URL.
5. URL akan muncul di layar pengaturan.

Selanjutnya, berikan izin kepada pengguna yang akan menggunakan Incoming Webhook, lalu terima User ID.

1. Klik User > User List.
2. Klik    pada user yang akan menggunakan Incoming Webhook > Edit.
3. Cek Enable untuk menggunakan Incoming Webhook.
4. Klik Save.

5. Klik    pada pengguna yang mendapat izin untuk menggunakan Incoming Webhook > Cek User ID.
6. Klik Copy ID.

Set up Incoming Webhook

1. Kirimkan request ke Incoming Webhook URL

Akses URL berikut dan periksa metode permintaan.

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

(ganti your_companyID ke Company ID_anda.)

2. Upload audio file

Setelah Anda berhasil mengirim permintaan, Anda akan menerima URL untuk diunggah berkas audio. Anda dapat mengunggah format file berikut.

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

Kirim file audio dengan PUT di URL di atas.

Request

Response

Setelah Anda menyelesaikan pengaturan di atas, silakan periksa apakah call history berhasil dibuat pada call history in MiiTel Analytics dan lihat apakah tidak ada kesalahan. Untuk kesalahan, harap periksa contoh di bawah ini untuk detailnya.

• Jika Anda melihat pesan berikut Analytics engine is not started because the audio file has not been uploaded or is uploading, Anda mungkin belum menyelesaikan pengaturan 2. Upload the audio file atau unggahan file mungkin gagal.
• Jika Anda melihat error message berikut Failed to Analyze data because of call duration is too short to analyze or a problem in recording,  ekstensi file audio dan file_type dari parameter mungkin tidak sama, atau mungkin ada yang salah dengan file tersebut.

Ganti pembicara di speech recognition results

Jika Anda mengirimkan permintaan upload file audio dengan "audio_channel_type": "MONAURAL", call history mungkin dibuat dengan ucapan user dan customer yang sebaliknya. (Jika pembicara ditentukan dengan benar, user akan ditampilkan dengan warna biru, dan customer akan ditampilkan dengan warna merah.

Jika speaker di call history sebaliknya, Anda dapat mengikuti langkah-langkah di bawah ini untuk mengganti speaker.

1. Kunjungi https://account.miitel.jp/v1/signin dan log in ke MiiTel Analytics.
2. Klik Call History .
3. Pilih call history yang pembicaraan dari user dan customer yang berlawanan.
4. Klik Operation yang terletak di atas kanan grafik > Tukar user dan customer.

Additional information: Data format for requests

Format data untuk request pembuatan call history adalah sebagai berikut

"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,
        "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}
        ]
    }
]