Untuk menggunakan telepon Verimor dalam Mavibot, anda perlu mendapatkan kunci API dari akaun Verimor anda dan memasukkannya dalam tetapan integrasi.

Verimor ialah penyedia telekomunikasi Turki. Produk Bulut Santralim ialah PBX awan: pekerja bekerja dengan sambungan dalaman, dan panggilan diarahkan melalui sambungan tersebut.

Bot boleh menghubungkan pekerja dengan pelanggan, memindahkan dan menamatkan panggilan, mendapatkan rakaman, dan menghantar peristiwa panggilan ke perbualan.

Mendapatkan data yang diperlukan

  1. Aktifkan perkhidmatan Bulut Santralim dengan Verimor dan buat sambungan dalaman untuk pekerja anda.
  2. Buka Online İşlem Merkezi → Bulut Santralim → Santral Ayarlarım dan salin kunci API. Ia kelihatan seperti ini:
K12345678-1234-5678-4321-123456789012
  1. Catat sambungan dalaman pekerja. Anda perlu menyatakannya dalam tetapan akses.

Kunci API dikongsi di seluruh PBX dan digunakan untuk panggilan dan menerima peristiwa. Jika anda menjana semula kunci dalam papan pemuka Verimor, pastikan anda menyimpan borang sambungan semula. Jika tidak, kedua-dua panggilan dan peristiwa perbualan akan berhenti berfungsi.

Sambungan

Dalam tab telefon, pilih Verimor dan masukkan:

  • Kunci API — kunci dari bahagian Santral Ayarlarım.
  • Nombor keluar — nombor luaran yang akan dilihat oleh pelanggan, dalam format 908505320000. Medan ini adalah pilihan. Jika dibiarkan kosong, nombor yang diberikan kepada sambungan dalaman pekerja akan digunakan.


Integrasi kini disambungkan.

Untuk memutuskan integrasi, kosongkan medan Kunci API dan simpan tetapan.

Anda tidak perlu mengkonfigurasi URL pemberitahuan secara manual. Mavibot menetapkannya secara automatik dalam PBX anda apabila kunci API disimpan.

Pekerja

Dalam tetapan pekerja, isikan sambungan dalaman pekerja (dahili) — biasanya 3–4 digit, contohnya 1001.

Masukkan sambungan dalaman PBX, bukan nombor telefon bimbit pekerja. 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.

PBX mula-mula memanggil sambungan dalaman pekerja. Hanya selepas pekerja menjawab, ia memanggil pelanggan.

Urutan ini disengajakan: pelanggan tidak akan mendengar kesunyian di talian kerana pekerja sudah bersambung apabila telefon pelanggan mula berdering.

Fungsi Kalkulator

Panggilan Pekerja-ke-Pelanggan

verimor_employee_call(client_phone, employee_extension, caller_id)

Parameter:

  • client_phone — nombor telefon pelanggan. Wajib. Gunakan format Turki 908505320000, atau 00493027590915 untuk panggilan antarabangsa.
  • employee_extension — sambungan dalaman pekerja yang telefonnya akan berdering. Wajib.
  • caller_id — nombor yang akan dilihat oleh pelanggan. Pilihan. Jika diabaikan, nombor keluar dari tetapan sambungan digunakan.

Fungsi ini mengembalikan call_uuid — pengecam panggilan. Ia juga disimpan dalam pemboleh ubah verimor_call_uuid.

Pindah Panggilan

verimor_transfer_call(employee_extension, call_uuid)

Memindahkan panggilan semasa ke sambungan dalaman lain.

Parameter:

  • employee_extension — sambungan dalaman ke mana panggilan akan dipindahkan. Wajib.
  • call_uuid — pengecam panggilan. Pilihan. Jika diabaikan, panggilan terbaru pelanggan digunakan.

Tamat Panggilan

verimor_hangup_call(call_uuid)

Parameter:

  • call_uuid — pengecam panggilan. Pilihan. Jika diabaikan, panggilan terbaru pelanggan digunakan.

Dapatkan Pautan Rakaman Panggilan

verimor_get_record_link(call_uuid)

Meminta pautan baharu ke rakaman panggilan.

Parameter:

  • call_uuid — pengecam panggilan. Pilihan. Jika diabaikan, panggilan terbaru pelanggan digunakan.

Panggilan Balik Semasa Panggilan

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

verimor_call_event answer

Peristiwa yang mungkin:

