VoIPstudio integrācija ar Mavibot — iestatīšanas ceļvedis

Lai Mavibot izmantotu VoIPstudio telefoniju, jūsu VoIPstudio kontā ir jāizveido API atslēga, tā jāievada integrācijas iestatījumos un jākonfigurē notikumu piegāde uz URL, ko Mavibot parāda pēc integrācijas savienošanas.

VoIPstudio ir mākoņa PBX ar tālruņa numuriem, kas pieejami vairāk nekā 70 valstīs. Atšķirībā no tradicionālā telekomunikāciju operatora, tas atbalsta iekšējos lietotājus, zvanu grupas, rindas un IVR izvēlnes, savukārt bots darbojas šīs PBX sistēmas augšpusē.

Bots var veikt zvanus klientiem darbinieku vārdā, pārsūtīt un pabeigt zvanus, saglabāt ierakstus un nosūtīt zvanu notikumus sarunā.

Nepieciešamās informācijas iegūšana

Reģistrējieties vietnē voipstudio.com un iegādājieties tālruņa numuru vajadzīgajā valstī.
Izveidojiet lietotājus PBX sistēmā — vienu katram darbiniekam, kurš saņems zvanus. Zvani tiek piegādāti visām ierīcēm, kas reģistrētas lietotājam, tāpēc katram darbiniekam nav jānorāda atsevišķs tālruņa numurs.
Dodieties uz Iestatījumi → API, izveidojiet API atslēgu un nokopējiet to.

Integrācijas savienošana

Telefonijas iestatījumos atlasiet VoIPstudio un ievadiet:

API atslēga — atslēga no jūsu VoIPstudio konta.

Integrācija tagad ir savienota. Lai to atvienotu, notīriet lauku API atslēga un saglabājiet iestatījumus.

Pēc saglabāšanas lapā parādīsies paziņojumu URL. Nokopējiet to:

https://chatter.mavibot.ai/voipstudio_webhook/<jūsu-projekta-atslēga>

Nepublicējiet šo URL un nedalieties ar to ne ar vienu. Ja atvienosiet un atkārtoti savienosiet integrāciju, atslēga paliek nemainīga, tāpēc paziņojumi nebūs jākonfigurē atkārtoti.

Pēc tam savā VoIPstudio kontā dodieties uz Integrācijas → Webhooks → Iespējot → Pievienot Webhook, ielīmējiet nokopēto URL un atlasiet šādus notikumus:

Zvana stāvokļa maiņa — vai arī atlasiet Zvana zvana signāls, Zvana savienojums, Zvana beigas un Zvana nepieņemšana atsevišķi;
Zvana ieraksta gatavība — ja nepieciešami zvanu ieraksti.

Bez šīs konfigurācijas izejošie zvani joprojām darbosies, bet zvanu notikumi netiks rādīti sarunā.

Darbinieki

Darbinieka iestatījumos aizpildiet lauku VoIPstudio lietotāja ID — lietotāja ciparu identifikatoru jūsu PBX sistēmā, piemēram, 10002.

Ievadiet PBX lietotāja ID, nevis tālruņa numuru. ID varat atrast lietotāju sarakstā savā VoIPstudio kontā. Bez tā zvanu poga klienta kartē šim darbiniekam nedarbosies.

Zvanīšana no klienta kartes

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

VoIPstudio vispirms zvana darbiniekam uz visām viņa reģistrētajām ierīcēm vienlaikus. Kad darbinieks atbild, VoIPstudio zvana klientam un savieno abas puses.

Ja darbinieks neatbild, klients netiks zvanīts.

Kalkulatora funkcijas

Darbinieka un klienta zvans

voipstudio_employee_call(client_phone, employee_user_id, caller_id)

Parametri:

client_phone — klienta tālruņa numurs. Obligāts.
employee_user_id — VoIPstudio lietotāja ID darbiniekam, kuram jāsaņem pirmais zvans. Obligāts.
caller_id — tālruņa numurs, kas tiek rādīts klientam. Neobligāts. Varat norādīt anonymous, lai paslēptu zvanītāja ID.

Zvana pārsūtīšana

voipstudio_transfer_call(phone, call_id)

Pārsūta aktīvo zvanu uz citu tālruņa numuru.

Parametri:

phone — tālruņa numurs, uz kuru jāpārsūta zvans. Obligāts un jābūt pirmajam parametram.
call_id — zvana identifikators. Neobligāts. Ja izlaists, klienta pašreizējais zvans tiek ņemts no mainīgā voipstudio_call_id.

Zvana pabeigšana

voipstudio_hangup_call(call_id)

Pabeidz aktīvo zvanu.

Parametri:

call_id — zvana identifikators. Neobligāts. Ja izlaists, tiek izmantots klienta pašreizējais zvans.

Zvana ieraksta saites iegūšana

voipstudio_get_record_link(call_id)

