Mavibot'ta Verimor telefonisini kullanmak için Verimor hesabınızdan bir API anahtarı almanız ve entegrasyon ayarlarına girmeniz gerekir.

Verimor, Türk bir telekomünikasyon sağlayıcısıdır. Bulut Santralim ürünü bulut tabanlı bir santraldir: çalışanlar dahili hatlarla çalışır ve aramalar bu hatlar üzerinden yönlendirilir.

Bot, bir çalışanı müşteriyle bağlayabilir, aramaları aktarabilir ve sonlandırabilir, kayıtları alabilir ve arama olaylarını sohbete gönderebilir.

Gerekli verileri alma

  1. Verimor ile Bulut Santralim hizmetini etkinleştirin ve çalışanlarınız için dahili hatlar oluşturun.
  2. Online İşlem Merkezi → Bulut Santralim → Santral Ayarlarım bölümünü açın ve API anahtarını kopyalayın. Şuna benzer:
K12345678-1234-5678-4321-123456789012
  1. Çalışanların dahili hatlarını not edin. Bunları erişim ayarlarında belirtmeniz gerekecek.

API anahtarı tüm santral genelinde paylaşılır ve hem aramalar hem de olayların alınması için kullanılır. Verimor panelinde yeniden oluşturursanız, bağlantı formunu tekrar kaydettiğinizden emin olun. Aksi takdirde hem aramalar hem de sohbet olayları çalışmayı durdurur.

Bağlantı

Telefon sekmesinde Verimor seçeneğini seçin ve şunları girin:

  • API anahtarı — Santral Ayarlarım bölümündeki anahtar.
  • Giden numara — müşterinin göreceği dış numara, 908505320000 biçiminde. Bu alan isteğe bağlıdır. Boş bırakılırsa, çalışanın dahili hattına atanan numara kullanılır.

Entegrasyon artık bağlandı.

Entegrasyonu kaldırmak için API anahtarı alanını temizleyin ve ayarları kaydedin.

Bildirim URL'sini manuel olarak yapılandırmanız gerekmez. Mavibot, API anahtarı kaydedildiğinde bunu santralinizde otomatik olarak ayarlar.

Çalışanlar

Çalışan ayarlarında, çalışanın dahili hattını (dahili) doldurun — genellikle 3–4 haneli, örneğin 1001.

Santral dahili hattını girin, çalışanın cep telefonu numarasını değil. Bu olmadan, müşteri kartındaki arama düğmesi o çalışan için çalışmaz.

Müşteri kartından arama

Sohbet kartındaki müşterinin telefon numarasının yanında bir arama düğmesi görünecektir.

Santral önce çalışanın dahili hattını arar. Yalnızca çalışan cevapladıktan sonra müşteriyi arar.

Bu sıra bilinçlidir: müşteri hatta sessizlik duymaz çünkü müşterinin telefonu çalmaya başladığında çalışan zaten bağlıdır.

Hesap Makinesi Fonksiyonları

Çalışandan Müşteriye Arama

verimor_employee_call(client_phone, employee_extension, caller_id)

Parametreler:

  • client_phone — müşterinin telefon numarası. Zorunlu. Türkiye formatını kullanın 908505320000 veya uluslararası aramalar için 00493027590915.
  • employee_extension — telefonu çalacak çalışanın dahili hattı. Zorunlu.
  • caller_id — müşterinin göreceği numara. İsteğe bağlı. Belirtilmezse, bağlantı ayarlarındaki giden numara kullanılır.

Fonksiyon, arama tanımlayıcısı olan call_uuid değerini döndürür. Ayrıca verimor_call_uuid değişkenine kaydedilir.

Aramayı Aktarma

verimor_transfer_call(employee_extension, call_uuid)

Mevcut aramayı başka bir dahili hatta aktarır.

Parametreler:

  • employee_extension — aramanın aktarılacağı dahili hat. Zorunlu.
  • call_uuid — arama tanımlayıcısı. İsteğe bağlı. Belirtilmezse, müşterinin en son araması kullanılır.

Aramayı Sonlandırma

verimor_hangup_call(call_uuid)

Parametreler:

  • call_uuid — arama tanımlayıcısı. İsteğe bağlı. Belirtilmezse, müşterinin en son araması kullanılır.

Arama Kaydı Bağlantısını Alma

verimor_get_record_link(call_uuid)

Arama kaydına yeni bir bağlantı ister.

Parametreler:

  • call_uuid — arama tanımlayıcısı. İsteğe bağlı. Belirtilmezse, müşterinin en son araması kullanılır.

Arama Sırasında Geri Aramalar