Peristiwa Bila ia dicetuskan
ringing Panggilan sedang berdering
answer Panggilan telah dijawab
hangup Panggilan telah tamat
user_hangup Pekerja menamatkan panggilan

Panggilan antara pekerja tidak muncul dalam perbualan.

Senario biasa "tiada jawapan → hantar mesej dalam messenger" boleh dicetuskan oleh hangup dan menyemak pemboleh ubah verimor_call_answered.

Pemboleh Ubah Pelanggan Selepas Panggilan

Pemboleh Ubah Nilai
verimor_call_uuid Pengecam panggilan
verimor_call_direction Arah: inbound — pelanggan memanggil anda, outbound — anda memanggil pelanggan
verimor_call_extension Sambungan dalaman pekerja yang mengendalikan panggilan
verimor_call_duration Tempoh panggilan dalam saat
verimor_call_answered 1 — panggilan dijawab, 0 — tidak
verimor_hangup_cause Kod yang menunjukkan sebab panggilan tamat
verimor_has_record 1 — rakaman wujud, 0 — tiada rakaman
verimor_record_link Pautan ke rakaman panggilan selepas memanggil verimor_get_record_link()

Kod Sebab Tamat Panggilan

Nilai paling biasa verimor_hangup_cause ialah:

Kod Makna
NORMAL_CLEARING Panggilan telah selesai dan tamat secara normal
USER_BUSY Sibuk
NO_ANSWER Tiada jawapan
ORIGINATOR_CANCEL Pemanggil menutup sebelum panggilan dijawab
CALL_REJECTED Panggilan ditolak
UNALLOCATED_NUMBER Nombor tidak sah
NO_USER_RESPONSE Pelanggan tidak tersedia
NOT_ALLOWED_BY_IYS Tiada kebenaran dalam İYS, daftar kebenaran Turki untuk panggilan komersial

Rakaman Panggilan

Rakaman panggilan mesti diaktifkan dalam tetapan PBX Verimor anda. Rakaman disimpan dalam akaun Verimor anda.

⏳ Pautan rakaman sah selama 60 minit dari masa ia diminta. Selepas itu, ia berhenti berfungsi. Verimor juga membenarkan tidak lebih daripada lima permintaan pautan rakaman seminit setiap kunci API.

Maksudnya:

  • Pemboleh ubah verimor_record_link tidak diisi secara automatik. Anda mesti memanggil verimor_get_record_link() terlebih dahulu.
  • Dalam senario yang menghantar rakaman, panggil verimor_get_record_link() pada masa rakaman dihantar, bukan lebih awal.
  • Semak verimor_has_record terlebih dahulu supaya anda tidak membazir had permintaan pada panggilan yang tiada rakaman.
  • Jika anda perlu menyimpan rakaman secara kekal, simpan fail ke storan anda sendiri sejurus selepas panggilan.
  • Arkib rakaman kekal tersedia dalam papan pemuka Verimor, di mana rakaman boleh dimainkan dan dimuat turun kemudian.

Rakaman panggilan dikawal oleh undang-undang. Di Turki, ia tertakluk kepada keperluan KVKK: pelanggan mesti dimaklumkan tentang rakaman, dan penyimpanan data peribadi mesti mempunyai asas yang sah. Pemilik akaun Verimor bertanggungjawab untuk mematuhi keperluan yang berkenaan.

Penyelesaian Masalah

Ralat Punca / Penyelesaian
Gecersiz anahtar Kunci API tidak sah. Dapatkan kunci semasa dari bahagian Santral Ayarlarım.
extension 1005 not found Sambungan dalaman tidak wujud dalam PBX anda. Pastikan tetapan pekerja mengandungi dahili yang wujud.
"Sambungan dalaman Verimor tidak dinyatakan" Tetapan pekerja kosong atau mengandungi nombor telefon bimbit dan bukannya sambungan dalaman.
Panggilan berfungsi, tetapi tiada panggilan balik muncul dalam perbualan URL pemberitahuan tidak dikonfigurasi. Simpan borang sambungan semula.
Panggilan berhenti berfungsi selepas menukar kunci API Kunci telah dijana semula dalam papan pemuka Verimor. Masukkan kunci baharu dalam borang sambungan dan simpannya.
Pautan rakaman tidak dibuka Pautan telah tamat tempoh. Minta yang baharu dengan verimor_get_record_link() atau buka rakaman dalam papan pemuka Verimor.
Pautan rakaman tidak dikembalikan Had lima permintaan seminit telah dicapai, atau panggilan tiada rakaman. Semak verimor_has_record.