Ana içeriğe geç

Odoo Gelen Çağrı Popup'ı

Sanal Santral Call Popup modülü, santralinize gelen bir çağrı çalmaya başladığı anda, çağrının çaldığı kullanıcının Odoo ekranında bir pencere açar. Pencerede arayan numarayla eşleşen aday ya da kontak ve (Helpdesk kuruluysa) son destek talebi görünür; kullanıcı tek tıkla ilgili kayda geçer.

Gereksinimler​

  • Odoo 17, 18 veya 19 (Community veya Enterprise)
  • CRM uygulaması
  • auth_api_key modülü (santralden gelen bildirimleri doğrulamak için; zip dosyasıyla birlikte gelir)
  • Santralin ulaşabileceği, internete açık bir Odoo adresi (HTTPS önerilir)
  • İsteğe bağlı: Helpdesk uygulaması. Kuruluysa arayanın son destek talebi de gösterilir; kurulu değilse bu bölüm atlanır.

Kurulum​

Modül, Odoo sürümünüze (17, 18 veya 19) göre hazırlanmış bir zip dosyası olarak paylaşılır. Zip dosyasında sanalsantral_call_popup ile birlikte gerekli auth_api_key modülü de bulunur; başka bir yerden modül indirmeniz gerekmez.

1. Zip dosyasını açın ve içindeki sanalsantral_call_popup ve auth_api_key klasörlerini Odoo addons yolunuza kopyalayın.

2. Odoo servisini yeniden başlatın.

3. Odoo'da geliştirici modunu açın ve Uygulamalar → Uygulama Listesini Güncelle adımından sonra Sanal Santral Call Popup modülünü kurun. auth_api_key bağımlılık olarak birlikte kurulur.

API Anahtarı Oluşturma​

Santralin Odoo'ya gönderdiği bildirimler bir API anahtarıyla doğrulanır.

1. Geliştirici modunu açın ve Ayarlar → Teknik → Auth Api Key menüsüne gidin.

2. Yeni bir kayıt oluşturun: bir ad verin, kullanıcı olarak aktif bir Odoo kullanıcısı seçin ve anahtar (Key) alanına uzun, tahmin edilemez bir değer yazın.

3. Kaydedin. Bu değeri bir sonraki adımlarda santral adresine ekleyeceksiniz.

Anahtarın bağlı olduğu kullanıcı pasifleştirilirse bildirimler reddedilir.

Kullanıcılara Dahili Numara Tanımlama​

Popup, çağrının çaldığı dahiliyle eşleşen kullanıcıya gösterilir. Ayarlar → Kullanıcılar bölümünde her kullanıcının formunda, giriş e-postasının altındaki Dahili Numara alanına santraldeki dahili numarasını yazın (örneğin 1000).

Odoo VoIP modülü kuruluysa ve kullanıcının Dahili Numara alanı boşsa, kullanıcının VoIP kullanıcı adı da eşleştirmede denenir (1000, 1000-... veya 1000_... biçimleri).

Santralde URL Kancası Tanımlama​

Sanal Santral müşteri panelinizde URL Kancası bölümünden ilgili santral için aşağıdaki adresi ekleyin. odoo.firmaniz.com yerine kendi Odoo adresinizi, ANAHTARINIZ yerine oluşturduğunuz API anahtarını yazın.

https://odoo.firmaniz.com/api/call/popup?api_key=ANAHTARINIZ

Odoo yalnızca gelen ve çalan (ringing) çağrı bildirimlerini işler; diğer bildirimler yanıtlanır ama yok sayılır.

Kullanım​

Kullanıcının Odoo'su tarayıcıda açık olduğu sürece, kendisine gelen bir çağrı çalmaya başladığında ekranında bir pencere açılır. Pencerede şunlar yer alır:

Bölümİçerik
ArayanArayan numara.
AdayNumarayla eşleşen en yeni aday: adı, firma adı, aşaması, temsilcisi ve oluşturulma tarihi.
KontakAday bulunamazsa eşleşen kontak: adı, firması, telefonu ve e-postası.
Son TicketHelpdesk kuruluysa arayanın en yeni destek talebi: başlığı, aşaması, temsilcisi ve tarihi.

Hiçbir kayıt bulunamazsa pencerede "Bu numara ile eşleşen aday veya kontak bulunamadı." uyarısı görünür. Kartlara ya da alttaki Adayı Aç, Kontağı Aç ve Ticket'ı Aç butonlarına tıklayarak ilgili kaydı açabilirsiniz. Aynı çağrı için 60 saniye içinde gelen tekrar bildirimler yeni pencere açmaz.

Numara eşleştirme: Numaranın son 10 hanesi karşılaştırılır; boşluk, +, parantez ve tire yok sayılır. Örneğin kontakta +90 544 964 08 80 olarak kayıtlı numara, santralden 05449640880 olarak gelen çağrıyla eşleşir. Kontak ve adaylarda Telefon ve Mobil alanlarına bakılır (Odoo 19'da yalnızca Telefon). Kontak bulunursa, o kontağa bağlı ya da aynı numaralı en yeni aday gösterilir.

Bağlantıyı Test Etme​

Santralden çağrı beklemeden aşağıdaki istekle popup'ı deneyebilirsiniz. aranan değerine, Dahili Numara tanımladığınız bir kullanıcının dahilisini yazın; o kullanıcının ekranında popup açılmalıdır.

curl -X POST "https://odoo.firmaniz.com/api/call/popup?api_key=ANAHTARINIZ" \
-H "Content-Type: application/json" \
-d '{"arayan": "05321234567", "aranan": "1000", "tipi": "gelen", "olay": "ringing", "uniqueid": "1718000000.123"}'

Bildirimde kullanılan alanlar:

AlanAçıklama
arayanZorunlu. Arayan numara.
arananZorunlu. Çağrının çaldığı dahili.
tipiZorunlu. Yalnızca gelen işlenir.
olayZorunlu. Yalnızca ringing işlenir.
extensionİsteğe bağlı. aranan ile kullanıcı bulunamazsa bu dahili denenir.
uniqueid, linkedidİsteğe bağlı. Çağrı kimlikleri; aynı çağrı için tekrar eden bildirimleri ayırt etmekte kullanılır.
santralIdİsteğe bağlı. Santral kimliği.

Başarılı bir istekte yanıtın message alanı Popup bildirimi gonderildi olur ve eşleşen kullanıcı, aday, kontak ve ticket kimlikleri döner.

Sık Karşılaşılan Sorunlar​

Yanıt "Eslesen kullanici bulunamadi" dönüyor. Hiçbir kullanıcının Dahili Numara alanı bildirimdeki aranan değeriyle aynı değil. Kullanıcı formundaki dahiliyi santraldekiyle birebir aynı yazın.

Yanıt 401 dönüyor. Adresteki api_key eksik ya da Auth Api Key kaydındaki değerle aynı değil, veya anahtarın bağlı olduğu kullanıcı pasif.

Yanıt başarılı ama popup açılmıyor. Kullanıcının Odoo'su tarayıcıda ve oturumu açık olmalı; sayfayı yenileyip tekrar deneyin. Aynı uniqueid ile 60 saniye içinde tekrar denerseniz pencere açılmaz, farklı bir değer kullanın.

Kayıt varken "eşleşen aday veya kontak bulunamadı" görünüyor. Numaranın kontakta ya da adayda Telefon veya Mobil alanında kayıtlı olduğundan ve son 10 hanesinin aynı olduğundan emin olun.