> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# İşlemsel mesajlar

> OneSignal'in API'sini kullanarak push, e-posta veya SMS aracılığıyla kişiselleştirilmiş verilerle OTP'ler, fatura güncellemeleri ve hatırlatıcılar gibi işlemsel mesajların nasıl gönderileceğini öğrenin.

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:

* OneSignal [Kullanıcıları](./users), [Abonelikleri](./subscriptions) ve [Takma Adları](./aliases) anlayın.
* [Veritabanınızı, DMP'nizi veya CRM'nizi OneSignal ile iletişim kuracak şekilde ayarlayın](./database-dmp-crm-integration) veya [Entegrasyonlarımızdan](./integrations) birini kullanın.
* Mesajlarınızı kişiselleştirmek için [Şablonlar](./templates) oluşturun.
* Mesajlarınızı kişiselleştirmek için [Liquid Sözdizimi](./using-liquid-syntax) kullanın.

***

## 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](/reference/create-message) kullanın.

### Takma adlara gönderme (önerilir)

Önerilen `external_id` veya diğer takma adları hedeflemek için `include_aliases` kullanın:

<CodeGroup>
  ```json external_id theme={null}
  {
    "app_id": "YOUR_APP_ID",
    "include_aliases": {"external_id": ["userA", "userB"]},
    "contents": {"en": "English Message"},
    "target_channel": "push"
  }
  ```

  ```json custom_alias theme={null}
  {
    "app_id": "YOUR_APP_ID",
    "include_aliases": { "alias_label": ["alias_id_1", "alias_id_2"] },
    "contents": { "en": "English Message" },
    "target_channel": "email"
  }
  ```
</CodeGroup>

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

```json theme={null}
{
  "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.

```json theme={null}
{
  "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.

```json theme={null}
{
  "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](/reference/create-template) ile bir [Şablon](./templates) oluşturun.
2. Şablonunuza [Liquid Değişkenleri](./using-liquid-syntax) ekleyin (örneğin, `{{ message.custom_data.order_id }}`).
3. Mesaj Oluştur API çağrınızda `template_id` ve `custom_data` referansı verin.

```json theme={null}
{
  "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 }}
```

3. Kullanıcı erişim istediğinde sunucunuzda `verification_code` oluşturun.
4. `verification_code` değerini API isteğine girin.

```json theme={null}
{
  "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:

```json theme={null}
{
  "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

* [Mesaj oluşturma kılavuzu](/reference/create-message)
* [Kullanıcılar](./users) ve [Takma Adlar](./aliases)
* [Şablonlar](./templates) ve [Liquid Sözdizimi](./using-liquid-syntax)
* [Hız Limitleri](/reference/rate-limits)

***