Lai Mavibot izmantotu Aircall telefoniju, jūsu Aircall kontā ir jāizveido API atslēgu pāris un jāievada tās integrācijas iestatījumos.

Aircall ir mākoņa tālruņu sistēma pārdošanas un atbalsta komandām, kas piedāvā tālruņu numurus vairāk nekā 100 valstīs. Tā ir paredzēta uzņēmumiem, kuru darbinieki jau izmanto Aircall lietotni: bots veic zvanus darbinieka vārdā, nevis no atsevišķa bota numura.

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

Nepieciešamo datu iegūšana

  1. Reģistrējieties aircall.io, iegādājieties tālruņa numuru vajadzīgajā valstī un izveidojiet Aircall lietotājus saviem darbiniekiem.
  2. Atveriet Dashboard → Settings → Integrations & API → API Keys un izveidojiet atslēgu pāri:
    • API ID
    • API Token
  3. Atrodiet Number ID numuram, kas tiks izmantots izejošajiem zvaniem, un User IDs saviem darbiniekiem. Šie ID ir redzami adreses joslā, kad atverat atbilstošās lapas Aircall panelī.

API Token tiek parādīts tikai vienu reizi tā izveides laikā. Ja to pazaudējat, izveidojiet jaunu API atslēgu pāri un anulējiet veco.

Savienojums

Telefonijas iestatījumos atlasiet Aircall un ievadiet:

  • API ID — API atslēgas identifikators.
  • API Token — slepenais API tokens.
  • Number ID — Aircall līnijas ciparu ID, kas tiks izmantots izejošajiem zvaniem.

Integrācija tagad ir savienota.


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

Darbinieki

Darbinieka iestatījumos aizpildiet lauku Aircall User ID ar darbinieka Aircall konta ciparu ID.

Ievadiet lietotāja ID, nevis darbinieka tālruņa numuru. Bez šī ID 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.

Aircall vispirms sāk zvanu darbinieka Aircall lietotnē — datorā vai mobilajā ierīcē. Kad darbinieks atbild, Aircall zvana klientam un savieno abas puses.

Zvans neizdosies, ja darbinieks ir bezsaistē, jau runā citā zvanā vai nav piešķirts izvēlētajam numuram Aircall. Tas ir Aircall ierobežojums: zvanus var veikt tikai caur pieejamu lietotāju.

Kalkulatora funkcijas

Darbinieka un klienta zvans

aircall_employee_call(client_phone, employee_user_id, number_id)

Parametri:

  • client_phone — klienta tālruņa numurs starptautiskajā E.164 formātā. Obligāts.
  • employee_user_id — darbinieka Aircall lietotāja ID, kurš saņems zvanu savā Aircall lietotnē. Obligāts.
  • number_id — Aircall numura ID, kas tiek izmantots zvana veikšanai. Neobligāts. Ja izlaists, tiek izmantots integrācijas iestatījumos konfigurētais numurs.

Zvana ieraksta saites iegūšana

aircall_get_record_link(call_id)

Pieprasa jaunu saiti uz zvana ierakstu.

Parametri:

  • call_id — Aircall zvana ID. Neobligāts. Ja izlaists, tiek izmantots klienta pēdējais zvans.

Atzvanīšanas notikumi zvana laikā

Zvana laikā sarunā tiek nosūtīti atzvanīšanas notikumi šādā formātā:

aircall_call_event call.answered

Iespējamie notikumi:

Notikums Kad tas tiek aktivizēts
call.created Zvans ir izveidots
call.ringing_on_agent Darbinieks saņem zvanu
call.answered Zvans ir atbildēts
call.hungup Viena no pusēm ir nolikusi klausuli
call.ended Zvans ir pilnībā beidzies
call.voicemail_left Klients atstāja balss pastu

Tipisks scenārijs "nav atbildes → nosūtīt ziņojumu kurjerā" var tikt aktivizēts ar call.ended un pārbaudot aircall_missed_reason mainīgo.

Klienta mainīgie pēc zvana

Pēc zvana klientam ir pieejami šādi mainīgie:

Mainīgais Vērtība
aircall_call_id Aircall zvana ID
aircall_call_direction Zvana virziens: inbound vai outbound
aircall_call_status Zvana statuss: initial, answered vai done
aircall_call_duration Zvana ilgums sekundēs
aircall_missed_reason Iemesls, kāpēc zvans netika pabeigts
aircall_record_link Saite uz zvana ierakstu

Zvana ieraksti

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

⏳ Aircall ierakstu saites ir pieejamas ierobežotu laiku — parasti tikai dažas stundas pēc zvana. Pēc tam saites pārstāj darboties. Tā darbojas Aircall, un tas nav Mavibot ierobežojums.

Ko tas nozīmē:

  • Scenārijā, kas nosūta zvana ierakstu, izsauciet aircall_get_record_link() brīdī, kad ieraksts tiek nosūtīts, nevis izmantojiet iepriekš saglabātu saiti.
  • Ja nepieciešams saglabāt ierakstu pastāvīgi, saglabājiet failu savā krātuvē uzreiz pēc zvana.
  • Ierakstu arhīvs paliek pieejams Aircall panelī, kur ierakstus var atskaņot un lejupielādēt vēlāk.

Zvana ierakstīšanu regulē likums. Vācijā, Francijā, Spānijā un daudzos ASV štatos 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ā. Aircall konta īpašnieks ir atbildīgs par piemērojamo likumu un noteikumu ievērošanu.

Problēmu novēršana

Kļūda Cēlonis / Risinājums
Autorizācijas kļūda, veicot zvanu API ID / API Token pāris ir nepareizs. Tokens tiek parādīts tikai vienu reizi tā izveides laikā. Ja tas ir pazaudēts, izveidojiet jaunu pāri sadaļā API Keys un anulējiet veco.
Zvans netiek izveidots vai darbinieks nesaņem zvanu Darbinieks ir bezsaistē Aircall lietotnē, jau runā citā zvanā vai nav piešķirts izvēlētajam numuram Aircall iestatījumos.
"Aircall User ID nav norādīts" Lauks Aircall User ID darbinieka iestatījumos ir tukšs, vai arī tālruņa numurs tika ievadīts, nevis ciparu lietotāja ID.
Zvani darbojas, bet sarunā neparādās atzvanīšanas notikumi Tīmekļa paziņojums (webhook) nav reģistrēts. Saglabājiet Aircall integrācijas iestatījumus vēlreiz, lai to reģistrētu.
Ieraksta saite neatveras Saite ir beigusies. Pieprasiet jaunu saiti, izmantojot aircall_get_record_link(), vai atveriet ierakstu tieši Aircall panelī.