Lai Mavibot izmantotu TotalVoice telefoniju, jums no TotalVoice informācijas paneļa jāiegūst piekļuves pilnvara (Access Token) un jāievada tā integrācijas iestatījumos. TotalVoice ir Brazīlijas telefonijas pakalpojums, kas tagad ir daļa no Zenvia grupas.

Bots var savienot darbinieku ar klientu, pārsūtīt un pabeigt zvanus, iegūt zvanu ierakstus un nosūtīt zvanu notikumus sarunā. TotalVoice nodrošina arī katra zvana izmaksas.

Nepieciešamo datu iegūšana

  1. Izveidojiet Zenvia Voice kontu un papildiniet savu bilanci.

  1. Piesakieties informācijas panelī. Galvenā ekrāna apakšējā kreisajā stūrī blakus Access Token noklikšķiniet uz kopēšanas ikonas.

Access Token ir vienīgā atslēga, kas nodrošina piekļuvi visam jūsu kontam, tostarp maksas zvanu veikšanai. Nepublicējiet to un neizpaudiet ārpus sava uzņēmuma.

Savienojums

Telefonijas iestatījumos atlasiet TotalVoice un ievadiet:

  • Access Token — atslēga no TotalVoice informācijas paneļa.
  • Client-facing number — numurs, ko redzēs klients, formātā +551140028922. Šis lauks nav obligāts. Ja atstāts tukšs, tiks izmantots noklusējuma numurs no jūsu TotalVoice konta.


Pēc saglabāšanas savienojuma lapā parādīsies notification URL. Jums tas jāpievieno TotalVoice informācijas panelī — skatiet nākamo sadaļu.

Integrācija tagad ir savienota. Lai to atvienotu, notīriet lauku Access Token un saglabājiet iestatījumus.

Paziņojumu iestatīšana

Atšķirībā no citām telefonijas integrācijām, paziņojumu URL ir jākonfigurē manuāli, jo TotalVoice nepiedāvā iespēju Mavibot to izdarīt automātiski.

  1. Kopējiet URL, kas redzams savienojuma lapā.

  1. TotalVoice informācijas panelī atveriet Desenvolvedores → Configurações da API.
  2. Ielīmējiet to pašu URL visos trīs webhook laukos:
    • Status Tempo Real — zvana statusa izmaiņas zvana laikā;
    • Chamada - Fim — zvana beigas;
    • DID - Fim de Chamada — ienākošā zvana beigas uz jūsu numuru.

⏳ Paziņojumi var sākt pienākt līdz 20 minūtēm pēc iestatījumu saglabāšanas. Tas ir TotalVoice ierobežojums. Ja sarunā uzreiz pēc iestatīšanas neparādās notikumi, vienkārši pagaidiet.

Ja atkārtoti ģenerējat savu Access Token, paziņojumu URL mainīsies. Saglabājiet jauno pilnvaru Mavibot un atjauniniet URL TotalVoice informācijas panelī, pretējā gadījumā zvanu notikumi pārtrauks pienākt.

Darbinieki

Darbinieka iestatījumos ievadiet darbinieka TotalVoice numuru.


Varat izmantot vai nu iekšējo numuru (ramal, parasti 3–4 cipari), vai parasto mobilo numuru formātā +5511987654321. Šī ir viena no retajām integrācijām, kur formāts ir elastīgs: ja darbinieks neizmanto iekšējo PBX numuru, ievadiet viņa mobilo numuru.

Zvanīšana no klienta kartes

Sarunas kartē blakus klienta tālruņa numuram parādīsies zvana poga. TotalVoice vispirms zvana darbiniekam, un tikai pēc tam, kad darbinieks atbild, zvana klientam.

Šī secība ir apzināta: klients nedzirdēs klusumu līnijā, jo darbinieks jau ir savienots, kad klienta tālrunis sāk zvanīt.

Kalkulatora funkcijas

Zvans no darbinieka klientam

totalvoice_employee_call(client_phone, employee_number, bina, gravar_audio)

Parametri:

  • client_phone — klienta tālruņa numurs formātā +5511987654321. Obligāts.
  • employee_number — darbinieka numurs: vai nu iekšējais numurs, vai mobilais numurs. Obligāts.
  • bina — numurs, ko redzēs klients. Nav obligāts. Ja izlaists, tiek izmantots numurs no savienojuma iestatījumiem.
  • gravar_audio — vai ierakstīt zvanu. Nav obligāts. Ierakstīšana ir iespējota pēc noklusējuma.

Zvana pārsūtīšana

totalvoice_transfer_call(number, call_id, leg)

Parametri:

  • number — numurs, uz kuru jāpārsūta zvans. Obligāts.
  • call_id — zvana identifikators. Nav obligāts. Ja izlaists, tiek izmantots klienta pēdējais zvans.
  • leg — kura zvana puse jāpārsūta: destino (klients, noklusējuma vērtība) vai origem (darbinieks).

Zvana pabeigšana

totalvoice_hangup_call(call_id)

