Twilio ir starptautisks telekomunikāciju pakalpojumu sniedzējs. Tas ļauj botam zvanīt klientiem un savienot viņus ar jūsu darbiniekiem vairāk nekā 100 valstīs, kurās Twilio piedāvā tālruņa numurus, tostarp Meksikā, Brazīlijā, Turcijā, Spānijā, Vācijā, Francijā, AAE, Taizemē, Malaizijā un daudzās citās.

Ko jūs iegūstat pēc Twilio savienošanas:

  • zvaniet klientam ar vienu klikšķi tieši no sarunas kartes;
  • automatizēti scenāriju zvanīšana — bots zvana klientam un nolasa teksta ziņojumu skaļi;
  • grupu zvani — bots zvana klientam un savieno viņu ar pirmo pieejamo darbinieku;
  • visu zvanu ierakstīšana, ar ieraksta saiti, kas tiek glabāta pasūtījuma mainīgajos;
  • zvanu notikumi (zvana signāls, atbildēts, pabeigts) tieši sarunā — tos varat izmantot scenāriju veidošanai.

1. darbība. Izveidojiet kontu un iegādājieties numuru

  1. Reģistrējieties vietnē twilio.com un pabeidziet verifikācijas procesu.
  2. Twilio konsolē atveriet Phone Numbers → Buy a number un izvēlieties numuru vajadzīgajā valstī. Pārliecinieties, ka ir iespējots Voice — daži numuri atbalsta tikai SMS un tos nevar izmantot zvanīšanai.

2. darbība. Kopējiet savus piekļuves akreditācijas datus

Twilio konsoles galvenajā lapā sadaļā Account Info atradīsiet divas vērtības:

Vienums Kā tas izskatās
Account SID ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Auth Token paslēpts; noklikšķiniet uz Show, lai to atklātu

⚠️ Kopējiet Auth Token tieši tādu, kāds tas ir, bez papildu atstarpēm pirms vai pēc tā. Mēs to izmantojam, lai pārbaudītu katra pieprasījuma autentiskumu no Twilio. Viens neredzams papildu rakstzīme var izraisīt to, ka zvani darbojas, bet zvanu notikumi neparādās sarunā.

Auth Token nodrošina pilnīgu piekļuvi jūsu Twilio kontam un tajā esošajiem līdzekļiem. Nenosūtiet to caur kurjeriem un nepublicējiet to nekur.

3. darbība. Savienojiet Twilio savā kontā

Atveriet Project → Integrations → Telephony → Twilio un aizpildiet trīs laukus:

Lauks Ko ievadīt
Account SID no 2. darbības
Auth Token no 2. darbības
Twilio Number jūsu iegādātais numurs starptautiskā formātā: +14155550100

Numurs jāievada E.164 formātā: +, valsts kods un tālruņa numurs, bez atstarpēm, iekavām vai defisēm.

Pēc saglabāšanas lapā parādīsies callback URL. Kopējiet to. Pēc tam atveriet sava iegādātā numura iestatījumus Twilio konsolē un sadaļā Voice & Fax konfigurējiet:

  • A call comes in → Webhook → ielīmējiet kopēto URL un izvēlieties HTTP POST.

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

Lai atvienotu integrāciju, notīriet Account SID lauku un saglabājiet iestatījumus.

4. darbība. Pievienojiet darbinieku tālruņa numurus

Twilio zvana darbiniekiem uz parastajiem tālruņa numuriem — šeit nav iekšējo pagarinājumu.

Atveriet cilni Team, izvēlieties darbinieku un aizpildiet lauku Twilio Phone Number ar viņa pilno tālruņa numuru tādā pašā formātā:

+905551112233

Bez šī numura 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. Noklikšķinot uz tās, tiek uzsākta šāda secība:

  1. Twilio zvana darbiniekam — darbinieks redz jūsu Twilio numuru kā zvanītāja ID.
  2. Darbinieks atbild uz zvanu.
  3. Tikai tad Twilio zvana klientam un savieno abas puses.

