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
Permissions or subscriptions required
- Anda harus berlangganan kontrak terpisah. Jika Anda ingin menggunakan layanan ini, harap hubungi tim Sales terkait.
- Hanya pengguna yang memiliki administrative privileges dapat mengonfigurasi pengaturan ini.
Sebelum menggunakan Incoming Webhook
Pertama, Anda perlu membuat URL yang akan Anda gunakan untuk mengatur Incoming Webhook.
- Visit https://account.miitel.jp/v1/signin dan log in ke MiiTel Analytics.
- Klik Open MiiTel Admin
di kanan atas halaman.
- Klik Third Party Integration > Incoming Webhook.
- Klik Create URL.
- URL akan muncul di layar pengaturan.
NOTE
- Untuk satu company ID, Anda bisa buat satu URL.
- Jika Anda ingin membuat ulang URL, hapus URL dengan mengklik [
] > Delete, lalu klik Create URL again.
Selanjutnya, berikan izin kepada pengguna yang akan menggunakan Incoming Webhook, lalu terima User ID.
- Klik User > User List.
- Klik [
- Cek Enable untuk menggunakan Incoming Webhook.
- Klik Save.
- Click [
- 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
- File format: M4A, MP3, WAV
Kirim file audio dengan PUT di URL di atas.
Request
| Desktipsi | |
|---|---|
| endpoint | Menerima URL setelah Anda membuat call history |
| method | PUT |
| param | - |
| data | File |
Response
| Status | Description |
|---|---|
| 200 | Upload completed |
| 403 | URL salah atau lebih dari tiga jam telah berlalu sejak Anda mengirim permintaan, dan sesi telah berakhir |
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.