Genel bakış
Qando'yu dış sistemlerinizle üç ana yoldan bağlarsınız:
1. Dış CRM'e otomatik gönderim — Qando'da bir olay olduğunda (örn. yeni müşteri) veriyi
sizin belirlediğiniz bir dış servise iletir. Bu, klasik anlamda bir webhook (olay
tetiklemeli bildirim) yaklaşımıdır.
2. Bildirim kanalları — önemli olayları Telegram/WhatsApp üzerinden anlık iletir.
3. REST API ile veri çekme — kendi sisteminizin düzenli aralıklarla Qando'dan veri
okuması (polling).
Bu doküman bu yolları ve ne zaman hangisini seçeceğinizi özetler.
Yol 1 — Dış CRM ile olay tetiklemeli gönderim (webhook)
Qando'da müşteri/sipariş kaydı oluştuğunda veriyi dış servisinize otomatik göndermek
istiyorsanız, panel üzerinden bir Dış CRM bağlantısı tanımlarsınız:
- Panelde kod yazmadan kurulur; yalnızca hedef Servis URL ile kimlik
bilgilerini girer, hangi olaylarda gönderim yapılacağını seçersiniz.
- Qando, seçtiğiniz olaylar gerçekleştikçe bu adrese istek gönderir.
- Ayrıntılı kurulum için Dış CRM Entegrasyonu Kurma dokümanına bakın.
Ne zaman kullanılır? Kendi tarafınızda gelen isteği karşılayabilecek bir uç nokta
(endpoint) varsa ve verinin anında akmasını istiyorsanız bu yöntem idealdir.
Alıcı uç noktanız için öneriler
- İsteği aldığınızda hızlıca 2xx yanıtı dönün; ağır işleri arka planda yapın.
- Aynı olayın tekrar gelmesine karşı dayanıklı olun (idempotent işleyin) — kaydın daha
önce işlenip işlenmediğini kontrol edin.
- İşlem başarısız olursa Qando tarafında ilgili bağlantının son hata alanında bunu
görebilirsiniz; test için panelin Test Et butonunu kullanın.
Yol 2 — Bildirim kanalları
Olayları bir kişiye/ekibe anlık bildirmek yeterliyse (veri işlemek gerekmiyorsa), Telegram
en pratik yoldur. Yeni sipariş, bağlantı hatası, düşük stok gibi olaylar seçtiğiniz Telegram
sohbetine düşer. Kurulum için Bildirim Kanalları: Telegram ve WhatsApp Bağlama
dokümanına bakın.
Yol 3 — REST API ile veri çekme (polling)
Kendi sisteminiz veriyi kendisi çekmek istiyorsa, REST API'yi düzenli aralıklarla
sorgularsınız. Örneğin siparişleri periyodik olarak okumak:
```
GET /marketplace/connections/orders
Authorization: Bearer eyJ...
X-Tenant-Id: abc-123
```
Benzer şekilde ürünler (/products), stok hareketleri (/stock/movements) ve daha
fazlası okunabilir. Kimlik doğrulama ve başlıkların ayrıntısı için **Qando API'sine Giriş ve
Kimlik Doğrulama** dokümanına bakın.
Polling için öneriler
- Aşırı sık sorgulamayın; ihtiyacınıza göre makul bir aralık (örn. birkaç dakika) seçin.
- Yalnızca değişenleri almak için tarih aralığı/sayfalama parametrelerini kullanın.
- 401 yanıtında jetonu yenileyin (bkz. kimlik doğrulama dokümanı), ardından tekrar deneyin.
Hangi yolu seçmeliyim?
- Veriyi anında dışarı göndermek ve kendi uç noktanız varsa → **Dış CRM / olay
tetiklemeli gönderim**.
- Bir kişiye anlık haber vermek yeterliyse → Telegram bildirimi.
- Kendi sisteminizin veriyi kontrollü çekmesi gerekiyorsa → REST API ile polling.
Bu yollar birbirini dışlamaz; çoğu senaryoda bir kombinasyonu birlikte kullanılır.