Webhooks sayesinde Loyaltify, yeni bir müşterinin kaydolması veya bir müşterinin puan kazanması gibi bir şey olduğunda diğer sistemlerinize hemen haber verir. Loyaltify seçtiğiniz bir adrese kısa bir mesaj gönderir ve sisteminiz buna göre işlem yapabilir.

Webhook'lar bir CRM'i güncel tutmak, kendi araçlarınızda e-postaları tetiklemek veya rapor oluşturmak için kullanışlıdır. Bu rehber bir webhook'u nasıl kuracağınızı, her mesajın neler içerdiğini ve mesajların ulaşıp ulaşmadığını nasıl kontrol edeceğinizi anlatır.

💡 Bilmekte fayda var: Bu özellik Advanced planına dahildir. Alt bir plana geçerseniz çalışmayı durdurur.

Webhook kurun

1. Adım: Webhook kurulumunu açın

Entegrasyonlar bölümüne gidin ve Webhook kartındaki Bağlan düğmesine tıklayın.

2. Adım: Bilgileri doldurun

Webhook kurulumu penceresinde:

Endpoint URL: sisteminizde mesajları alması gereken https adresi.
Yetkilendirme: Bearer seçeneğini seçip kendi belirlediğiniz bir token yazın ya da Yok seçeneğini seçin.
Olaylar: istediğiniz olayları işaretleyin. En az bir tane seçmeniz gerekir.

Ardından kaydedin, webhook'unuz artık aktif.

💡 İpucu: Bearer seçeneğini ve uzun, rastgele bir token seçin. Böylece her mesaj Authorization: Bearer başlığını ve ardından token'ınızı içerir, sisteminiz de mesajın gerçekten Loyaltify'dan geldiğini kontrol edebilir. Bu token API anahtarınızdan ayrıdır.

Daha sonra değiştirin

Endpoint'i, yetkilendirmeyi ve olayları istediğiniz zaman Webhook yapılandırması sayfasından değiştirebilirsiniz. İşiniz bitince Kaydet düğmesine tıklayın.

Seçebileceğiniz olaylar

Müşteri oluşturuldu (customer.created): yeni bir müşteri kaydolur.
Müşteri güncellendi (customer.updated): bir müşterinin bilgileri düzenlenir.
İşlem oluşturuldu (transaction.created): bir müşteri başlangıç bakiyesini alır, kazanır, kullanır, referans ödülü alır ya da puanlarının süresi dolar.
Mevcut müşteri kayıt denemesi (customer.signup_attempt): kartı zaten olan biri formunuzu yeniden doldurur. Kayıtlı bilgileri yeni gönderimle değişmez.

Her mesaj neler içerir

Loyaltify her mesajı JSON olarak, Content-Type: application/json ve User-Agent: Loyaltify-Webhook/1.0 başlıklarıyla gönderir. Her mesajın üç bölümü vardır:

event: hangi olay olduğu, örneğin customer.created.
timestamp: ne zaman gerçekleştiği, UTC olarak (örneğin 2026-10-16T16:38:46Z).
data: olaya göre değişen ayrıntılar.

point ve balance_after gibi sayılar metin olarak gönderilir, örneğin "1.0", boş değerler ise null olur.

Müşteri oluşturuldu ve Müşteri güncellendi

name, email, phone ve birthday
uuid: müşterinin ID'si (kartındaki QR kodda yer alanla aynı)
point: bakiyesi (Müşteri oluşturuldu olayında başlangıç bakiyesi)
custom_fields: özel sorularınıza verilen yanıtlar, form bağlantısındaki gizli değerler dahil, örneğin click_id
is_marketing_opted_in: pazarlamaya onay verip vermediği
created_at, updated_at ve store_uuid

Müşteri güncellendi aynı alanları yeni değerlerle içerir. İşte bir Müşteri oluşturuldu örneği:

{
  "data": {
    "name": "Alex",
    "uuid": "7f3e9a21",
    "email": "[email protected]",
    "phone": null,
    "point": "1.0",
    "birthday": null,
    "created_at": "2026-10-16T16:38:41.704Z",
    "store_uuid": "a1b2c3d4",
    "updated_at": "2026-10-16T16:38:46.790Z",
    "custom_fields": {},
    "is_marketing_opted_in": true
  },
  "event": "customer.created",
  "timestamp": "2026-10-16T16:38:46Z"
}

