Genel bakış ve akış
Dış sisteminizin aldığı izinleri Rıza AL'a nasıl ileteceğini ve değişikliklerden nasıl haberdar olacağını anlatan genel akış.
Son güncelleme:
Bu API ne işe yarar?
Çağrı merkezi, santral veya web formu gibi dış sisteminiz, kişilerden sözlü, SMS, WhatsApp ya da form üzerinden aldığı KVKK ve ETK (ticari elektronik ileti) kararlarını Rıza AL'a iletir. Rıza AL de kişinin izninde olan değişiklikleri size bildirir.
- Kararlar kişi kaydına ve değiştirilemez, hash'li kanıt zincirine işlenir.
- ETK kararları, şirketinizin İYS bağlantısı hazırsa ve bağlantı test modunda değilse İYS'ye iletilmek üzere sıraya alınır. KVKK kararları İYS'ye gönderilmez.
- İzin değişiklikleri (İYS, Rıza AL onay sayfası, panel veya başka bir dış bağlantı kaynaklı; özellikle RET) size webhook ile bildirilir.
- Arama veya ileti öncesinde kişinin güncel durumunu Durum ucuyla doğrulayabilirsiniz.
Akış
Adım 1: Dış sisteminiz izni bildirir
İmzalı bir
POSTisteğiyle olay (1–50 karar) gönderir.Adım 2: Rıza AL doğrular ve kaydeder
İstek doğrulanır, kişi eşlenir; karar kanıt zincirine ve izin geçmişine tek işlemde yazılır. Yanıtta her karar için
APPLIED,DUPLICATEveyaREJECTEDsonucu döner.Adım 3: ETK kararı İYS'ye iletilir
ETK kararları, işlem tamamlandıktan sonra İYS'ye iletilmek üzere sıraya alınır.
Adım 4: Değişiklikler size webhook ile bildirilir
Kişinin izni İYS'den, onay sayfasından veya panelden değişirse webhook adresinize imzalı bir olay gelir.
Adım 5: Dış sisteminiz uygular
RET geldiğinde kişiyi ilgili kanaldan arama/ileti listelerinizden çıkarmanız beklenir.
Dış sisteminiz --(1) POST /consents (imzalı)--> Rıza AL
<--(2) results: APPLIED / DUPLICATE / REJECTED --
|
(3) ETK kararı | kuyruk
v
İYS
Dış sisteminiz <--(4) webhook: consent.changed / consent.reapproval_required
(imzalı, kişisel veri içermez)Kimlik modeli
| Kavram | Anlamı |
|---|---|
clientKey | Dış sisteminizi tanımlayan istemci anahtarı; istek adresinin bir parçasıdır. Panelden oluşturduğunuz bağlantılarda değeri direct'tir. |
externalCustomerId | Dış sisteminizdeki müşteri/hesap kimliği. Rıza AL'daki şirketle bağlantı üzerinden eşlenir; istek gövdesindeki değer bağlantıdakiyle aynı olmalıdır. Panelden oluşturduğunuz bağlantılarda bu, şirketinizin kimliğidir ve panelde gösterilir. |
externalContactId | Dış sisteminizdeki kişi kimliği (opak, en çok 128 karakter). Rıza AL kişiyi telefon veya e-posta ile bulur; bu kimlik makbuza yazılır ve webhook'ta geri döner. |
| Bağlantı | (clientKey, externalCustomerId) çiftinin bir Rıza AL şirketiyle eşleşmesi. Panelden oluşturduğunuzda şirket başına tek bağlantı açılır. Her bağlantının kendi API anahtarı, webhook secret'ı ve webhook adresi vardır. Şirket kapsamı yalnızca bağlantıdan gelir; istek gövdesindeki hiçbir alan şirketi belirleyemez. |
API anahtarınızı ve bağlantınızı yönetmek için panelde Hesabım → Şirket Ayarları → API Erişimi sekmesini kullanın. Hesabım sayfasını aç (giriş yapmanız gerekir).
