Gurulize API Dökümantasyonu
Dilerseniz Gurulize ile hemen canlıya alabileceğiniz web sitesi yerine, halihazırda çalışan web sitenize veya akıllı telefon uygulamanıza Gurulize API ile entegre olabilir, mevcut sitenizden danışanlarınıza Gurulize API aracılığı ile anında telefon üzerinden veya mobile/web browser üzerinden sesli veya görüntülü danışmanlıklarınızı pazarlamaya başlayabilirsiniz.
Kayıt (Register)
Kayıt talebi sadece POST metodu ile yapılmalıdır.
Talepte bulunulacak URL müşteri ile paylaşılacaktır.
Parametreler
username: müşteriye verilen kullanıcı adı
password: müşteriye verilen parola
caller: arayan telefon numarası. Nümerik ve 5xxyyyzztt seklinde olmalı
callee: aranan telefon numarası. Nümerik ve 5xxyyyzztt seklinde olmalı
duration: konuşma için istenen saniye olarak maksimum süre. Konuşma bu süreye
ulaştığında kesilir. Numerik olmalıdır
lang: (en, tr) hata mesajlarının hangi dilde alınacağı. Sadece Türkçe ve İngilizce var,
varsayılan İngilizce
Yanıt (Response)
Cevaplar JSON formatında döner. "success"
alanında boolean olarak isteğin kaydının yapılıp yapılamadığı kontrol edilebilir. İşlem sonucu ile ilgili bir açıklama "message"
alanından görülebilir.
İstek alınırken bir problem oluşursa şunlara benzer bir cevap döner;
{
"success": false,
"message": "Eksik Parametre (username)"
}
{
"success": false,
"message": "Geçersiz Parametre (caller): Telefon numarası değil"
}
{
"success": false,
"message": "Kullanıcı Bilgileri Geçersiz"
}
İstek başarılı bir şekilde kaydedilmişse. Cevapta ayrıca, daha sonra isteğin durumu ile ilgili bilgilerin paylaşılmasında kullanılacak bir istek tanımlayıcı, "id"
alanında döner.
{
"success": true,
"message": "Talep Alındı",
"id": 2
}
Arama Talebinin Takibi
Firmanın bize bildireceği bir adrese, taleple ilgili durum değişiklikleri bildirilir. Mesela firma bize bildirim için http://www.example.com/c2cevents.jsp
adresini vermiş olsun.
Çağrı ile ilgili durumlar,
http://www.example.com/C2Cevents.jsp?id=7&code=1&desc=CALLER_CONNECTED&cause=
0&time=1427116743
şeklinde firmaya iletilir. Burada;
id: çağrı talebinde bulunulduğunda, cevap olarak gönderdiğimiz, talep tanımlayıcısı.
code: talepte belirtilen görüşme ile ilgili yeni durumun kodu
desc: durumun metin formatı olarak açıklaması
cause: olayla ilgili detay bilgi.
time: olayın gerçekleştiği zaman.
Durum Kodları
ARAYAN_BAGLANDI 1
ARANAN_BAGLANDI 2
ARAYAN_MESGUL 3
ARANAN_MESGUL 4
ARAYAN_REDDETTI 5
ARANAN_REDDETTI 6
ARAYAN_ACMADI 7
ARANAN_ACMADI 8
ARAYAN_BAGLANAMADI 9
ARANAN_BAGLANAMADI 10
ARAYAN_KAPATTI 11
ARANAN_KAPATTI 12
SURE_BITTI 13