Mavibot'ta VoIPstudio telefonisini kullanmak için VoIPstudio hesabınızda bir API anahtarı oluşturmanız, bunu entegrasyon ayarlarına girmeniz ve olay teslimatını entegrasyon bağlandıktan sonra Mavibot'un gösterdiği URL'ye yapılandırmanız gerekir.

VoIPstudio, 70'ten fazla ülkede telefon numaraları sunan bulut tabanlı bir PBX'tir. Geleneksel bir telekom operatöründen farklı olarak dahili kullanıcıları, arama gruplarını, kuyrukları ve IVR menülerini desteklerken, bot bu PBX'in üzerinde çalışır.

Bot, çalışanlar adına müşterilere arama başlatabilir, aramaları aktarabilir ve sonlandırabilir, kayıtları kaydedebilir ve arama olaylarını sohbete gönderebilir.

Gerekli Bilgilerin Alınması

  1. voipstudio.com adresine kaydolun ve gerekli ülkede bir telefon numarası satın alın.
  2. PBX'te kullanıcılar oluşturun — arama alacak her çalışan için bir tane. Aramalar, bir kullanıcıya kayıtlı tüm cihazlara iletilir, bu nedenle her çalışan için ayrı bir telefon numarası belirtmeniz gerekmez.
  3. Ayarlar → API bölümüne gidin, bir API Anahtarı oluşturun ve kopyalayın.

Entegrasyonun Bağlanması

Telefon ayarlarında VoIPstudio seçeneğini seçin ve şunları girin:

  • API Anahtarı — VoIPstudio hesabınızdaki anahtar.

Entegrasyon artık bağlandı. Bağlantıyı kesmek için API Anahtarı alanını temizleyin ve ayarları kaydedin.

Kaydettikten sonra sayfada bir bildirim URL'si görünecektir. Kopyalayın:

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

Bu URL'yi yayınlamayın veya kimseyle paylaşmayın. Entegrasyonu kesip yeniden bağlarsanız anahtar aynı kalır, bu nedenle bildirimleri yeniden yapılandırmanız gerekmez.

Ardından VoIPstudio hesabınızda Entegrasyonlar → Webhook'lar → Etkinleştir → Webhook Ekle bölümüne gidin, kopyaladığınız URL'yi yapıştırın ve aşağıdaki olayları seçin:

  • Arama Durumu Değişikliği — veya Arama Çalıyor, Arama Bağlandı, Arama Sonlandı ve Arama Cevaplanmadı olaylarını ayrı ayrı seçin;
  • Arama Kaydı Hazır — arama kayıtlarına ihtiyacınız varsa.

Bu yapılandırma olmadan giden aramalar yine de çalışır, ancak arama olayları sohbette görünmez.

Çalışanlar

Çalışan ayarlarında VoIPstudio Kullanıcı Kimliği alanını doldurun — PBX'inizdeki kullanıcının sayısal tanımlayıcısı, örneğin 10002.

PBX kullanıcı kimliğini girin, telefon numarasını değil. Kimliği VoIPstudio hesabınızdaki kullanıcı listesinde bulabilirsiniz. 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.

VoIPstudio önce çalışanı kayıtlı tüm cihazlarında aynı anda arar. Çalışan cevap verdiğinde, VoIPstudio müşteriyi arar ve iki tarafı birbirine bağlar.

Çalışan cevap vermezse, müşteri aranmaz.

Hesap Makinesi Fonksiyonları

Çalışandan Müşteriye Arama

voipstudio_employee_call(client_phone, employee_user_id, caller_id)

Parametreler:

  • client_phone — müşterinin telefon numarası. Zorunlu.
  • employee_user_id — ilk aramayı alması gereken çalışanın VoIPstudio kullanıcı kimliği. Zorunlu.
  • caller_id — müşteriye görüntülenen telefon numarası. İsteğe bağlı. Arayan kimliğini gizlemek için anonymous iletebilirsiniz.

Aramayı Aktarma

voipstudio_transfer_call(phone, call_id)

Aktif bir aramayı başka bir telefon numarasına aktarır.

Parametreler:

  • phone — aramanın aktarılacağı telefon numarası. Zorunlu ve ilk parametre olmalıdır.
  • call_id — arama tanımlayıcısı. İsteğe bağlı. Atlanırsa, müşterinin mevcut araması voipstudio_call_id değişkeninden alınır.

Aramayı Sonlandırma

voipstudio_hangup_call(call_id)

Aktif bir aramayı sonlandırır.

Parametreler:

  • call_id — arama tanımlayıcısı. İsteğe bağlı. Atlanırsa, müşterinin mevcut araması kullanılır.

