Mavibot'ta TotalVoice telefonisini kullanmak için TotalVoice panelinden bir Erişim Anahtarı (Access Token) almanız ve entegrasyon ayarlarına girmeniz gerekir. TotalVoice, artık Zenvia grubunun bir parçası olan Brezilya merkezli bir telefon hizmetidir.

Bot, bir çalışanı müşteriyle bağlayabilir, aramaları aktarabilir ve sonlandırabilir, arama kayıtlarını alabilir ve arama olaylarını sohbete gönderebilir. TotalVoice ayrıca her aramanın maliyetini de sağlar.

Gerekli verilerin alınması

  1. Bir Zenvia Voice hesabı oluşturun ve bakiyenize para ekleyin.

  1. Panele giriş yapın. Ana ekranın sol alt köşesinde, Access Token yanında kopyalama simgesine tıklayın.

Access Token, ücretli aramalar dahil tüm hesabınıza erişim sağlayan tek anahtardır. Bunu yayınlamayın veya şirketiniz dışında paylaşmayın.

Bağlantı

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

  • Access Token — TotalVoice panelinden alınan anahtar.
  • Müşterinin göreceği numara — müşterinin göreceği numara, +551140028922 biçiminde. Bu alan isteğe bağlıdır. Boş bırakılırsa, TotalVoice hesabınızdaki varsayılan numara kullanılır.


Kaydettikten sonra, bağlantı sayfasında bir bildirim URL'si görünecektir. Bunu TotalVoice paneline eklemeniz gerekir — sonraki bölüme bakın.

Entegrasyon artık bağlı. Bağlantıyı kesmek için Access Token alanını temizleyin ve ayarları kaydedin.

Bildirim kurulumu

Diğer telefon entegrasyonlarından farklı olarak, bildirim URL'si manuel olarak yapılandırılmalıdır çünkü TotalVoice, Mavibot'un bunu otomatik yapması için bir yol sağlamaz.

  1. Bağlantı sayfasında gösterilen URL'yi kopyalayın.

  1. TotalVoice panelinde Desenvolvedores → Configurações da API bölümünü açın.
  2. Aynı URL'yi üç webhook alanına da yapıştırın:
    • Status Tempo Real — arama devam ederken arama durumu değişiklikleri;
    • Chamada - Fim — bir aramanın sonu;
    • DID - Fim de Chamada — numaranıza gelen bir aramanın sonu.

⏳ Ayarları kaydettikten sonra bildirimlerin gelmeye başlaması 20 dakikaya kadar sürebilir. Bu bir TotalVoice sınırlamasıdır. Kurulumdan hemen sonra sohbette hiçbir olay görünmezse, sadece bekleyin.

Erişim Anahtarınızı yeniden oluşturursanız, bildirim URL'si değişecektir. Yeni anahtarı Mavibot'a kaydedin ve TotalVoice panelindeki URL'yi güncelleyin, aksi takdirde arama olayları gelmeyi durdurur.

Çalışanlar

Çalışan ayarlarında, çalışanın TotalVoice numarasını girin.


Bir dahili hat (ramal, genellikle 3-4 haneli) veya +5511987654321 biçiminde normal bir cep telefonu numarası kullanabilirsiniz. Bu, biçimin esnek olduğu birkaç entegrasyondan biridir: çalışan dahili bir PBX hattı kullanmıyorsa, cep telefonu numarasını girin.

Müşteri kartından arama

Sohbet kartında müşterinin telefon numarasının yanında bir arama düğmesi görünecektir. TotalVoice önce çalışanı arar ve yalnızca çalışan cevapladıktan sonra müşteriyi arar.

Bu sıralama 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

totalvoice_employee_call(client_phone, employee_number, bina, gravar_audio)

Parametreler:

  • client_phone — müşterinin telefon numarası, +5511987654321 biçiminde. Zorunlu.
  • employee_number — çalışanın numarası: dahili hat veya cep telefonu numarası. Zorunlu.
  • bina — müşterinin göreceği numara. İsteğe bağlı. Belirtilmezse, bağlantı ayarlarındaki numara kullanılır.
  • gravar_audio — aramanın kaydedilip kaydedilmeyeceği. İsteğe bağlı. Kayıt varsayılan olarak etkindir.

Aramayı Aktarma

totalvoice_transfer_call(number, call_id, leg)

Parametreler:

  • number — aramanın aktarılacağı numara. Zorunlu.
  • call_id — arama tanımlayıcısı. İsteğe bağlı. Belirtilmezse, müşterinin en son araması kullanılır.
  • leg — aramanın hangi tarafının aktarılacağı: destino (müşteri, varsayılan değer) veya origem (çalışan).

