Ana içeriğe atla
Bireylere veya küçük gruplara zamanında ve kişiselleştirilmiş mesajlar göndermek, güçlü bir müşteri deneyimi sunmak ve etkileşimi sürdürmek için kritik öneme sahiptir. Tek Kullanımlık Şifreler (OTP’ler), fatura güncellemeleri veya etkinlik onayları gibi işlemsel mesajlar, sunucunuzdan anlamlı, gerçek zamanlı güncellemeler paylaşmanıza olanak tanır. Bu kılavuz, özel veri ve kullanıcı tanımlayıcıları kullanarak OneSignal’in API’si ile işlemsel mesajların (push, e-posta veya SMS) nasıl gönderileceğini açıklar.

​
Yaygın kullanım senaryoları

İşlemsel mesajları şunlar için kullanın:
  • Giriş ve doğrulama kodları gönderin (OTP)
  • Siparişleri, makbuzları veya abonelik değişikliklerini onaylayın
  • Fatura durumu veya yenileme uyarıları gönderin
  • Kullanıcılara randevular veya son tarihler hakkında hatırlatın
  • Önemli eylemleri onaylayın (örneğin kayıtlar veya satın almalar)

​
Gereksinimler

İşlemsel mesajlar göndermeden önce aşağıdaki kılavuzları incelemenizi öneririz:

​
Kullanıcıları tanımlama

Bireysel kullanıcıları hedeflemek için onları OneSignal içinde tanımlamanız gerekir. Önerilen yaklaşım, veritabanınızda veya CRM’nizde kullanılan kullanıcı tanımlayıcısıyla eşleşmesi gereken bir External ID ayarlamaktır. OneSignal ayrıca kullanıcı başına 20 takma ada kadar destek verir, bu da sistemleriniz genelinde birden fazla tanımlayıcıyı (other_user_id, facebook_id, vb.) ilişkilendirmenizi sağlar. E-posta ve SMS için, sırasıyla e-posta adresini veya telefon numarasını kullanarak doğrudan mesaj da gönderebilirsiniz.

​
Kullanıcıları hedefleme

Takma adlar, e-posta adresleri, telefon numaraları veya abonelik ID’leri aracılığıyla kullanıcıları hedefleyerek push, e-posta ve SMS kanalları genelinde işlemsel mesajlar göndermek için Mesaj Oluştur API’sini kullanın.

​
Takma adlara gönderme (önerilir)

Önerilen external_id veya diğer takma adları hedeflemek için include_aliases kullanın: 
{
  "app_id": "YOUR_APP_ID",
  "include_aliases": {"external_id": ["userA", "userB"]},
  "contents": {"en": "English Message"},
  "target_channel": "push"
}

​
Aboneliklere gönderme

Belirli Aboneliklere göndermek istiyorsanız include_subscription_ids özelliğini kullanabilirsiniz. Kullanıcıların birden fazla Aboneliği olabileceği için bu seçenek önerilmez. 
{
  "app_id": "YOUR_APP_ID",
  "include_subscription_ids": ["1dd608f2-c6a1-11e3-851d-000c2940e62c"],
  "contents": { "en": "English Message" }
}

​
E-posta adreslerine gönderme

Kullanıcının e-posta adresine sahipseniz include_email_tokens özelliğini kullanarak onlara e-posta gönderebilirsiniz. OneSignal uygulamanızda mevcut olmayan dahil edilen tüm e-postalar otomatik olarak yeni bir e-posta aboneliği oluşturacaktır. 
{
  "app_id": "YOUR_APP_ID",
  "include_email_tokens": ["user1@email.com", "user2@email.com"],
  "email_subject": "Welcome to Cat Facts!",
  "email_body": "<html><head>Welcome to Cat Facts</head><body><h1>Welcome to Cat Facts</h1><h4>Learn more about everyone's favorite furry companions!</h4><hr/><p>Hi Nick,</p><p>Thanks for subscribing to Cat Facts! We can't wait to surprise you with funny details about your favorite animal.</p><h5>Today's Cat Fact (March 27)</h5><p>In tigers and tabbies, the middle of the tongue is covered in backward-pointing spines, used for breaking off and gripping meat.</p><a href='https://catfac.ts/welcome'>Show me more Cat Facts</a><hr/><p><small>(c) 2018 Cat Facts, inc</small></p><p><small><a href='[unsubscribe_url]'>Unsubscribe</a></small></p></body></html>"
}

​
Telefon numaralarına gönderme

Kullanıcının telefon numarasına sahipseniz include_phone_numbers özelliğini kullanarak onlara SMS ve MMS gönderebilirsiniz. OneSignal uygulamanızda mevcut olmayan dahil edilen tüm telefon numaraları otomatik olarak yeni bir SMS aboneliği oluşturacaktır. 
{
  "app_id": "YOUR_APP_ID",
  "include_phone_numbers": ["+15555555555"],
  "contents": { "en": "English Message" }
}

​
Özel veri ekleme

Kişiselleştirilmiş içerik için Şablonları ve Liquid sözdizimini kullanarak mesaja kullanıcıya özel custom_data aktarın. Özel veri ekleme adımları:
  1. Pano aracılığıyla veya Şablon oluştur API’si ile bir Şablon oluşturun.
  2. Şablonunuza Liquid Değişkenleri ekleyin (örneğin, {{ message.custom_data.order_id }}).
  3. Mesaj Oluştur API çağrınızda template_id ve custom_data referansı verin.
{
  "app_id": "YOUR_APP_ID",
  "include_aliases": { "external_id": ["userA"] },
  "template_id": "8458af75-4da2-4ecf-afb5-f242a8926cc3",
  "custom_data": { "order_id": 123, "currency": "USD", "amount": 25 }
}

​
Örnek: Tek Kullanımlık Şifre (OTP)

  1. Takma ad, e-posta veya telefon numarası kullanarak kullanıcıyı tanımlayın.
  2. Doğrulama kodu içeren bir Şablon oluşturun:
Doğrulama kodunuz {{ message.custom_data.verification_code }}
  1. Kullanıcı erişim istediğinde sunucunuzda verification_code oluşturun.
  2. verification_code değerini API isteğine girin.
{
  "app_id": "YOUR_APP_ID",
  "include_aliases": { "external_id": ["userA"] },
  "template_id": "8458af75-4da2-4ecf-afb5-f242a8926cc3",
  "custom_data": { "verification_code": "123456" }
}
Alternatif: Şablonları ve custom_data kullanmak istemiyorsanız, dize birleştirme ile değişken değerini doğrudan mesaja girebilirsiniz. Örneğin: 
{
  "app_id": "YOUR_APP_ID",
  "include_aliases": {"external_id": ["userA"]},
  "contents": {"en": "Your verification code is " + verification_code}
}

​
Sorun giderme

  • include_aliases için, takma ad önceden kullanıcıda kayıtlı olmalıdır.
  • E-posta/SMS için doğru biçimlendirmeyi sağlayın.

​
Ek Kaynaklar