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

Aircall — сату және қолдау топтарына арналған бұлттық телефон жүйесі, 100+ елде телефон нөмірлерін ұсынады. Ол қызметкерлері Aircall қолданбасын қолданатын компанияларға арналған: бот қоңырауларды қызметкер атынан шалады, бөлек бот нөмірінен емес.

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

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

  1. aircall.io сайтында тіркеліңіз, қажетті елде телефон нөмірін сатып алыңыз және қызметкерлеріңізге Aircall пайдаланушыларын жасаңыз.
  2. Dashboard → Settings → Integrations & API → API Keys бөлімін ашып, кілттер жұбын жасаңыз:
    • API ID
    • API Token
  3. Шығыс қоңыраулар үшін пайдаланылатын нөмірдің Number ID мәнін және қызметкерлеріңіздің User ID мәндерін табыңыз. Бұл идентификаторлар Aircall басқару панелінде тиісті беттерді ашқанда мекенжай жолағында көрінеді.

API Token жасалған кезде тек бір рет көрсетіледі. Егер оны жоғалтсаңыз, API кілттерінің жаңа жұбын жасап, ескісін жойыңыз.

Қосылу

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

  • API ID — API кілтінің идентификаторы.
  • API Token — құпия API токені.
  • Number ID — шығыс қоңыраулар үшін пайдаланылатын Aircall желісінің сандық идентификаторы.

Интеграция енді қосылды.


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

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

Қызметкер параметрлерінде Aircall User ID өрісіне қызметкердің Aircall тіркелгісінің сандық идентификаторын енгізіңіз.

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

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

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

Aircall алдымен қоңырауды қызметкердің Aircall қолданбасында бастайды — жұмыс үстелінде немесе мобильді құрылғыда. Қызметкер жауап бергеннен кейін, Aircall клиентке қоңырау шалып, екі жақты байланыстырады.

Қоңырау өтпейді, егер қызметкер офлайн болса, басқа қоңырауда болса немесе Aircall-да таңдалған нөмірге тағайындалмаған болса. Бұл Aircall шектеуі: қоңыраулар тек қолжетімді пайдаланушы арқылы жасалуы мүмкін.

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

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

aircall_employee_call(client_phone, employee_user_id, number_id)

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

  • client_phone — клиенттің халықаралық E.164 форматындағы телефон нөмірі. Міндетті.
  • employee_user_id — қоңырауды өз Aircall қолданбасында қабылдайтын қызметкердің Aircall User ID. Міндетті.
  • number_id — қоңырау шалу үшін пайдаланылатын Aircall нөмірінің идентификаторы. Қосымша. Егер көрсетілмесе, интеграция параметрлерінде конфигурацияланған нөмір пайдаланылады.

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

aircall_get_record_link(call_id)

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

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

  • call_id — Aircall қоңырау идентификаторы. Қосымша. Егер көрсетілмесе, клиенттің ең соңғы қоңырауы пайдаланылады.

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

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

aircall_call_event call.answered

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

Оқиға Қашан іске қосылады
call.created Қоңырау жасалды
call.ringing_on_agent Қызметкер қоңырауды қабылдап жатыр
call.answered Қоңырауға жауап берілді
call.hungup Тараптардың бірі түтікті қойды
call.ended Қоңырау толығымен аяқталды
call.voicemail_left Клиент дауыстық хабарлама қалдырды

Типтік "жауап жоқ → мессенджерде хабарлама жіберу" сценарийі call.ended оқиғасымен және aircall_missed_reason айнымалысын тексеру арқылы іске қосылуы мүмкін.

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

Қоңыраудан кейін клиент үшін келесі айнымалылар қолжетімді:

Айнымалы Мәні
aircall_call_id Aircall қоңырау идентификаторы
aircall_call_direction Қоңырау бағыты: inbound немесе outbound
aircall_call_status Қоңырау күйі: initial, answered немесе done
aircall_call_duration Қоңырау ұзақтығы секундпен
aircall_missed_reason Қоңыраудың аяқталмау себебі
aircall_record_link Қоңырау жазбасына сілтеме

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

Aircall параметрлерінде қоңырау жазбасы қосылуы керек. Жазбалар Aircall тіркелгіңізде сақталады.

⏳ Aircall жазба сілтемелері шектеулі уақытқа қолжетімді — әдетте қоңыраудан кейін бірнеше сағат қана. Одан кейін сілтемелер жұмыс істемейді. Бұл Aircall-дың жұмыс істеу тәсілі және Mavibot шектеуі емес.

Бұл нені білдіреді:

  • Қоңырау жазбасын жіберетін сценарийде aircall_get_record_link() функциясын жазбаны жіберу сәтінде шақырыңыз, бұрын сақталған сілтемені пайдаланудың орнына.
  • Егер жазбаны тұрақты сақтау қажет болса, файлды қоңыраудан кейін бірден өз сақтау орныңызға сақтаңыз.
  • Жазба мұрағаты Aircall басқару панелінде қолжетімді болып қалады, онда жазбаларды кейінірек ойнатуға және жүктеуге болады.

Қоңырау жазбасы заңмен реттеледі. Германияда, Францияда, Испанияда және АҚШ-тың көптеген штаттарында екі тараптың да келісімі қажет болуы мүмкін, ал кейбір юрисдикцияларда қоңыраудың басында ауызша хабарлама да қажет болуы мүмкін. Aircall тіркелгісінің иесі қолданыстағы заңдар мен ережелерді сақтауға жауапты.

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

Қате Себеп / Шешім
Қоңырау шалу кезінде авторизация қатесі API ID / API Token жұбы қате. Токен жасалған кезде тек бір рет көрсетіледі. Егер ол жоғалса, API Keys бөлімінде жаңа жұп жасап, ескісін жойыңыз.
Қоңырау жасалмайды немесе қызметкер қоңырауды қабылдамайды Қызметкер Aircall қолданбасында офлайн, басқа қоңырауда немесе Aircall параметрлерінде таңдалған нөмірге тағайындалмаған.
"Aircall User ID көрсетілмеген" Қызметкер параметрлеріндегі Aircall User ID өрісі бос немесе сандық пайдаланушы идентификаторының орнына телефон нөмірі енгізілген.
Қоңыраулар жұмыс істейді, бірақ сөйлесуде кері шақырулар пайда болмайды Вебхук тіркелмеген. Оны тіркеу үшін Aircall интеграция параметрлерін қайта сақтаңыз.
Жазба сілтемесі ашылмайды Сілтеме мерзімі өтіп кеткен. aircall_get_record_link() функциясын пайдаланып жаңа сілтеме сұраңыз немесе жазбаны тікелей Aircall басқару панелінде ашыңыз.