Aramayı Sonlandırma

totalvoice_hangup_call(call_id)

Parametreler:

  • call_id — 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

totalvoice_get_record_link(call_id)

Normalde, kayıt bağlantısı arama sonu olayıyla otomatik olarak alınır. Bu fonksiyon, bildirim alınmadıysa veya daha eski bir aramanın kaydına ihtiyacınız varsa kullanışlıdır.

Parametreler:

  • call_id — 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, geri aramalar sohbete aşağıdaki biçimde gönderilir:

totalvoice_call_event atendida

Olası olaylar:

Olay Ne zaman tetiklenir
chamando Arama çalıyor
preparando Hat bağlantı için hazırlanıyor
atendida Arama cevaplandı
sem_resposta Cevap yok
ocupado Meşgul
cancelada Arama iptal edildi
congestionado Operatör ağı tıkanıklığı
falha Arama tamamlanamadı
nao_existe Numara mevcut değil

Durum adları Portekizce alınır çünkü bunlar TotalVoice tarafından kullanılan durum adlarıdır.

Tipik bir "cevap yok → mesajlaşma uygulamasında mesaj gönder" senaryosu, totalvoice_call_answered değişkeni kontrol edilerek oluşturulabilir.

Arama durumu bildirimleri, arama başına en fazla 2 saniyede bir gönderilir. Çok kısa aramalarda bazı ara durumlar zamanında gelmeyebilir. Arama sonu olayı her zaman gönderilir.

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

Değişken Değer
totalvoice_call_id Arama tanımlayıcısı
totalvoice_call_status TotalVoice tarafından tanımlanan arama durumu
totalvoice_call_answered 1 — arama cevaplandı, 0 — cevaplanmadı
totalvoice_call_duration Arama süresi (saniye)
totalvoice_call_price Arama maliyeti (Brezilya reali)
totalvoice_hangup_reason Aramanın bitme nedeni
totalvoice_record_link Arama kaydının bağlantısı

Süre, gerçek konuşma süresini ifade eder, aramanın cevaplanması için beklenen süre hariç. TotalVoice'in faturalamayı farklı hesapladığını unutmayın: faturalandırılabilir süre bir sonraki tam dakikaya yuvarlanır, bu nedenle 24 saniyelik bir arama bir dakika olarak faturalandırılır. Ücretleri doğrulamak için bu değişken yerine TotalVoice panelindeki faturalama raporunu kullanın.

Arama Kayıtları

Kayıt, her arama için ayrı ayrı yapılandırılır ve varsayılan olarak etkindir. Belirli bir arama için gravar_audio parametresini kullanarak devre dışı bırakabilirsiniz.

Arama bittiğinde, kayıt bağlantısı olayla birlikte alınır ve totalvoice_record_link değişkenine kaydedilir. Ayrıca talep etmenize gerek yoktur.

Arama kaydı yasalarla düzenlenir. Brezilya'da LGPD gereksinimlerine tabidir: müşteri, aramanın kaydedildiği konusunda bilgilendirilmelidir ve verilerin saklanması için yasal bir dayanak olmalıdır. Bu gereksinimlere uymak TotalVoice hesap sahibinin sorumluluğundadır.

Sorun Giderme

Hata Neden / Çözüm
Arama oluşturulmuyor ve hata mesajı Portekizce TotalVoice nedeni metin olarak döndürür. En yaygın nedenler yetersiz bakiye veya geçersiz telefon numarası biçimidir.
Aramalar çalışıyor, ancak sohbette geri aramalar görünmüyor Bildirim URL'si TotalVoice paneline eklenmemiş, üç webhook'a da eklenmemiş veya yapılandırmadan bu yana 20 dakika geçmemiş.
Her şey daha önce çalışıyordu, ancak olaylar aniden durdu Access Token yeniden oluşturuldu ve bu da bildirim URL'sini değiştirdi. Yeni anahtarı Mavibot'a kaydedin ve TotalVoice panelindeki URL'yi güncelleyin.
"TotalVoice numarası belirtilmemiş" Çalışanın ayarlarında TotalVoice numarası eksik.
nao_existe durumu Müşterinin numarası mevcut değil. Biçimi kontrol edin. Brezilya cep telefonu numaraları +55 + DDD + 9 hane kullanır.
congestionado durumu Operatörün ağında bir sorun var ve müşterinin numarasıyla ilgisi yok. Sorun devam ederse TotalVoice desteğine başvurun.
Kayıt bağlantısı yok Arama, kayıt devre dışı bırakılarak oluşturuldu veya arama cevaplanmadı.