Arama Kaydı Bağlantısı Alma

voipstudio_get_record_link(call_id)

Arama kaydına bir bağlantı döndürür. Bağlantı normalde kayıt hazır olayı alındığında otomatik olarak kaydedilir. Bu fonksiyon, bu olayın alınmaması durumunda kullanışlıdır.

Parametreler:

  • call_id — arama tanımlayıcısı. İsteğe bağlı. Atlanırsa, müşterinin mevcut araması kullanılır.

Fonksiyon, hesaptaki en son 100 kaydı arar. Yüksek hacimli bir PBX'te daha eski bir arama için kaydı bulamayabilir. Bu durumda, kaydı doğrudan VoIPstudio hesabınızdan alın.

Arama Sırasında Geri Aramalar

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

voipstudio_call_event call.hangup

Olay adı, VoIPstudio'dan alındığı gibi iletilir, örneğin call.ringing, call.connected, call.hangup ve diğerleri. Kullanılabilir olaylar, bildirimleri yapılandırırken seçtiğiniz olaylara bağlıdır.

Olay adı sağlanmazsa, arama durumu kullanılır:

INITIAL, RINGING, CONNECTED, ON_HOLD, HANGUP.

Kayıt hazır olduğunda ayrı bir geri arama gönderilir:

voipstudio_call_event recording

Kayıt bağlantısını kullanmadan önce recording geri aramasını bekleyin. Kayıt, arama sona erdikten sonra işlenir, bu nedenle call.hangup alındığında voipstudio_record_link değişkeni hâlâ boştur.

Kendi PBX'inizdeki iki çalışan birbiriyle konuşuyorsa, sohbete geri arama gönderilmez ve müşteri kartı oluşturulmaz.

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

Değişken Değer
voipstudio_call_id VoIPstudio'da Arama Kimliği
voipstudio_call_state Arama durumu: INITIAL, RINGING, CONNECTED, ON_HOLD, HANGUP
voipstudio_call_duration Saniye cinsinden arama süresi
voipstudio_call_cause Aramanın sona erme nedeni
voipstudio_terminated_by Aramayı kim sonlandırdı: caller veya callee
voipstudio_record_link Arama kaydına bağlantı
voipstudio_record_id VoIPstudio'da Kayıt Kimliği

Arama Kayıtları

Arama kaydı VoIPstudio ayarlarında etkinleştirilir ve PBX'in kendisi tarafından yönetilir. Kayıtlara ihtiyacınız varsa, VoIPstudio hesabınızda arama kaydını etkinleştirin ve bildirimleri yapılandırırken Arama Kaydı Hazır olayını seçin.

voipstudio_record_link URL'si bir erişim anahtarıyla korunur. Doğrudan bir tarayıcıda açılamaz veya bir müşteriyle paylaşılamaz. Kaydı, arama geçmişi bölümünden VoIPstudio hesabınızdan indirebilirsiniz.

Arama kaydı geçerli yasalara tabidir. Almanya, Fransa, İspanya ve çoğu ABD eyaletinde her iki tarafın da onayı gerekebilir ve bazı yargı bölgelerinde aramanın başında sözlü bir bildirim de gerekli olabilir. VoIPstudio hesap sahibi bu gereksinimlere uymaktan sorumludur.

Sorun Giderme

Hata Neden
Arama oluşturulurken yetkilendirme hatası API Anahtarı yanlış veya süresi dolmuş. Anahtarın bir login isteğiyle değil, Ayarlar → API altında oluşturulduğundan emin olun.
Aramalar çalışıyor, ancak sohbette geri arama görünmüyor VoIPstudio'da webhook oluşturulmamış, Etkinleştir anahtarı kapalı veya yanlış URL girilmiş. Entegrasyon sayfasındaki URL'nin tamamını, sonundaki anahtar dahil kopyalayın.
Arama oluşturulamıyor veya çalışanın cihazları çalmıyor VoIPstudio Kullanıcı Kimliği yerine bir telefon numarası girilmiş veya kullanıcının kayıtlı cihazı yok.
recording geri araması alınmıyor VoIPstudio'da arama kaydı etkinleştirilmemiş veya Arama Kaydı Hazır olayı seçilmemiş.

VoIPstudio doğrudan VoIPstudio tarafından faturalandırılır: her PBX kullanıcısı için abonelik ücreti ve arama ücretleri vardır. Bu, yinelenen abonelik olmadan dakika başına ücret alan operatörlerden farklıdır. Maliyetleri tahmin ederken yalnızca arama hacmini değil, yapılandırılmış kullanıcı sayısını da dikkate alın.