Mavibot-те TotalVoice телефониясын пайдалану үшін TotalVoice басқару панелінен Access Token алып, оны интеграция параметрлеріне енгізу қажет. TotalVoice — бразилиялық телефон қызметі, қазір Zenvia тобының құрамына кіреді.

Бот қызметкерді клиентпен байланыстыра алады, қоңырауларды ауыстыра және аяқтай алады, қоңырау жазбаларын ала алады және қоңырау оқиғаларын сөйлесуге жібере алады. TotalVoice сонымен қатар әр қоңыраудың құнын ұсынады.

Қажетті деректерді алу

  1. Zenvia Voice тіркелгісін жасап, балансыңызға ақша қосыңыз.

  1. Басқару панеліне кіріңіз. Негізгі экранның төменгі сол жақ бұрышында, Access Token қасында, көшіру белгішесін басыңыз.

Access Token — бүкіл тіркелгіңізге, соның ішінде ақылы қоңыраулар жасауға қол жеткізуді қамтамасыз ететін жалғыз кілт. Оны жарияламаңыз немесе компанияңыздан тыс жерде бөліспеңіз.

Қосылу

Телефония параметрлерінде TotalVoice таңдап, келесіні енгізіңіз:

  • Access Token — TotalVoice басқару панеліндегі кілт.
  • Клиентке көрсетілетін нөмір — клиент көретін нөмір, +551140028922 форматында. Бұл өріс міндетті емес. Бос қалдырсаңыз, TotalVoice тіркелгіңіздегі әдепкі нөмір пайдаланылады.


Сақтағаннан кейін қосылу бетінде хабарландыру URL пайда болады. Оны TotalVoice басқару панеліне қосу қажет — келесі бөлімді қараңыз.

Интеграция енді қосылды. Оны ажырату үшін Access Token өрісін тазалап, параметрлерді сақтаңыз.

Хабарландыруды баптау

Басқа телефония интеграцияларынан айырмашылығы, хабарландыру URL мәнін қолмен конфигурациялау қажет, себебі TotalVoice Mavibot-қа мұны автоматты түрде жасауға мүмкіндік бермейді.

  1. Қосылу бетінде көрсетілген URL мекенжайын көшіріңіз.

  1. TotalVoice басқару панелінде Desenvolvedores → Configurações da API бөлімін ашыңыз.
  2. Дәл сол URL мекенжайын үш вебхук өрісіне де қойыңыз:
    • Status Tempo Real — қоңырау кезіндегі қоңырау күйінің өзгеруі;
    • Chamada - Fim — қоңыраудың аяқталуы;
    • DID - Fim de Chamada — нөміріңізге кіріс қоңыраудың аяқталуы.

⏳ Параметрлерді сақтағаннан кейін хабарландырулар келе бастауы 20 минутқа дейін созылуы мүмкін. Бұл TotalVoice шектеуі. Орнатудан кейін бірден сөйлесуде оқиғалар пайда болмаса, күте тұрыңыз.

Access Token қайта жасасаңыз, хабарландыру URL өзгереді. Жаңа токенді Mavibot-та сақтап, TotalVoice басқару панеліндегі URL мекенжайын жаңартыңыз, әйтпесе қоңырау оқиғалары келуін тоқтатады.

Қызметкерлер

Қызметкер параметрлерінде қызметкердің TotalVoice нөмірін енгізіңіз.


Ішкі қосымша нөмірді (ramal, әдетте 3–4 цифр) немесе +5511987654321 форматындағы қарапайым ұялы нөмірді пайдалануға болады. Бұл формат икемді болатын бірнеше интеграциялардың бірі: егер қызметкер ішкі PBX қосымша нөмірін пайдаланбаса, оның ұялы нөмірін енгізіңіз.

Клиент картасынан қоңырау шалу

Сөйлесу картасында клиенттің телефон нөмірінің жанында қоңырау түймесі пайда болады. TotalVoice алдымен қызметкерге қоңырау шалады, содан кейін ғана қызметкер жауап бергеннен кейін клиентке қоңырау шалады.

Бұл реттілік әдейі: клиент желіде үнсіздікті естімейді, себебі клиенттің телефоны шырылдай бастағанда қызметкер қазірдің өзінде қосылған.

Калькулятор функциялары

Қызметкерден клиентке қоңырау

totalvoice_employee_call(client_phone, employee_number, bina, gravar_audio)

Параметрлер:

  • client_phone — клиенттің телефон нөмірі +5511987654321 форматында. Міндетті.
  • employee_number — қызметкердің нөмірі: ішкі қосымша нөмір немесе ұялы нөмір. Міндетті.
  • bina — клиент көретін нөмір. Міндетті емес. Көрсетілмесе, қосылу параметрлеріндегі нөмір пайдаланылады.
  • gravar_audio — қоңырауды жазу керек пе. Міндетті емес. Жазу әдепкі бойынша қосылған.

Қоңырауды ауыстыру

totalvoice_transfer_call(number, call_id, leg)

Параметрлер:

  • number — қоңырау ауыстырылатын нөмір. Міндетті.
  • call_id — қоңырау идентификаторы. Міндетті емес. Көрсетілмесе, клиенттің соңғы қоңырауы пайдаланылады.
  • leg — қоңыраудың қай жағын ауыстыру керек: destino (клиент, әдепкі мән) немесе origem (қызметкер).

Қоңырауды аяқтау

