Untuk menggunakan telepon TotalVoice dalam Mavibot, anda perlu mendapatkan Access Token dari papan pemuka TotalVoice dan memasukkannya dalam tetapan integrasi. TotalVoice ialah perkhidmatan telepon Brazil yang kini sebahagian daripada kumpulan Zenvia.

Bot boleh menghubungkan pekerja dengan pelanggan, memindahkan dan menamatkan panggilan, mendapatkan rakaman panggilan, dan menghantar peristiwa panggilan ke perbualan. TotalVoice juga menyediakan kos setiap panggilan.

Mendapatkan data yang diperlukan

  1. Buat akaun Zenvia Voice dan tambah dana ke baki anda.

  1. Log masuk ke papan pemuka. Di sudut kiri bawah skrin utama, di sebelah Access Token, klik ikon salin.

Access Token ialah satu-satunya kunci yang memberikan akses ke seluruh akaun anda, termasuk membuat panggilan berbayar. Jangan siarkan atau kongsi di luar syarikat anda.

Sambungan

Dalam tetapan telepon, pilih TotalVoice dan masukkan:

  • Access Token — kunci dari papan pemuka TotalVoice.
  • Nombor yang dipaparkan kepada pelanggan — nombor yang akan dilihat oleh pelanggan, dalam format +551140028922. Medan ini adalah pilihan. Jika dibiarkan kosong, nombor lalai dari akaun TotalVoice anda akan digunakan.


Selepas menyimpan, URL pemberitahuan akan muncul di halaman sambungan. Anda perlu menambahkannya ke papan pemuka TotalVoice — lihat bahagian seterusnya.

Integrasi kini disambungkan. Untuk memutuskan sambungan, kosongkan medan Access Token dan simpan tetapan.

Persediaan pemberitahuan

Tidak seperti integrasi telepon lain, URL pemberitahuan mesti dikonfigurasikan secara manual kerana TotalVoice tidak menyediakan cara untuk Mavibot melakukannya secara automatik.

  1. Salin URL yang dipaparkan di halaman sambungan.

  1. Dalam papan pemuka TotalVoice, buka Desenvolvedores → Configurações da API.
  2. Tampal URL yang sama ke dalam ketiga-tiga medan webhook:
    • Status Tempo Real — perubahan status panggilan semasa panggilan sedang berlangsung;
    • Chamada - Fim — tamat panggilan;
    • DID - Fim de Chamada — tamat panggilan masuk ke nombor anda.

⏳ Pemberitahuan mungkin mengambil masa sehingga 20 minit untuk mula tiba selepas anda menyimpan tetapan. Ini adalah had TotalVoice. Jika tiada peristiwa muncul dalam perbualan sejurus selepas persediaan, tunggu sahaja.

Jika anda menjana semula Access Token anda, URL pemberitahuan akan berubah. Simpan token baharu dalam Mavibot dan kemas kini URL dalam papan pemuka TotalVoice, jika tidak, peristiwa panggilan akan berhenti tiba.

Pekerja

Dalam tetapan pekerja, masukkan nombor TotalVoice pekerja.


Anda boleh menggunakan sama ada sambungan dalaman (ramal, biasanya 3–4 digit) atau nombor mudah alih biasa dalam format +5511987654321. Ini adalah salah satu daripada beberapa integrasi di mana formatnya fleksibel: jika pekerja tidak menggunakan sambungan PBX dalaman, masukkan nombor mudah alih mereka.

Menelefon dari kad pelanggan

Butang panggilan akan muncul di sebelah nombor telefon pelanggan dalam kad perbualan. TotalVoice mula-mula memanggil pekerja, dan 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

totalvoice_employee_call(client_phone, employee_number, bina, gravar_audio)

Parameter:

  • client_phone — nombor telefon pelanggan dalam format +5511987654321. Wajib.
  • employee_number — nombor pekerja: sama ada sambungan dalaman atau nombor mudah alih. Wajib.
  • bina — nombor yang akan dilihat oleh pelanggan. Pilihan. Jika diabaikan, nombor dari tetapan sambungan digunakan.
  • gravar_audio — sama ada untuk merakam panggilan. Pilihan. Rakaman diaktifkan secara lalai.

Pindah Panggilan

totalvoice_transfer_call(number, call_id, leg)

Parameter:

  • number — nombor ke mana panggilan harus dipindahkan. Wajib.
  • call_id — pengecam panggilan. Pilihan. Jika diabaikan, panggilan terbaru pelanggan digunakan.
  • leg — bahagian panggilan mana yang akan dipindahkan: destino (pelanggan, nilai lalai) atau origem (pekerja).

Tamat Panggilan

totalvoice_hangup_call(call_id)

Parameter:

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

