Mavibot'ta Aircall telefonunu kullanmak için Aircall hesabınızda bir çift API anahtarı oluşturmanız ve bunları entegrasyon ayarlarına girmeniz gerekir.

Aircall, satış ve destek ekipleri için bulut tabanlı bir telefon sistemidir ve 100'den fazla ülkede telefon numaraları sunar. Çalışanları zaten Aircall uygulamasını kullanan şirketler için tasarlanmıştır: bot, aramaları ayrı bir bot numarasından değil, bir çalışan adına yapar.

Bot, bir çalışanı bir müşteriyle bağlayabilir, arama kayıtlarını alabilir ve arama olaylarını sohbete gönderebilir.

Gerekli verileri alma

  1. aircall.io adresine kaydolun, gerekli ülkede bir telefon numarası satın alın ve çalışanlarınız için Aircall kullanıcıları oluşturun.
  2. Dashboard → Settings → Integrations & API → API Keys bölümünü açın ve bir çift anahtar oluşturun:
    • API ID
    • API Token
  3. Giden aramalar için kullanılacak numaranın Number ID değerini ve çalışanlarınızın User ID değerlerini bulun. Bu kimlikler, Aircall panelinde ilgili sayfaları açtığınızda adres çubuğunda görünür.

API Token yalnızca oluşturulduğunda bir kez gösterilir. Kaybederseniz, yeni bir API anahtarı çifti oluşturun ve eskisini iptal edin.

Bağlantı

Telefon ayarlarında Aircall seçeneğini seçin ve şunları girin:

  • API ID — API anahtarı tanımlayıcısı.
  • API Token — gizli API belirteci.
  • Number ID — giden aramalar için kullanılacak Aircall hattının sayısal kimliği.

Entegrasyon artık bağlandı.


Entegrasyonu kaldırmak için API ID alanını temizleyin ve ayarları kaydedin.

Çalışanlar

Çalışan ayarlarında, Aircall User ID alanına çalışanın Aircall hesabının sayısal kimliğini girin.

Kullanıcı kimliğini girin, çalışanın telefon numarasını değil. Bu kimlik olmadan, müşteri kartındaki arama düğmesi o çalışan için çalışmaz.

Müşteri kartından arama

Sohbet kartında müşterinin telefon numarasının yanında bir arama düğmesi görünecektir.

Aircall önce aramayı çalışanın Aircall uygulamasında — masaüstünde veya mobilde — başlatır. Çalışan cevap verdiğinde, Aircall müşteriyi arar ve her iki tarafı birbirine bağlar.

Çalışan çevrimdışıysa, başka bir aramadaysa veya Aircall'da seçili numaraya atanmamışsa arama gerçekleşmez. Bu bir Aircall sınırlamasıdır: aramalar yalnızca uygun bir kullanıcı üzerinden yapılabilir.

Hesap Makinesi Fonksiyonları

Çalışandan Müşteriye Arama

aircall_employee_call(client_phone, employee_user_id, number_id)

Parametreler:

  • client_phone — müşterinin uluslararası E.164 formatında telefon numarası. Zorunlu.
  • employee_user_id — aramayı Aircall uygulamasında alacak çalışanın Aircall Kullanıcı Kimliği. Zorunlu.
  • number_id — aramayı yapmak için kullanılan Aircall numarasının kimliği. İsteğe bağlı. Belirtilmezse, entegrasyon ayarlarında yapılandırılan numara kullanılır.

Arama Kaydı Bağlantısını Al

aircall_get_record_link(call_id)

Arama kaydına yeni bir bağlantı ister.

Parametreler:

  • call_id — Aircall arama kimliği. İsteğe bağlı. Belirtilmezse, müşterinin en son araması kullanılır.

Arama Sırasında Geri Aramalar

Arama ilerledikçe, sohbete aşağıdaki formatta geri aramalar gönderilir:

aircall_call_event call.answered

Olası olaylar:

Olay Ne zaman tetiklenir
call.created Arama oluşturuldu
call.ringing_on_agent Çalışan aramayı alıyor
call.answered Arama cevaplandı
call.hungup Taraflardan biri kapattı
call.ended Arama tamamen sona erdi
call.voicemail_left Müşteri sesli mesaj bıraktı

Tipik bir "cevap yok → mesajlaşma uygulamasında mesaj gönder" senaryosu, call.ended ile tetiklenebilir ve aircall_missed_reason değişkeni kontrol edilebilir.

Arama Sonrası Müşteri Değişkenleri

Bir aramadan sonra, müşteri için aşağıdaki değişkenler kullanılabilir:

Değişken Değer
aircall_call_id Aircall arama kimliği
aircall_call_direction Arama yönü: inbound veya outbound
aircall_call_status Arama durumu: initial, answered veya done
aircall_call_duration Arama süresi (saniye)
aircall_missed_reason Aramanın tamamlanmama nedeni
aircall_record_link Arama kaydına bağlantı

Arama Kayıtları

Aircall ayarlarınızda arama kaydı etkinleştirilmelidir. Kayıtlar Aircall hesabınızda saklanır.

⏳ Aircall kayıt bağlantıları sınırlı bir süre için kullanılabilir — genellikle aramadan sonra yalnızca birkaç saat. Bundan sonra bağlantılar çalışmayı durdurur. Bu, Aircall'ın nasıl çalıştığıdır ve bir Mavibot sınırlaması değildir.

Bunun anlamı:

  • Arama kaydı gönderen bir senaryoda, önceden kaydedilmiş bir bağlantı kullanmak yerine aircall_get_record_link() işlevini kaydın gönderildiği anda çağırın.
  • Kaydı kalıcı olarak saklamanız gerekiyorsa, dosyayı aramadan hemen sonra kendi depolama alanınıza kaydedin.
  • Kayıt arşivi, kayıtların daha sonra oynatılabildiği ve indirilebildiği Aircall panelinde kullanılabilir durumda kalır.

Arama kaydı yasalarla düzenlenir. Almanya, Fransa, İspanya ve birçok ABD eyaletinde her iki tarafın da onayı gerekebilir ve bazı yargı bölgelerinde aramanın başında sözlü bildirim de gerekli olabilir. Aircall hesap sahibi, geçerli yasa ve düzenlemelere uymaktan sorumludur.

Sorun Giderme

Hata Neden / Çözüm
Arama yapılırken yetkilendirme hatası API ID / API Token çifti hatalı. Belirteç yalnızca oluşturulduğunda bir kez gösterilir. Kaybolduysa, API Keys altında yeni bir çift oluşturun ve eskisini iptal edin.
Arama oluşturulmuyor veya çalışan aramayı almıyor Çalışan Aircall uygulamasında çevrimdışı, başka bir aramada veya Aircall ayarlarında seçili numaraya atanmamış.
"Aircall Kullanıcı Kimliği belirtilmedi" Çalışan ayarlarındaki Aircall User ID alanı boş veya sayısal kullanıcı kimliği yerine telefon numarası girilmiş.
Aramalar çalışıyor, ancak sohbette geri aramalar görünmüyor Webhook kaydedilmedi. Kaydetmek için Aircall entegrasyon ayarlarını tekrar kaydedin.
Kayıt bağlantısı açılmıyor Bağlantının süresi dolmuş. aircall_get_record_link() kullanarak yeni bir bağlantı isteyin veya kaydı doğrudan Aircall panelinde açın.