totalvoice_hangup_call(call_id)

Параметрлер:

  • call_id — қоңырау идентификаторы. Міндетті емес. Көрсетілмесе, клиенттің соңғы қоңырауы пайдаланылады.

Қоңырау жазбасының сілтемесін алу

totalvoice_get_record_link(call_id)

Әдетте, жазба сілтемесі қоңырау аяқталу оқиғасымен автоматты түрде алынады. Бұл функция хабарландыру алынбаған немесе ескі қоңыраудан жазба қажет болған жағдайда пайдалы.

Параметрлер:

  • call_id — қоңырау идентификаторы. Міндетті емес. Көрсетілмесе, клиенттің соңғы қоңырауы пайдаланылады.

Қоңырау кезіндегі кері шақырулар

Қоңырау барысында сөйлесуге кері шақырулар келесі форматта жіберіледі:

totalvoice_call_event atendida

Мүмкін оқиғалар:

Оқиға Қашан іске қосылады
chamando Қоңырау шырылдап тұр
preparando Байланысқа дайындық жүріп жатыр
atendida Қоңырауға жауап берілді
sem_resposta Жауап жоқ
ocupado Бос емес
cancelada Қоңырау болдырмалды
congestionado Оператор желісіндегі кептеліс
falha Қоңырау аяқталмады
nao_existe Нөмір жоқ

Күй атаулары португал тілінде алынады, себебі бұл TotalVoice қолданатын күй атаулары.

Типтік «жауап жоқ → мессенджерде хабарлама жіберу» сценарийін totalvoice_call_answered айнымалысын тексеру арқылы құруға болады.

Қоңырау күйі туралы хабарландырулар әр қоңырау үшін 2 секунд сайын бір реттен жиі жіберілмейді. Өте қысқа қоңыраулар үшін кейбір аралық күйлер уақытында келмеуі мүмкін. Қоңырау аяқталу оқиғасы әрқашан жіберіледі.

Қоңыраудан кейінгі клиент айнымалылары

Айнымалы Мәні
totalvoice_call_id Қоңырау идентификаторы
totalvoice_call_status TotalVoice анықтаған қоңырау күйі
totalvoice_call_answered 1 — қоңырауға жауап берілді, 0 — жауап берілмеді
totalvoice_call_duration Қоңырау ұзақтығы секундпен
totalvoice_call_price Қоңырау құны бразилиялық реалмен
totalvoice_hangup_reason Қоңыраудың аяқталу себебі
totalvoice_record_link Қоңырау жазбасына сілтеме

Ұзақтық нақты сөйлесу уақытын білдіреді, қоңырауға жауап күту уақытын қоспағанда. Ескеріңіз: TotalVoice төлемді басқаша есептейді: төленетін уақыт келесі толық минутқа дейін дөңгелектенеді, сондықтан 24 секундтық қоңырау бір минут ретінде есептеледі. Төлемдерді тексеру үшін осы айнымалыны емес, TotalVoice басқару панеліндегі есептеу есебін пайдаланыңыз.

Қоңырау жазбалары

Жазу әр қоңырау үшін бөлек конфигурацияланады және әдепкі бойынша қосылған. Оны нақты қоңырау үшін қоңырау функциясындағы gravar_audio параметрі арқылы өшіруге болады.

Қоңырау аяқталғанда, жазба сілтемесі оқиғамен бірге алынып, totalvoice_record_link айнымалысында сақталады. Оны бөлек сұраудың қажеті жоқ.

Қоңырау жазбасы заңмен реттеледі. Бразилияда ол LGPD талаптарына бағынады: клиент қоңыраудың жазылып жатқаны туралы хабардар болуы керек, ал деректерді сақтау үшін заңды негіз болуы қажет. Осы талаптардың орындалуына TotalVoice тіркелгісінің иесі жауапты.

Ақаулықтарды жою

Қате Себеп / Шешім
Қоңырау жасалмайды және қате хабарламасы португал тілінде TotalVoice себепті мәтін ретінде қайтарады. Ең жиі кездесетін себептер — баланстың жеткіліксіздігі немесе телефон нөмірінің жарамсыз форматы.
Қоңыраулар жұмыс істейді, бірақ сөйлесуде кері шақырулар пайда болмайды Хабарландыру URL TotalVoice басқару панеліне қосылмаған, үш вебхукке де қосылмаған немесе конфигурациядан бері 20 минут өтпеген.
Бәрі бұрын жұмыс істеді, бірақ оқиғалар кенеттен тоқтады Access Token қайта жасалды, бұл хабарландыру URL өзгеруіне әкелді. Жаңа токенді Mavibot-та сақтап, TotalVoice басқару панеліндегі URL мекенжайын жаңартыңыз.
"TotalVoice нөмірі көрсетілмеген" Қызметкердің параметрлерінде оның TotalVoice нөмірі жоқ.
nao_existe күйі Клиенттің нөмірі жоқ. Форматты тексеріңіз. Бразилиялық ұялы нөмірлер +55 + DDD + 9 цифрды пайдаланады.
congestionado күйі Оператордың желісінде ақау бар және бұл клиенттің нөміріне қатысты емес. Мәселе жалғасса, TotalVoice қолдау қызметіне хабарласыңыз.
Жазба сілтемесі жоқ Қоңырау жазба өшірілген күйде жасалған немесе қоңырауға жауап берілмеген.