Secība ir apzināta: klientam nav jāklausās zvana signāls, kamēr darbinieks tiek pie tālruņa. Ja darbinieks neatbild, klients netiek zvanīts vispār.

Zvani no botu scenārijiem

Kalkulatorā ir pieejamas četras metodes.

twilio_employee_call(client_phone, employee_phone, caller_id)

Savieno darbinieku ar klientu. Tas darbojas tāpat kā zvanīšanas poga klienta kartē: vispirms tiek zvanīts darbiniekam, pēc tam klientam.

twilio_employee_call(client_phone, "+905551112233")

Trešais arguments nav obligāts. Tas norāda tālruņa numuru, ko klients redzēs kā zvanītāja ID. Pēc noklusējuma tiek izmantots jūsu Twilio numurs.

twilio_group_call(client_phone, employee_phones, caller_id)

Zvana klientam un, kad klients atbild, vienlaikus zvana visiem darbiniekiem norādītajā sarakstā. Zvans tiek savienots ar pirmo darbinieku, kurš atbild.

twilio_group_call(client.phone, "+905551112233,+905554445566,+905557778899")

⚠️ Šeit secība ir apgriezta. Atšķirībā no iepriekšējās metodes, klients atbild pirmais un var dzirdēt dažas sekundes klusuma, kamēr Twilio zvana darbiniekiem. Tas ir Twilio ierobežojums: vienlaicīga grupas zvanīšana un pirmā atbildētāja savienošana darbojas tikai šādi. Ja ir svarīgi, lai klientam nebūtu jāgaida, izmantojiet twilio_employee_call.

twilio_play_message(client_phone, text, voice, language)

Zvana klientam un nolasa norādīto tekstu, izmantojot sintezētu runu. Tas ir noderīgi tikšanās atgādinājumiem, pasūtījumu apstiprinājumiem un piegādes paziņojumiem.

twilio_play_message(client.phone, "Hello! This is a reminder about your appointment tomorrow at 3:00 PM.", "alice", "en-EN")

Balss alice ir universāla un atbalsta galvenās valodas, tostarp tr-TR, es-ES, es-MX, pt-BR, de-DE, fr-FR, en-US, ru-RU un ar-XA.

Vienmēr norādiet valodu skaidri — pretējā gadījumā Twilio var nolasīt tekstu ar angļu izrunu.

Neiekļaujiet ziņojumā paroles, verifikācijas kodus vai citu sensitīvu informāciju: zvanu var atbildēt balss pasts.

Atgriež saiti uz zvanu ierakstu. Tas reti ir nepieciešams, jo saite parasti parādās automātiski (skatiet nākamo sadaļu). Tas var būt noderīgi, ja ieraksta saite netika saņemta un tā ir jāpieprasa vēlreiz.

twilio_get_record_link()

Ja arguments nav norādīts, tiek izmantots klienta pēdējais zvans.

Mainīgie un notikumi

Pēc katra zvana bots saglabā šādus mainīgos klienta pasūtījumā:

Mainīgais Ko tas satur
twilio_call_id Twilio zvana identifikators
twilio_call_disposition zvana rezultāts: completed, busy, no-answer, failed, canceled
twilio_call_duration zvana ilgums sekundēs
twilio_record_link saite uz ierakstu
twilio_record_id Twilio ieraksta identifikators

Notikumi formātā twilio_call_event <status> tiek nosūtīti sarunā. Varat tos izmantot kā nosacījumus savos scenārijos:

Notikums Kad tas tiek nosūtīts
twilio_call_event initiated zvans ir izveidots
twilio_call_event ringing tālrunis zvana
twilio_call_event answered zvans ir atbildēts
twilio_call_event completed zvans ir beidzies
twilio_call_event busy / no-answer / failed / canceled zvanu nevarēja pabeigt
twilio_call_event recording zvana ieraksts ir gatavs

⚠️ Pirms ieraksta saites izmantošanas gaidiet recording notikumu, nevis completed notikumu. Twilio apstrādā ieraksta failu pēc tam, kad zvans jau ir beidzies. Kad tiek saņemts completed notikums, twilio_record_link mainīgais joprojām ir tukšs. Tāpēc scenārijam, kas nosūta ierakstu vadītājam vai CRM, ir jābūt aktivizētam ar recording notikumu.

