Lai Mavibot izmantotu Verimor telefoniju, jums ir jāiegūst API atslēga no sava Verimor konta un jāievada tā integrācijas iestatījumos.

Verimor ir Turcijas telekomunikāciju pakalpojumu sniedzējs. Tā produkts Bulut Santralim ir mākoņa PBX: darbinieki strādā ar iekšējiem numuriem, un zvani tiek maršrutēti caur šiem numuriem.

Bots var savienot darbinieku ar klientu, pārsūtīt un pabeigt zvanus, iegūt ierakstus un nosūtīt zvanu notikumus sarunā.

Nepieciešamo datu iegūšana

  1. Aktivizējiet Bulut Santralim pakalpojumu ar Verimor un izveidojiet iekšējos numurus saviem darbiniekiem.
  2. Atveriet Online İşlem Merkezi → Bulut Santralim → Santral Ayarlarım un nokopējiet API atslēgu. Tā izskatās šādi:
K12345678-1234-5678-4321-123456789012
  1. Pierakstiet darbinieku iekšējos numurus. Jums tie būs jānorāda piekļuves iestatījumos.

API atslēga ir kopīga visai PBX sistēmai, un to izmanto gan zvaniem, gan notikumu saņemšanai. Ja atkārtoti ģenerējat to Verimor panelī, noteikti saglabājiet savienojuma formu vēlreiz. Pretējā gadījumā gan zvani, gan sarunu notikumi pārtrauks darboties.

Savienojums

Telefonijas cilnē atlasiet Verimor un ievadiet:

  • API atslēga — atslēga no Santral Ayarlarım sadaļas.
  • Izejošais numurs — ārējais numurs, ko redzēs klients, formātā 908505320000. Šis lauks nav obligāts. Ja atstāts tukšs, tiks izmantots numurs, kas piešķirts darbinieka iekšējam numuram.


Integrācija tagad ir savienota.

Lai atvienotu integrāciju, notīriet API atslēgas lauku un saglabājiet iestatījumus.

Jums nav manuāli jākonfigurē paziņojumu URL. Mavibot to iestata automātiski jūsu PBX sistēmā, kad tiek saglabāta API atslēga.

Darbinieki

Darbinieka iestatījumos aizpildiet darbinieka iekšējo numuru (dahili) — parasti 3–4 cipari, piemēram, 1001.

Ievadiet PBX iekšējo numuru, nevis darbinieka mobilā tālruņa numuru. Bez tā zvanīšanas poga klienta kartē šim darbiniekam nedarbosies.

Zvanīšana no klienta kartes

Blakus klienta tālruņa numuram sarunas kartē parādīsies zvanīšanas poga.

PBX vispirms zvana uz darbinieka iekšējo numuru. Tikai pēc tam, kad darbinieks atbild, tā 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

verimor_employee_call(client_phone, employee_extension, caller_id)

Parametri:

  • client_phone — klienta tālruņa numurs. Obligāts. Izmantojiet Turcijas formātu 908505320000 vai 00493027590915 starptautiskiem zvaniem.
  • employee_extension — darbinieka iekšējais numurs, uz kuru zvanīs. Obligāts.
  • caller_id — numurs, ko redzēs klients. Neobligāts. Ja izlaists, tiek izmantots izejošais numurs no savienojuma iestatījumiem.

Funkcija atgriež call_uuid — zvana identifikatoru. Tas tiek saglabāts arī mainīgajā verimor_call_uuid.

Zvana pārsūtīšana

verimor_transfer_call(employee_extension, call_uuid)

Pārsūta pašreizējo zvanu uz citu iekšējo numuru.

Parametri:

  • employee_extension — iekšējais numurs, uz kuru tiks pārsūtīts zvans. Obligāts.
  • call_uuid — zvana identifikators. Neobligāts. Ja izlaists, tiek izmantots klienta pēdējais zvans.

Zvana pabeigšana

verimor_hangup_call(call_uuid)

Parametri:

  • call_uuid — zvana identifikators. Neobligāts. Ja izlaists, tiek izmantots klienta pēdējais zvans.

Zvana ieraksta saites iegūšana

verimor_get_record_link(call_uuid)

Pieprasa jaunu saiti uz zvana ierakstu.

Parametri:

  • call_uuid — zvana identifikators. Neobligāts. Ja izlaists, tiek izmantots klienta pēdējais zvans.

Atzvani zvana laikā

Zvana gaitā sarunā tiek nosūtīti atzvani šādā formātā:

verimor_call_event answer

Iespējamie notikumi:

