Integrasi VoIPstudio dengan Mavibot

Untuk menggunakan telefon VoIPstudio dalam Mavibot, anda perlu mencipta kunci API dalam akaun VoIPstudio anda, memasukkannya dalam tetapan integrasi, dan mengkonfigurasi penghantaran acara ke URL yang dipaparkan oleh Mavibot selepas integrasi disambungkan.

VoIPstudio ialah PBX awan dengan nombor telefon yang tersedia di lebih 70 negara. Tidak seperti operator telekomunikasi tradisional, ia menyokong pengguna dalaman, kumpulan dering, baris gilir, dan menu IVR, manakala bot beroperasi di atas PBX ini.

Bot boleh memulakan panggilan kepada pelanggan bagi pihak pekerja, memindahkan dan menamatkan panggilan, menyimpan rakaman, dan menghantar acara panggilan ke perbualan.

Mendapatkan Maklumat yang Diperlukan

Daftar di voipstudio.com dan beli nombor telefon di negara yang diperlukan.
Cipta pengguna dalam PBX — satu untuk setiap pekerja yang akan menerima panggilan. Panggilan dihantar ke semua peranti yang didaftarkan kepada pengguna, jadi anda tidak perlu menentukan nombor telefon berasingan untuk setiap pekerja.
Pergi ke Tetapan → API, cipta Kunci API, dan salinnya.

Menyambungkan Integrasi

Dalam tetapan telefon, pilih VoIPstudio dan masukkan:

Kunci API — kunci daripada akaun VoIPstudio anda.

Integrasi kini disambungkan. Untuk memutuskan sambungan, kosongkan medan Kunci API dan simpan tetapan.

Selepas menyimpan, URL pemberitahuan akan muncul pada halaman. Salinnya:

https://chatter.mavibot.ai/voipstudio_webhook/

Jangan terbitkan URL ini atau kongsikannya dengan sesiapa. Jika anda memutuskan dan menyambung semula integrasi, kunci kekal sama, jadi anda tidak perlu mengkonfigurasi pemberitahuan lagi.

Kemudian, dalam akaun VoIPstudio anda, pergi ke Integrasi → Webhooks → Dayakan → Tambah Webhook, tampal URL yang disalin, dan pilih acara berikut:

Perubahan Keadaan Panggilan — atau pilih Panggilan Berdering, Panggilan Bersambung, Panggilan Tamat, dan Panggilan Terlepas secara individu;
Rakaman Panggilan Sedia — jika anda memerlukan rakaman panggilan.

Tanpa konfigurasi ini, panggilan keluar masih akan berfungsi, tetapi acara panggilan tidak akan muncul dalam perbualan.

Pekerja

Dalam tetapan pekerja, isikan medan ID Pengguna VoIPstudio — pengecam numerik pengguna dalam PBX anda, contohnya 10002.

Masukkan ID pengguna PBX, bukan nombor telefon. Anda boleh mencari ID dalam senarai pengguna dalam akaun VoIPstudio anda. Tanpa itu, butang panggilan dalam kad pelanggan tidak akan berfungsi untuk pekerja tersebut.

Memanggil dari Kad Pelanggan

Butang panggilan akan muncul di sebelah nombor telefon pelanggan dalam kad perbualan.

VoIPstudio mula-mula memanggil pekerja pada semua peranti berdaftar mereka secara serentak. Sebaik sahaja pekerja menjawab, VoIPstudio memanggil pelanggan dan menyambungkan kedua-dua pihak.

Jika pekerja tidak menjawab, pelanggan tidak akan dipanggil.

Fungsi Kalkulator

Panggilan Pekerja-ke-Pelanggan

voipstudio_employee_call(client_phone, employee_user_id, caller_id)

Parameter:

client_phone — nombor telefon pelanggan. Diperlukan.
employee_user_id — ID pengguna VoIPstudio pekerja yang sepatutnya menerima panggilan pertama. Diperlukan.
caller_id — nombor telefon yang dipaparkan kepada pelanggan. Pilihan. Anda boleh hantar anonymous untuk menyembunyikan ID pemanggil.

Pindahkan Panggilan

voipstudio_transfer_call(phone, call_id)

Memindahkan panggilan aktif ke nombor telefon lain.

Parameter:

phone — nombor telefon ke mana panggilan harus dipindahkan. Diperlukan dan mesti menjadi parameter pertama.
call_id — pengecam panggilan. Pilihan. Jika diabaikan, panggilan semasa pelanggan diambil daripada pemboleh ubah voipstudio_call_id.

Tamatkan Panggilan

voipstudio_hangup_call(call_id)

Menamatkan panggilan aktif.

Parameter:

call_id — pengecam panggilan. Pilihan. Jika diabaikan, panggilan semasa pelanggan digunakan.

Dapatkan Pautan Rakaman Panggilan

