API ve webhook

Kendi yazılımınız panele bağlansın

CRM'inizden arama başlatın, çağrı geçmişini çekin, WhatsApp ya da Telegram ile doğrulama kodu gönderin. Anket ve sohbet akışı cevapları da webhook ile sisteminize gelsin.

Tek anahtar çifti: santral, doğrulama kodu ve randevu uçları
Her istek HMAC-SHA256 ile imzalanır
Anahtarı istediğiniz an yenileyin ya da kapatın
API anahtarları ekranı: açık kimlikler, bir kez gösterilen gizli anahtar ve uç listesi; yanında imzalı bir arama başlatma isteği ve yanıtı
Santral ve randevu verisi sizin sisteminizde
UÇLAR

Santral ve randevu verisi sizin sisteminizde

Anahtar ve imza her uçta aynı. Yanıtlar JSON; eksik ya da hatalı alan 422 ve errors nesnesiyle döner.

Arama başlatın

Müşteri kartınızdan bir dahiliye arama açtırın; kendi kayıt kimliğinizi reference olarak verin, çağrı listesinde geri gelsin.

Çağrıları çekin

Tarih, numara ve yön süzgeciyle çağrı listesi. Görüşme özeti açıksa tek çağrıda özet, duygu ve konular da gelir.

Randevu gönderin

Gerçekleşen randevuları tek istekte 500'e kadar gönderin; müşteriye memnuniyet anketi daveti gider.

Bağlantıyı sınayın

Ping ucu anahtarı ve imzayı sınar; yanıtta firma adınız ve sunucu saati döner.

Doğrulama kodunu WhatsApp ya da Telegram'dan gönderin
DOĞRULAMA KODU

Doğrulama kodunu WhatsApp ya da Telegram'dan gönderin

Kodu sizin sisteminiz üretir, KuleConnect iletir; doğru girilip girilmediğini de kendi tarafınızda denetlersiniz.

1

Hazırlayın

WhatsApp'ta Doğrulama kategorisinde şablon açıp Meta onayına gönderin; Telegram için Gateway jetonunu Entegrasyonlar'a girin.

2

İsteği gönderin

Telefon ve kodla /v1/whatsapp/otp ya da /v1/telegram/otp. Telegram'da kodun geçerlilik süresini de verebilirsiniz.

3

Yedek yola geçin

Numaranın Telegram hesabı yoksa yanıt bunu söyler; aynı kodu WhatsApp ile gönderirsiniz.

WEBHOOK

Cevap gelince sisteminize haber gitsin

Webhook, KuleConnect'te toplanan cevabı sizin adresinize POST eder. Gelen isteği API'deki imza yöntemiyle doğrularsınız.

WhatsApp ya da Telegram akışına "Dış sisteme gönder (webhook)" adımı ekleyin; toplanan cevaplar adresinize gider. Yanıtta döndürdüğünüz değişkenler sonraki adımlarda kullanılır.

Müşteri anketi doldurunca cevaplar geri bildirim adresinize gelir. Adres yanıt vermezse 1, 5, 30, 120 ve 720 dakika sonra yeniden denenir.

Her anket bildirimi bir olay kimliği taşır; aynı kimliği ikinci kez işlemeyin.

Cevap gelince sisteminize haber gitsin
GÜVENLİK

Her istek imzalı, her anahtar sizin elinizde

İstek; açık kimlik, zaman damgası ve gizli anahtarla hesaplanan HMAC-SHA256 imzası taşır. Gizli anahtar yalnız üretildiği anda bir kez gösterilir.

5 dakikadan eski zaman damgası reddedilir

Dakikalık sınır: santral ve kod uçlarında 120, randevu uçlarında 60

Anahtarı yenileyince eski gizli anahtar o an çalışmaz

Test modunda arama ve kod gerçekten gönderilmez

Her istek imzalı, her anahtar sizin elinizde

Sık sorulanlar

API Anahtarları sayfası bir modüle bağlı değildir; anahtar almak için firma ayarlarını düzenleme yetkisi yeter. Santral uçları için paketinizde Santral modülü olmalıdır.

KuleConnect'te SMS ile kod gönderen bir API ucu henüz yok; WhatsApp ve Telegram uçlarını kullanırsınız.

Hayır. Kodu sizin sisteminiz üretir ve doğrular; KuleConnect yalnız iletir.

Anahtarın kartındaki Anahtarı yenile ile yenisini üretin. Eski gizli anahtar o an çalışmaz olur, açık kimlik aynı kalır.

Henüz değil. Bugün webhook anket sonuçlarında ve sohbet akışı adımında çalışır.

Hepsi tek panelde

SMS, e-posta, WhatsApp, santral ve mağazanız aynı yerde. Kurulum ücreti yok, deneme süresinde kredi kartı istemiyoruz.