Atgriež saiti uz zvanu ierakstu. Saite parasti tiek automātiski saglabāta, kad tiek saņemts ieraksta gatavības notikums. Šī funkcija ir noderīga, ja šis notikums netika saņemts.

Parametri:

call_id — zvana identifikators. Neobligāts. Ja izlaists, tiek izmantots klienta pašreizējais zvans.

Funkcija meklē starp 100 jaunākajiem ierakstiem kontā. Vecākam zvanam ar lielu PBX noslodzi ieraksts var netikt atrasts. Tādā gadījumā ierakstu lejupielādējiet tieši no sava VoIPstudio konta.

Atgriezeniskie signāli zvana laikā

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

voipstudio_call_event call.hangup

Notikuma nosaukums tiek nodots tieši tā, kā saņemts no VoIPstudio, piemēram, call.ringing, call.connected, call.hangup un citi. Pieejamie notikumi ir atkarīgi no tā, kurus notikumus atlasījāt, konfigurējot paziņojumus.

Ja notikuma nosaukums nav norādīts, tiek izmantots zvana stāvoklis:

INITIAL, RINGING, CONNECTED, ON_HOLD, HANGUP.

Atsevišķs atgriezeniskais signāls tiek nosūtīts, kad ieraksts ir gatavs:

voipstudio_call_event recording

Pirms ieraksta saites izmantošanas gaidiet recording atgriezenisko signālu. Ieraksts tiek apstrādāts pēc zvana beigām, tāpēc mainīgais voipstudio_record_link joprojām ir tukšs, kad tiek saņemts call.hangup.

Ja divi darbinieki jūsu PBX sistēmā runā savā starpā, atgriezeniskie signāli netiek nosūtīti sarunai un netiek izveidota klienta karte.

Klienta mainīgie pēc zvana

Mainīgais	Vērtība
voipstudio_call_id	Zvana ID VoIPstudio
voipstudio_call_state	Zvana stāvoklis: `INITIAL`, `RINGING`, `CONNECTED`, `ON_HOLD`, `HANGUP`
voipstudio_call_duration	Zvana ilgums sekundēs
voipstudio_call_cause	Iemesls, kāpēc zvans beidzās
voipstudio_terminated_by	Kurš pabeidza zvanu: `caller` vai `callee`
voipstudio_record_link	Saite uz zvanu ierakstu
voipstudio_record_id	Ieraksta ID VoIPstudio

Zvanu ieraksti

Zvanu ierakstīšana tiek iespējota VoIPstudio iestatījumos, un to pārvalda pati PBX sistēma. Ja nepieciešami ieraksti, iespējojiet zvanu ierakstīšanu savā VoIPstudio kontā un konfigurējot paziņojumus atlasiet notikumu Zvana ieraksta gatavība.

voipstudio_record_link URL ir aizsargāts ar piekļuves atslēgu. To nevar atvērt tieši pārlūkprogrammā vai kopīgot ar klientu. Ierakstu varat lejupielādēt no sava VoIPstudio konta zvanu vēstures sadaļā.

Zvanu ierakstīšana ir pakļauta piemērojamiem likumiem. Vācijā, Francijā, Spānijā un lielākajā daļā ASV štatu var būt nepieciešama abu pušu piekrišana, un dažās jurisdikcijās var būt nepieciešams arī mutisks paziņojums zvana sākumā. VoIPstudio konta īpašnieks ir atbildīgs par šo prasību ievērošanu.

Problēmu novēršana

Kļūda	Iemesls
Autorizācijas kļūda, veidojot zvanu	API atslēga ir nepareiza vai beidzies tās derīguma termiņš. Pārliecinieties, ka atslēga tika izveidota sadaļā Iestatījumi → API, nevis iegūta ar `login` pieprasījumu.
Zvani darbojas, bet sarunā netiek rādīti atgriezeniskie signāli	VoIPstudio nav izveidots webhook, slēdzis Iespējot ir izslēgts vai ievadīts nepareizs URL. Nokopējiet visu URL no integrācijas lapas, ieskaitot atslēgu beigās.
Zvanu nevar izveidot vai darbinieka ierīces nezvan	Tālruņa numurs tika ievadīts, nevis VoIPstudio lietotāja ID, vai lietotājam nav reģistrētu ierīču.
`recording` atgriezeniskais signāls netiek saņemts	Zvanu ierakstīšana nav iespējota VoIPstudio, vai notikums Zvana ieraksta gatavība netika atlasīts.

VoIPstudio tiek norēķināts tieši VoIPstudio: par katru PBX lietotāju ir abonēšanas maksa, plus zvanu izmaksas. Tas atšķiras no operatoriem, kas iekasē maksu par minūti bez atkārtotas abonēšanas. Aprēķinot izmaksas, ņemiet vērā konfigurēto lietotāju skaitu, ne tikai zvanu apjomu.