Dapatkan Pautan Rakaman Panggilan

totalvoice_get_record_link(call_id)

Biasanya, pautan rakaman diterima secara automatik dengan peristiwa tamat panggilan. Fungsi ini berguna jika pemberitahuan tidak diterima atau jika anda memerlukan rakaman dari panggilan yang lebih lama.

Parameter:

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

Panggilan Balik Semasa Panggilan

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

totalvoice_call_event atendida

Peristiwa yang mungkin:

Peristiwa Bila ia dicetuskan
chamando Panggilan sedang berdering
preparando Talian sedang disediakan untuk sambungan
atendida Panggilan telah dijawab
sem_resposta Tiada jawapan
ocupado Sibuk
cancelada Panggilan telah dibatalkan
congestionado Kesesakan rangkaian pembawa
falha Panggilan tidak dapat diselesaikan
nao_existe Nombor tidak wujud

Nama status diterima dalam bahasa Portugis kerana ini adalah nama status yang digunakan oleh TotalVoice.

Senario biasa "tiada jawapan → hantar mesej dalam messenger" boleh dibina dengan menyemak pemboleh ubah totalvoice_call_answered.

Pemberitahuan status panggilan dihantar tidak lebih daripada sekali setiap 2 saat setiap panggilan. Untuk panggilan yang sangat pendek, beberapa status perantaraan mungkin tidak tiba tepat pada masanya. Peristiwa tamat panggilan sentiasa dihantar.

Pemboleh Ubah Pelanggan Selepas Panggilan

Pemboleh Ubah Nilai
totalvoice_call_id Pengecam panggilan
totalvoice_call_status Status panggilan seperti yang ditakrifkan oleh TotalVoice
totalvoice_call_answered 1 — panggilan dijawab, 0 — tidak
totalvoice_call_duration Tempoh panggilan dalam saat
totalvoice_call_price Kos panggilan dalam real Brazil
totalvoice_hangup_reason Sebab panggilan ditamatkan
totalvoice_record_link Pautan ke rakaman panggilan

Tempoh bermaksud masa bercakap sebenar, tidak termasuk masa menunggu panggilan dijawab. Perlu diingat bahawa TotalVoice mengira pengebilan secara berbeza: masa boleh bil dibundarkan ke atas ke minit penuh seterusnya, jadi panggilan 24 saat akan dikenakan bayaran sebagai satu minit. Untuk mengesahkan caj, gunakan laporan pengebilan dalam papan pemuka TotalVoice daripada pemboleh ubah ini.

Rakaman Panggilan

Rakaman dikonfigurasikan secara berasingan untuk setiap panggilan dan diaktifkan secara lalai. Anda boleh melumpuhkannya untuk panggilan tertentu menggunakan parameter gravar_audio dalam fungsi panggilan.

Apabila panggilan tamat, pautan rakaman diterima dengan peristiwa dan disimpan ke pemboleh ubah totalvoice_record_link. Anda tidak perlu memintanya secara berasingan.

Rakaman panggilan dikawal oleh undang-undang. Di Brazil, ia tertakluk kepada keperluan LGPD: pelanggan mesti dimaklumkan bahawa panggilan sedang dirakam, dan mesti ada asas undang-undang untuk menyimpan data. Pemilik akaun TotalVoice bertanggungjawab untuk mematuhi keperluan ini.

Penyelesaian Masalah

Ralat Punca / Penyelesaian
Panggilan tidak dibuat dan mesej ralat dalam bahasa Portugis TotalVoice mengembalikan sebab sebagai teks. Punca paling biasa ialah baki tidak mencukupi atau format nombor telefon tidak sah.
Panggilan berfungsi, tetapi tiada panggilan balik muncul dalam perbualan URL pemberitahuan belum ditambah ke papan pemuka TotalVoice, belum ditambah ke ketiga-tiga webhook, atau 20 minit belum berlalu sejak konfigurasi.
Semuanya berfungsi sebelum ini, tetapi peristiwa tiba-tiba berhenti Access Token telah dijana semula, yang mengubah URL pemberitahuan. Simpan token baharu dalam Mavibot dan kemas kini URL dalam papan pemuka TotalVoice.
"Nombor TotalVoice tidak ditentukan" Nombor TotalVoice pekerja tiada dalam tetapan mereka.
Status nao_existe Nombor pelanggan tidak wujud. Semak format. Nombor mudah alih Brazil menggunakan +55 + DDD + 9 digit.
Status congestionado Terdapat masalah dengan rangkaian pembawa dan ia tidak berkaitan dengan nombor pelanggan. Jika masalah berterusan, hubungi sokongan TotalVoice.
Tiada pautan rakaman Panggilan dibuat dengan rakaman dilumpuhkan, atau panggilan tidak dijawab.