İşlem oluşturuldu

kind: işlemin türü, örneğin initial (kayıttaki başlangıç bakiyesi), manual, redeem, expired, referee veya referrer
point ve amount: işlemin değerleri. Süresi dolan puanlarda point negatiftir.
balance_after: işlemden sonraki müşteri bakiyesi
campaign: kullanımlarda, kullanılan kampanya
user: taramayı yapan takım üyesi (adı, ID'si ve e-postası) ya da süre dolması gibi otomatik olaylarda null
customer_uuid, customer_email ve customer_phone
referred_by_uuid: referans ödüllerinde, müşteriyi kimin yönlendirdiği
uuid: işlemin kendi ID'si
created_at ve store_uuid

İşte bir takım üyesinin puan eklediği bir örnek:

{
  "data": {
    "kind": "manual",
    "user": {
      "name": "Sam Taylor",
      "uuid": "0b8e7d4c-1f2a-4c3b-9d5e-6a7b8c9d0e1f",
      "email": "[email protected]"
    },
    "uuid": "5c9d2e7a-3b4f-4a1c-8e6d-2f7a9b0c1d3e",
    "point": "1.0",
    "amount": null,
    "campaign": null,
    "created_at": "2026-10-16T16:45:10.375Z",
    "store_uuid": "a1b2c3d4",
    "balance_after": "2.0",
    "customer_uuid": "7f3e9a21",
    "customer_email": "[email protected]",
    "customer_phone": null,
    "referred_by_uuid": null
  },
  "event": "transaction.created",
  "timestamp": "2026-10-16T16:45:10Z"
}

Bir referans ödülü aynı anda iki işlem gönderir: yeni müşteri için referee (referred_by_uuid alanında yönlendiren kişinin ID'si yer alır) ve onu yönlendiren müşteri için referrer.

Mevcut müşteri kayıt denemesi

customer: mevcut müşterinin kim olduğu, uuid ve custom_fields bilgileriyle
matched_on: nasıl tanındığı, örneğin e-posta ile
submission: forma az önce girdiği bilgiler
form: hangi formu kullandığı

Mesajın tamamını görmek için Son olaylar bölümünde herhangi bir gönderimi açın (aşağıya bakın).

Gönderimlerinizi kontrol edin

Webhook yapılandırması sayfası, Son olaylar listesini durumları, yanıt kodları, deneme sayıları ve tarihleriyle gösterir. Tam olarak neyin gönderildiğini, başlıkları ve sisteminizin yanıtını görmek için göz simgesine tıklayın.

Mesajlar ulaşmıyor mu?

Endpoint URL alanının geçerli bir https adresi olduğunu kontrol edin. Tarayıcılar bazen bu alana otomatik olarak bir e-posta adresi doldurur.
Olayın Webhook yapılandırması sayfasında işaretli olduğunu kontrol edin.
Advanced planında olduğunuzu kontrol edin.
Son olaylar bölümünde olaya bakın. Yanıt kodu bir hata gösteriyorsa sisteminiz mesajı almış ama reddetmiştir, göz simgesi de sisteminizin yanıtını gösterir.

Hâlâ sorun mu var? canlı sohbet üzerinden destek ekibiyle iletişime geçin.

Bilmekte fayda var

Mesajlar sırayla gelmeyebilir, bu yüzden sıra önemliyse zaman damgasını kullanın.
Sisteminizi aynı olayı iki kez işleyebilecek şekilde kurun, her ihtimale karşı. İşlemlerde uuid değeri (data içinde) her işlem için benzersizdir.
API ile mi çalışıyorsunuz? Webhook'lar müşterinin kısa ID'sini gönderir. Bazı API istekleri bunun yerine müşterinin dahili numarasını gerektirir ve API dokümantasyonu birinden diğerini nasıl bulacağınızı gösterir.
Omnisend mi kullanıyorsunuz? Omnisend'in kendi rehberi, Loyaltify'a bağlanmak için bir webhook kullanır. Bağlantı için Entegrasyonlara genel bakış makalesine göz atın.

Yardıma mı ihtiyacınız var?

Size yardımcı olmak için buradayız!

Webhook'larla ilgili sorularınız olursa Loyaltify içindeki canlı sohbet üzerinden bize yazın ya da bu sayfanın sağ alt köşesindeki sohbet düğmesini kullanın. Ekibimiz size seve seve yardımcı olur.