Hızlı arama nedir ve nasıl yapılır?

Hipcall hızlı arama aranacak numarayı 3. parti bir servise sorup onu arayan servistir. Hızlı arama yapan kullanıcı aradığı kişinin numarasını bilmesine gerek yoktur.

NOT: Bu özellik henüz yapım aşamasıdadır. Önerilerini lütfen destek@bulutfon.com adresine gönderiniz.

Hipcall hızlı arama özelliği, kullanıcının arayama yapacağı telefon numarasını bir webservise sormasıyla yaptığı aramadır. Örneğin bir kurye bir sipariş sahibi arayacak ancak KVKK kapsamında onun numarasını bilmemesi gerekiyor. Bu durumda hızlı arama servisini arayıp, sipariş numarasını tuşlayarak sipariş sahibini arayabilir.

Gereklilikler

  • Hızlı arama özelliğinin kullanabilmeniz için Hipcall paketinizde API özelliğini bulunması gerekmektedir.
  • Ayrıca hızlı arama ayarları için aşağıdaki üç alana ihtiyaç duyacaksınız
    • Kullanıcıya tuşlama anında okunacak anons. Örneğin: "Lütfen sipariş numarasını tuşlayın."
    • Hızlı arama iç hat numarası (10'dan 9999'a kadar olan bir numara)
    • Webservis URL'si (zorunlu alan)
    • Webservis için kimlik doğrulama varsa webservise kullanıcı adı ve webservice parola

Çalışma mantığı

  • Kullanıcı hızlı aramanın iç hat numarasını tuşlar. Örneğin 72.
  • Sistem kullanıcıya yüklenen ses dosyasını okur. Örneğin "Lütfen sipariş numarasını tuşlayın."
  • Kullanıcı ses dosyasını dinlerken sipariş numarasını tuşlar. Örneğin 12345.
  • Sistem ilgili bilgileri HTTP POST yöntemiyle servise gönderir.
{
  "number": "+908508850000",
  "user_id": 1,
  "uuid": "564aff1e-2141-4925-9c2e-b7dd28b87c16",
  "code":  12345,
  "timestamp": 1719843672,
}
  • Ayrıca HTTP Basic Auth aktif ettiyseniz gönderilen formun header kısmında gerekli basic authentication parametreleri eklenecektir.
  • Bu POST isteğine cevap olarak Bulutfon sistemi bizden aranacak hedef numarayı ister. Aşağıki gibi alan kodu ile birlikte telefon numarasını içeren json yanıt işimizi görecektir:
{ "destination" : "90532XXXXXX" }
  • Kullanıcıya "Numarayı arayıp, sizlere bağlıyorum." anonsu dinletilir.
  • Numara aranır.

Başarısız olma durumları

Eğer webservis ile her hangi bir nedenden başarısız bir iletişim kurulursa, sistem kullanıcıya başarız olduğunu belirten bir anons okur ve görüşmeyi kapatır.

Başarısız iletişimden kast edilen nedir?

  • Gelen cevabın HTTP kodu 200 değilse
  • HTTP isteği 3 saniye içinde cevaplanmaz ise
  • Webservisteki BASIC AUTH kullanıcı adı, kullanıcı şifresi yanlış ise
  • Gelen JSON formatı yanlış ise
  • Gelen JSON formatının içindeki destination numarası aranabilir bir numara değilse, Örneğin 3ASDASDF

Teknik destek

Firmamız üçüncü parti yazılımlara teknik destek vermemektir. Bunun yerine Türkçe veya İngilizce olarak topluluktaki geliştiricilere sorularını iletebilirsiniz.