Parametri:

  • call_id — zvana identifikators. Nav obligāts. Ja izlaists, tiek izmantots klienta pēdējais zvans.

Zvana ieraksta saites iegūšana

totalvoice_get_record_link(call_id)

Parasti ieraksta saite tiek saņemta automātiski ar zvana beigu notikumu. Šī funkcija ir noderīga, ja paziņojums netika saņemts vai ja nepieciešams ieraksts no vecāka zvana.

Parametri:

  • call_id — zvana identifikators. Nav obligāts. Ja izlaists, tiek izmantots klienta pēdējais zvans.

Atgriezeniskie signāli zvana laikā

Zvanam noritot, sarunā tiek nosūtīti atgriezeniskie signāli šādā formātā:

totalvoice_call_event atendida

Iespējamie notikumi:

Notikums Kad tas tiek aktivizēts
chamando Zvans zvana
preparando Līnija tiek sagatavota savienojumam
atendida Zvans ir atbildēts
sem_resposta Nav atbildes
ocupado Aizņemts
cancelada Zvans tika atcelts
congestionado Operatora tīkla pārslodze
falha Zvanu nevarēja pabeigt
nao_existe Numurs neeksistē

Statusa nosaukumi tiek saņemti portugāļu valodā, jo tie ir TotalVoice izmantotie statusa nosaukumi.

Tipisku scenāriju "nav atbildes → nosūtīt ziņojumu kurjerā" var izveidot, pārbaudot mainīgo totalvoice_call_answered.

Zvana statusa paziņojumi tiek nosūtīti ne biežāk kā reizi 2 sekundēs par vienu zvanu. Ļoti īsiem zvaniem daži starpposma statusi var nepaspēt pienākt. Zvana beigu notikums vienmēr tiek nosūtīts.

Klienta mainīgie pēc zvana

Mainīgais Vērtība
totalvoice_call_id Zvana identifikators
totalvoice_call_status Zvana statuss saskaņā ar TotalVoice definīciju
totalvoice_call_answered 1 — zvans tika atbildēts, 0 — netika
totalvoice_call_duration Zvana ilgums sekundēs
totalvoice_call_price Zvana izmaksas Brazīlijas reālos
totalvoice_hangup_reason Iemesls, kāpēc zvans beidzās
totalvoice_record_link Saite uz zvana ierakstu

Ilgums nozīmē faktisko sarunas laiku, izņemot laiku, kas pavadīts, gaidot zvana atbildi. Ņemiet vērā, ka TotalVoice aprēķina norēķinus citādi: norēķinu laiks tiek noapaļots uz augšu līdz nākamajai pilnajai minūtei, tāpēc 24 sekunžu zvans tiks iekasēts kā viena minūte. Lai pārbaudītu maksas, izmantojiet norēķinu pārskatu TotalVoice informācijas panelī, nevis šo mainīgo.

Zvana ieraksti

Ierakstīšana tiek konfigurēta atsevišķi katram zvanam un pēc noklusējuma ir iespējota. Varat to atspējot konkrētam zvanam, izmantojot parametru gravar_audio zvana funkcijā.

Kad zvans beidzas, ieraksta saite tiek saņemta ar notikumu un saglabāta mainīgajā totalvoice_record_link. Jums tā nav jāpieprasa atsevišķi.

Zvana ierakstīšanu regulē likums. Brazīlijā uz to attiecas LGPD prasības: klientam jābūt informētam, ka zvans tiek ierakstīts, un datu glabāšanai jābūt tiesiskam pamatam. TotalVoice konta īpašnieks ir atbildīgs par šo prasību ievērošanu.

Problēmu novēršana

Kļūda Cēlonis / Risinājums
Zvans netiek izveidots un kļūdas ziņojums ir portugāļu valodā TotalVoice atgriež iemeslu kā tekstu. Visbiežākie cēloņi ir nepietiekama bilance vai nederīgs tālruņa numura formāts.
Zvani darbojas, bet sarunā neparādās atgriezeniskie signāli Paziņojumu URL nav pievienots TotalVoice informācijas panelī, nav pievienots visiem trim webhook laukiem vai kopš konfigurācijas nav pagājušas 20 minūtes.
Iepriekš viss darbojās, bet notikumi pēkšņi apstājās Access Token tika atkārtoti ģenerēts, kas mainīja paziņojumu URL. Saglabājiet jauno pilnvaru Mavibot un atjauniniet URL TotalVoice informācijas panelī.
"TotalVoice numurs nav norādīts" Darbinieka TotalVoice numurs trūkst viņa iestatījumos.
Statuss nao_existe Klienta numurs neeksistē. Pārbaudiet formātu. Brazīlijas mobilie numuri izmanto +55 + DDD + 9 cipari.
Statuss congestionado Ir problēma ar operatora tīklu, un tā nav saistīta ar klienta numuru. Ja problēma turpinās, sazinieties ar TotalVoice atbalstu.
Nav ieraksta saites Zvans tika izveidots ar atspējotu ierakstīšanu vai zvans netika atbildēts.