Untuk menggunakan telefon Aircall dalam Mavibot, anda perlu mencipta sepasang kunci API dalam akaun Aircall anda dan memasukkannya dalam tetapan integrasi.

Aircall ialah sistem telefon berasaskan awan untuk pasukan jualan dan sokongan, menawarkan nombor telefon di lebih 100 negara. Ia direka untuk syarikat yang pekerjanya sudah menggunakan aplikasi Aircall: bot membuat panggilan atas nama pekerja, bukan daripada nombor bot yang berasingan.

Bot boleh menyambungkan pekerja dengan pelanggan, mendapatkan rakaman panggilan, dan menghantar peristiwa panggilan ke perbualan.

Mendapatkan data yang diperlukan

  1. Daftar di aircall.io, beli nombor telefon di negara yang diperlukan, dan cipta pengguna Aircall untuk pekerja anda.
  2. Buka Dashboard → Settings → Integrations & API → API Keys dan cipta sepasang kunci:
    • API ID
    • API Token
  3. Cari Number ID untuk nombor yang akan digunakan untuk panggilan keluar dan User IDs untuk pekerja anda. ID ini kelihatan dalam bar alamat apabila anda membuka halaman yang sepadan dalam papan pemuka Aircall.

API Token hanya dipaparkan sekali semasa ia dicipta. Jika anda kehilangannya, cipta sepasang kunci API baharu dan batalkan yang lama.

Sambungan

Dalam tetapan telefon, pilih Aircall dan masukkan:

  • API ID — pengecam kunci API.
  • API Token — token API rahsia.
  • Number ID — ID berangka talian Aircall yang akan digunakan untuk panggilan keluar.

Integrasi kini disambungkan.


Untuk memutuskan integrasi, kosongkan medan API ID dan simpan tetapan.

Pekerja

Dalam tetapan pekerja, isi medan Aircall User ID dengan ID berangka akaun Aircall pekerja.

Masukkan ID pengguna, bukan nombor telefon pekerja. Tanpa ID ini, butang panggilan dalam kad pelanggan tidak akan berfungsi untuk pekerja tersebut.

Memanggil dari kad pelanggan

Butang panggilan akan muncul di sebelah nombor telefon pelanggan dalam kad perbualan.

Aircall mula-mula memulakan panggilan dalam aplikasi Aircall pekerja — pada desktop atau mudah alih. Sebaik sahaja pekerja menjawab, Aircall memanggil pelanggan dan menyambungkan kedua-dua pihak.

Panggilan tidak akan berjaya jika pekerja offline, sedang dalam panggilan lain, atau tidak ditugaskan ke nombor yang dipilih dalam Aircall. Ini adalah had Aircall: panggilan hanya boleh dibuat melalui pengguna yang tersedia.

Fungsi Kalkulator

Panggilan Pekerja-ke-Pelanggan

aircall_employee_call(client_phone, employee_user_id, number_id)

Parameter:

  • client_phone — nombor telefon pelanggan dalam format antarabangsa E.164. Diperlukan.
  • employee_user_id — ID Pengguna Aircall pekerja yang akan menerima panggilan dalam aplikasi Aircall mereka. Diperlukan.
  • number_id — ID nombor Aircall yang digunakan untuk membuat panggilan. Pilihan. Jika diabaikan, nombor yang dikonfigurasikan dalam tetapan integrasi digunakan.

Dapatkan Pautan Rakaman Panggilan

aircall_get_record_link(call_id)

Meminta pautan baharu ke rakaman panggilan.

Parameter:

  • call_id — ID panggilan Aircall. Pilihan. Jika diabaikan, panggilan terbaru pelanggan digunakan.

Panggilan Balik Semasa Panggilan

Semasa panggilan berlangsung, panggilan balik dihantar ke perbualan dalam format berikut:

aircall_call_event call.answered

Peristiwa yang mungkin:

Peristiwa Bila ia dicetuskan
call.created Panggilan telah dicipta
call.ringing_on_agent Pekerja sedang menerima panggilan
call.answered Panggilan telah dijawab
call.hungup Salah satu pihak telah menamatkan panggilan
call.ended Panggilan telah tamat sepenuhnya
call.voicemail_left Pelanggan meninggalkan mel suara

Senario biasa "tiada jawapan → hantar mesej dalam messenger" boleh dicetuskan oleh call.ended dan menyemak pemboleh ubah aircall_missed_reason.

Pemboleh Ubah Pelanggan Selepas Panggilan

Selepas panggilan, pemboleh ubah berikut tersedia untuk pelanggan:

Pemboleh Ubah Nilai
aircall_call_id ID panggilan Aircall
aircall_call_direction Arah panggilan: inbound atau outbound
aircall_call_status Status panggilan: initial, answered, atau done
aircall_call_duration Tempoh panggilan dalam saat
aircall_missed_reason Sebab mengapa panggilan tidak diselesaikan
aircall_record_link Pautan ke rakaman panggilan

Rakaman Panggilan

Rakaman panggilan mesti diaktifkan dalam tetapan Aircall anda. Rakaman disimpan dalam akaun Aircall anda.

⏳ Pautan rakaman Aircall tersedia untuk masa yang terhad — biasanya hanya untuk beberapa jam selepas panggilan. Selepas itu, pautan berhenti berfungsi. Ini adalah cara Aircall berfungsi dan bukan had Mavibot.

Maksudnya:

  • Dalam senario yang menghantar rakaman panggilan, panggil aircall_get_record_link() pada masa rakaman dihantar dan bukannya menggunakan pautan yang disimpan sebelum ini.
  • Jika anda perlu menyimpan rakaman secara kekal, simpan fail ke storan anda sendiri sejurus selepas panggilan.
  • Arkib rakaman kekal tersedia dalam papan pemuka Aircall, di mana rakaman boleh dimainkan dan dimuat turun kemudian.

Rakaman panggilan dikawal oleh undang-undang. Di Jerman, Perancis, Sepanyol, dan banyak negeri AS, persetujuan daripada kedua-dua pihak mungkin diperlukan, dan di sesetengah bidang kuasa, notis lisan pada permulaan panggilan juga mungkin diperlukan. Pemilik akaun Aircall bertanggungjawab untuk mematuhi undang-undang dan peraturan yang berkenaan.

Penyelesaian Masalah

Ralat Punca / Penyelesaian
Ralat kebenaran semasa membuat panggilan Pasangan API ID / API Token tidak betul. Token hanya dipaparkan sekali semasa ia dicipta. Jika ia hilang, cipta pasangan baharu di bawah API Keys dan batalkan yang lama.
Panggilan tidak dicipta atau pekerja tidak menerima panggilan Pekerja offline dalam aplikasi Aircall, sedang dalam panggilan lain, atau tidak ditugaskan ke nombor yang dipilih dalam tetapan Aircall.
"Aircall User ID tidak dinyatakan" Medan Aircall User ID dalam tetapan pekerja kosong, atau nombor telefon dimasukkan dan bukannya ID pengguna berangka.
Panggilan berfungsi, tetapi tiada panggilan balik muncul dalam perbualan Webhook tidak didaftarkan. Simpan tetapan integrasi Aircall sekali lagi untuk mendaftarkannya.
Pautan rakaman tidak dibuka Pautan telah tamat tempoh. Minta pautan baharu menggunakan aircall_get_record_link() atau buka rakaman terus dalam papan pemuka Aircall.