Notikums Kad tas tiek aktivizēts
ringing Zvans zvana
answer Zvans ir atbildēts
hangup Zvans ir beidzies
user_hangup Darbinieks pabeidza zvanu

Zvani starp darbiniekiem neparādās sarunā.

Tipisks scenārijs "nav atbildes → nosūtīt ziņojumu messenger" var tikt aktivizēts ar hangup un pārbaudot mainīgo verimor_call_answered.

Klienta mainīgie pēc zvana

Mainīgais Vērtība
verimor_call_uuid Zvana identifikators
verimor_call_direction Virziens: inbound — klients zvana jums, outbound — jūs zvanāt klientam
verimor_call_extension Darbinieka iekšējais numurs, kurš apstrādāja zvanu
verimor_call_duration Zvana ilgums sekundēs
verimor_call_answered 1 — zvans tika atbildēts, 0 — netika
verimor_hangup_cause Kods, kas norāda, kāpēc zvans beidzās
verimor_has_record 1 — ieraksts pastāv, 0 — ieraksta nav
verimor_record_link Saite uz zvana ierakstu pēc verimor_get_record_link() izsaukšanas

Zvana pārtraukšanas iemeslu kodi

Visbiežāk sastopamās verimor_hangup_cause vērtības ir:

Kods Nozīme
NORMAL_CLEARING Zvans tika pabeigts un beidzās normāli
USER_BUSY Aizņemts
NO_ANSWER Nav atbildes
ORIGINATOR_CANCEL Zvanītājs nolika klausuli pirms zvana atbildēšanas
CALL_REJECTED Zvans tika noraidīts
UNALLOCATED_NUMBER Nederīgs numurs
NO_USER_RESPONSE Abonents nav pieejams
NOT_ALLOWED_BY_IYS Nav atļaujas İYS, Turcijas komerciālo zvanu piekrišanas reģistrā

Zvana ieraksti

Zvana ierakstīšana ir jāiespējo jūsu Verimor PBX iestatījumos. Ieraksti tiek glabāti jūsu Verimor kontā.

⏳ Ierakstu saites ir derīgas 60 minūtes no to pieprasīšanas brīža. Pēc tam tās pārstāj darboties. Verimor arī atļauj ne vairāk kā piecus ierakstu saites pieprasījumus minūtē uz vienu API atslēgu.

Ko tas nozīmē:

  • Mainīgais verimor_record_link netiek aizpildīts automātiski. Vispirms ir jāizsauc verimor_get_record_link().
  • Scenārijā, kas nosūta ierakstu, izsauciet verimor_get_record_link() tajā brīdī, kad ieraksts tiek nosūtīts, nevis iepriekš.
  • Vispirms pārbaudiet verimor_has_record, lai netērētu pieprasījumu limitu zvaniem, kuriem nav ieraksta.
  • Ja nepieciešams saglabāt ierakstu pastāvīgi, saglabājiet failu savā krātuvē uzreiz pēc zvana.
  • Ierakstu arhīvs paliek pieejams Verimor panelī, kur ierakstus var atskaņot un lejupielādēt vēlāk.

Zvana ierakstīšana ir reglamentēta ar likumu. Turcijā tā ir pakļauta KVKK prasībām: klients ir jāinformē par ierakstīšanu, un personas datu glabāšanai jābūt likumīgam pamatam. Verimor konta īpašnieks ir atbildīgs par piemērojamo prasību ievērošanu.

Problēmu novēršana

Kļūda Iemesls / Risinājums
Gecersiz anahtar Nederīga API atslēga. Iegūstiet pašreizējo atslēgu no Santral Ayarlarım sadaļas.
extension 1005 not found Iekšējais numurs neeksistē jūsu PBX sistēmā. Pārliecinieties, ka darbinieka iestatījumos ir esošs dahili.
"Verimor iekšējais numurs nav norādīts" Darbinieka iestatījumi ir tukši vai satur mobilā tālruņa numuru, nevis iekšējo numuru.
Zvani darbojas, bet sarunā neparādās atzvani Paziņojumu URL nav konfigurēts. Saglabājiet savienojuma formu vēlreiz.
Zvani pārtrauca darboties pēc API atslēgas maiņas Atslēga tika atkārtoti ģenerēta Verimor panelī. Ievadiet jauno atslēgu savienojuma formā un saglabājiet to.
Ieraksta saite neatveras Saite ir beigusies. Pieprasiet jaunu ar verimor_get_record_link() vai atveriet ierakstu Verimor panelī.
Ieraksta saite netiek atgriezta Ir sasniegts piecu pieprasījumu limits minūtē, vai zvanam nav ieraksta. Pārbaudiet verimor_has_record.