Arama ilerledikçe, sohbete aşağıdaki biçimde geri aramalar gönderilir:

verimor_call_event answer

Olası olaylar:

Olay Ne zaman tetiklenir
ringing Arama çalıyor
answer Arama cevaplandı
hangup Arama sona erdi
user_hangup Çalışan aramayı sonlandırdı

Çalışanlar arası aramalar sohbette görünmez.

Tipik bir "cevap yok → mesajlaşma uygulamasında mesaj gönder" senaryosu hangup ile tetiklenebilir ve verimor_call_answered değişkeni kontrol edilebilir.

Arama Sonrası Müşteri Değişkenleri

Değişken Değer
verimor_call_uuid Arama tanımlayıcısı
verimor_call_direction Yön: inbound — müşteri sizi arar, outbound — siz müşteriyi ararsınız
verimor_call_extension Aramayı yöneten çalışanın dahili hattı
verimor_call_duration Arama süresi saniye cinsinden
verimor_call_answered 1 — arama cevaplandı, 0 — cevaplanmadı
verimor_hangup_cause Aramanın neden sona erdiğini gösteren kod
verimor_has_record 1 — kayıt var, 0 — kayıt yok
verimor_record_link verimor_get_record_link() çağrıldıktan sonra arama kaydına bağlantı

Kapatma Neden Kodları

verimor_hangup_cause değerinin en yaygın değerleri:

Kod Anlam
NORMAL_CLEARING Arama tamamlandı ve normal şekilde sona erdi
USER_BUSY Meşgul
NO_ANSWER Cevap yok
ORIGINATOR_CANCEL Arayan, arama cevaplanmadan önce kapattı
CALL_REJECTED Arama reddedildi
UNALLOCATED_NUMBER Geçersiz numara
NO_USER_RESPONSE Abone müsait değil
NOT_ALLOWED_BY_IYS Ticari aramalar için Türk izin kaydı olan İYS'de izin yok

Arama Kayıtları

Arama kaydı, Verimor santral ayarlarınızda etkinleştirilmelidir. Kayıtlar Verimor hesabınızda saklanır.

⏳ Kayıt bağlantıları, istendiği andan itibaren 60 dakika geçerlidir. Bundan sonra çalışmayı durdururlar. Verimor ayrıca API anahtarı başına dakikada en fazla beş kayıt bağlantısı isteğine izin verir.

Bu ne anlama gelir:

  • verimor_record_link değişkeni otomatik olarak doldurulmaz. Önce verimor_get_record_link() çağrısı yapmalısınız.
  • Kayıt gönderen bir senaryoda, verimor_get_record_link() işlevini kaydın gönderildiği anda çağırın, önceden değil.
  • Önce verimor_has_record kontrol edin, böylece kaydı olmayan aramalarda istek limitini boşa harcamazsınız.
  • Bir kaydı kalıcı olarak saklamanız gerekiyorsa, dosyayı aramadan hemen sonra kendi depolama alanınıza kaydedin.
  • Kayıt arşivi Verimor panelinde kullanılabilir durumda kalır; kayıtlar daha sonra oynatılabilir ve indirilebilir.

Arama kaydı yasalarla düzenlenir. Türkiye'de KVKK gereksinimlerine tabidir: müşteri kayıt hakkında bilgilendirilmeli ve kişisel verilerin saklanması yasal bir dayanağa sahip olmalıdır. Geçerli gereksinimlere uymak Verimor hesap sahibinin sorumluluğundadır.

Sorun Giderme

Hata Neden / Çözüm
Gecersiz anahtar Geçersiz API anahtarı. Santral Ayarlarım bölümünden güncel anahtarı alın.
extension 1005 not found Dahili hat santralinizde mevcut değil. Çalışan ayarlarında mevcut bir dahili olduğundan emin olun.
"Verimor dahili hattı belirtilmemiş" Çalışan ayarları boş veya dahili hat yerine cep telefonu numarası içeriyor.
Aramalar çalışıyor, ancak sohbette geri arama görünmüyor Bildirim URL'si yapılandırılmadı. Bağlantı formunu tekrar kaydedin.
API anahtarını değiştirdikten sonra aramalar çalışmayı durdurdu Anahtar Verimor panelinde yeniden oluşturuldu. Bağlantı formuna yeni anahtarı girin ve kaydedin.
Kayıt bağlantısı açılmıyor Bağlantının süresi doldu. verimor_get_record_link() ile yeni bir tane isteyin veya kaydı Verimor panelinde açın.
Kayıt bağlantısı döndürülmüyor Dakikada beş istek limitine ulaşıldı veya aramanın kaydı yok. verimor_has_record kontrol edin.