Kullanıcı Ekleme Webhook'u (Users Webhook)

Kendi web sitenizi Mailinu'ya bağlayarak, sitenize üye olan / form dolduran kişileri anında ve güvenli şekilde alıcı listenize ekleyebilirsiniz. Her yeni kayıt geldiğinde adres arka planda doğrulanır, tekrarlar tekilleştirilir ve seçtiğiniz kampanyalara eklenir.

1. Nasıl Çalışır?

Sitenizin sunucusu, her yeni kişi için bize tek bir istek gönderir. İsteği alınca kaydı doğrulama kuyruğuna alırız; geçerliyse listenizde görünür, geçersizse hata listesinde kalır.

2. Kurulum

• Kullanıcılar → Webhook ekranını açın.
• Hedef proje ve kampanya(lar)ı seçin.
• İsteğe bağlı: gelen kayıtta dil yoksa uygulanacak varsayılan dil ve İYS onaylarını kabul et seçeneği.
• Aktifleştir deyin; size özel bir URL ve gizli anahtar (secret) verilir.

🔒 Secret gizlidir; yalnızca sunucunuzda saklayın, tarayıcıya/istemciye koymayın. Sızarsa Secret'i Yenile ile tek tıkla değiştirin (URL değişmez).

3. İstek (Örnek)

Her yeni kişi için sunucunuzdan şu isteği gönderin:

curl -X POST "https://api-customer.mailinu.com/app/user/webhook/<WEBHOOK_ID>/users" \
  -H "Authorization: Bearer <SECRET>" \
  -H "Content-Type: application/json" \
  -d '{"name":"Ali","surname":"Veli","email":"ali@ornek.com","lang":"tr"}'

Alanlar: email (zorunlu), name, surname, lang (dil kodu ya da adı; boş olabilir). İYS kabulü açıksa iys_email, iys_sms, iys_arama (true/false) da gönderebilirsiniz.

4. Yanıtlar

• 202 queued — kayıt alındı, doğrulanıyor.
• 200 duplicate — bu e-posta ilgili kampanyalarda zaten var.
• 400 — geçersiz e-posta veya eksik yapılandırma.
• 401 — secret hatalı · 403 — webhook kapalı · 429 — hız limiti (kısa süre sonra tekrar deneyin).

5. Güvenlik ve Limitler

• Tüm istekler HTTPS üzerinden ve secret ile kimliklenir.
• Hız limiti müşteri başınadır (varsayılan dakikada 60 istek); ayarlardan artırabilirsiniz.
• Kayıtlar tek tek gönderilir (her kişi ayrı istek). Büyük listeler için CSV ile toplu yüklemeyi kullanın.

💡 Gelen adresler de normal doğrulamadan geçer; geçersiz/riskli adresler eklenmez, listenizin kalitesi korunur. İYS yükümlülükleri size aittir — yalnızca onay verdiğiniz kişilere gönderim yapın.