Tipisks scenārijs "nevarēja sasniegt klientu — nosūtiet viņam ziņojumu" darbojas šādi: nosacījums twilio_call_event no-answer vai busy → nosūtiet ziņojumu klientam.

Zvanu ieraksti

Ierakstīšana ir iespējota pēc noklusējuma visiem zvaniem, kuros iesaistīts darbinieks. Abas sarunas puses tiek ierakstītas no brīža, kad zvans tiek atbildēts. Faili tiek glabāti jūsu Twilio kontā, un Twilio par tiem iekasē maksu.

⚠️ twilio_record_link URL norāda tieši uz Twilio un ir aizsargāts ar jūsu konta akreditācijas datiem. Jūs to nevarat vienkārši atvērt pārlūkprogrammā vai nosūtīt klientam — tiks parādīta piekļuves kļūda. Lai lejupielādētu ierakstu, atveriet Twilio konsoli un dodieties uz Monitor → Logs → Calls, pēc tam atrodiet zvanu, izmantojot tā twilio_call_id.

⚖️ Zvanu ierakstīšana ir reglamentēta ar likumu. Daudzās valstīs — tostarp Vācijā, Francijā, Spānijā un daudzos ASV štatos — var būt nepieciešama abu pušu piekrišana, un dažos gadījumos zvana sākumā ir jāatskaņo mutisks paziņojums. Kā Twilio konta īpašnieks jūs esat atbildīgs par piemērojamo prasību ievērošanu. Ja šie noteikumi attiecas uz jums, sāciet zvanu ar ierakstīšanas paziņojumu vai atspējojiet ierakstīšanu sava Twilio numura iestatījumos.

Problēmu novēršana

Zvans netiek izveidots un tiek atgriezta autentifikācijas kļūda

Account SID vai Auth Token ir nepareizs. Kopējiet tos vēlreiz no Twilio konsoles. Visbiežākie iemesli ir papildu atstarpe vai nejauša Test Token kopēšana galvenā Auth Token vietā.

Zvani darbojas, bet sarunā nav notikumu vai ierakstu

Callback URL nav konfigurēts Twilio numura iestatījumos (skatiet 3. darbību), vai arī tas ir konfigurēts ar nepareizu HTTP metodi. Metodei jābūt HTTP POST.

Vēl viens izplatīts iemesls ir tas, ka Auth Token tika mainīts Twilio, bet vecais tokens joprojām ir konfigurēts jūsu kontā. Šādā gadījumā pieprasījumu paraksti vairs nesakrīt, tāpēc visi atzvanīšanas pieprasījumi tiek noraidīti.

Kļūda 21606 vai "From number not valid"

Numurs, kas ievadīts laukā Twilio Number, vai nu nav iegādāts jūsu Twilio kontā, vai neatbalsta balss zvanus.

Atveriet Phone Numbers → Manage → Active numbers un pārliecinieties, ka numurs ir sarakstā un tam ir Voice iespēja.

Kļūda 21215 — Geo Permissions

Pēc noklusējuma Twilio bloķē zvanus uz daudzām valstīm kā krāpšanas novēršanas pasākumu.

Atveriet Voice → Settings → Geo Permissions un iespējojiet nepieciešamos galamērķus.

Klients zvana, bet sarunas karte tiek izveidota darbinieka numuram

Callback ir konfigurēts ar nepareizu URL. Kopējiet callback URL no integrācijas lapas vēlreiz, pārliecinoties, ka kopējat visu URL, ieskaitot visu pēc jautājuma zīmes.

Izmēģinājuma konts: Twilio atskaņo balss ziņojumu pirms zvana

Tā ir standarta izmēģinājuma kontu darbība. Izmēģinājuma konti var zvanīt tikai verificētiem tālruņa numuriem.

Pievienojiet līdzekļus savam kontam un jauniniet uz pilnu Twilio kontu.