İçeriğe geç

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ış

  1. Adım 1: Dış sisteminiz izni bildirir

    İmzalı bir POST isteğiyle olay (1–50 karar) gönderir.

  2. 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, DUPLICATE veya REJECTED sonucu döner.

  3. Adım 3: ETK kararı İYS'ye iletilir

    ETK kararları, işlem tamamlandıktan sonra İYS'ye iletilmek üzere sıraya alınır.

  4. 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.

  5. Adım 5: Dış sisteminiz uygular

    RET geldiğinde kişiyi ilgili kanaldan arama/ileti listelerinizden çıkarmanız beklenir.

Akış şemasıtext
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

Kavramlar
KavramAnlamı
clientKeyDış sisteminizi tanımlayan istemci anahtarı; istek adresinin bir parçasıdır. Panelden oluşturduğunuz bağlantılarda değeri direct'tir.
externalCustomerIdDış 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.
externalContactIdDış 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).