voipstudio_get_record_link(call_id)

Mengembalikan pautan ke rakaman panggilan. Pautan biasanya disimpan secara automatik apabila acara rakaman-sedia diterima. Fungsi ini berguna jika acara tersebut tidak diterima.

Parameter:

call_id — pengecam panggilan. Pilihan. Jika diabaikan, panggilan semasa pelanggan digunakan.

Fungsi ini mencari 100 rakaman terkini dalam akaun. Untuk panggilan yang lebih lama pada PBX dengan volum tinggi, ia mungkin tidak menemui rakaman. Dalam kes itu, ambil rakaman terus daripada akaun VoIPstudio anda.

Panggilan Balik Semasa Panggilan

Semasa panggilan berlangsung, panggilan balik dihantar ke perbualan dalam format berikut:

voipstudio_call_event call.hangup

Nama acara dihantar tepat seperti yang diterima daripada VoIPstudio, contohnya call.ringing, call.connected, call.hangup, dan lain-lain. Acara yang tersedia bergantung pada acara yang anda pilih semasa mengkonfigurasi pemberitahuan.

Jika tiada nama acara diberikan, keadaan panggilan digunakan sebagai ganti:

INITIAL, RINGING, CONNECTED, ON_HOLD, HANGUP.

Panggilan balik berasingan dihantar apabila rakaman sedia:

voipstudio_call_event recording

Tunggu panggilan balik recording sebelum menggunakan pautan rakaman. Rakaman diproses selepas panggilan tamat, jadi pemboleh ubah voipstudio_record_link masih kosong apabila call.hangup diterima.

Jika dua pekerja dalam PBX anda sendiri bercakap antara satu sama lain, panggilan balik tidak dihantar ke perbualan dan tiada kad pelanggan dicipta.

Pemboleh Ubah Pelanggan Selepas Panggilan

Pemboleh Ubah	Nilai
voipstudio_call_id	ID Panggilan dalam VoIPstudio
voipstudio_call_state	Keadaan panggilan: `INITIAL`, `RINGING`, `CONNECTED`, `ON_HOLD`, `HANGUP`
voipstudio_call_duration	Tempoh panggilan dalam saat
voipstudio_call_cause	Sebab panggilan tamat
voipstudio_terminated_by	Siapa yang menamatkan panggilan: `caller` atau `callee`
voipstudio_record_link	Pautan ke rakaman panggilan
voipstudio_record_id	ID Rakaman dalam VoIPstudio

Rakaman Panggilan

Rakaman panggilan didayakan dalam tetapan VoIPstudio dan diuruskan oleh PBX itu sendiri. Jika anda memerlukan rakaman, dayakan rakaman panggilan dalam akaun VoIPstudio anda dan pilih acara Rakaman Panggilan Sedia semasa mengkonfigurasi pemberitahuan.

URL voipstudio_record_link dilindungi oleh kunci akses. Ia tidak boleh dibuka terus dalam penyemak imbas atau dikongsi dengan pelanggan. Anda boleh memuat turun rakaman daripada akaun VoIPstudio anda dalam bahagian sejarah panggilan.

Rakaman panggilan tertakluk kepada undang-undang yang berkenaan. Di Jerman, Perancis, Sepanyol, dan kebanyakan negeri A.S., persetujuan daripada kedua-dua pihak mungkin diperlukan, dan di sesetengah bidang kuasa notis lisan pada permulaan panggilan juga mungkin diperlukan. Pemilik akaun VoIPstudio bertanggungjawab untuk mematuhi keperluan ini.

Penyelesaian Masalah

Ralat	Punca
Ralat kebenaran semasa mencipta panggilan	Kunci API tidak betul atau telah tamat tempoh. Pastikan kunci dicipta di bawah Tetapan → API dan bukannya diperoleh melalui permintaan `login`.
Panggilan berfungsi, tetapi tiada panggilan balik muncul dalam perbualan	Tiada webhook dicipta dalam VoIPstudio, togol Dayakan dimatikan, atau URL yang salah dimasukkan. Salin keseluruhan URL dari halaman integrasi, termasuk kunci di hujung.
Panggilan tidak dapat dicipta atau peranti pekerja tidak berdering	Nombor telefon dimasukkan dan bukannya ID Pengguna VoIPstudio, atau pengguna tiada peranti berdaftar.
Panggilan balik `recording` tidak diterima	Rakaman panggilan tidak didayakan dalam VoIPstudio, atau acara Rakaman Panggilan Sedia tidak dipilih.

VoIPstudio dibilkan terus oleh VoIPstudio: terdapat yuran langganan untuk setiap pengguna PBX, ditambah caj panggilan. Ini berbeza daripada operator yang mengenakan caj seminit tanpa langganan berulang. Apabila menganggarkan kos, ambil kira bilangan pengguna yang dikonfigurasi, bukan hanya volum panggilan.