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

# SendGrid Kurulumu

> E-posta teslimatı için SendGrid'i OneSignal ile entegre edin.

# Gereksinimler

* [SendGrid Hesabı](https://www.sendgrid.com)
* [OneSignal Hesabı](https://onesignal.com)

# Kurulum

## 1. SendGrid Gönderen Kimlik Doğrulaması

SendGrid'in "Domain Authentication" özelliğini kullanmanız önerilir, böylece SendGrid e-postaları `via sendgrid.net` yerine alan adınız üzerinden gönderir ve kullanıcılarınızın tıkladığı bağlantılar alan adınızdan geliyor olarak görünür.

**Önerilir**: SendGrid'in [Domain authentication nasıl kurulur](https://docs.sendgrid.com/ui/account-and-settings/how-to-set-up-domain-authentication) kılavuzunu takip edin.

SendGrid ayrıca alan adınız yoksa [Single Sender Verification](https://docs.sendgrid.com/ui/sending-email/sender-verification) sağlar.

## 2. DNS Kayıtlarını Yükleyin

**Domain Authentication** seçtiyseniz, DNS Kayıtlarınızın doğrulandığından emin olun.

<Frame caption="SendGrid DNS doğrulama durumu">
  <img src="https://mintcdn.com/onesignal/_KaXe4GQkxsEfa17/images/docs/3ceb5db-Screen_Shot_2021-10-20_at_1.18.12_PM.png?fit=max&auto=format&n=_KaXe4GQkxsEfa17&q=85&s=9cbb18e747d85c69d73e272e3c2e23d5" width="1402" height="872" data-path="images/docs/3ceb5db-Screen_Shot_2021-10-20_at_1.18.12_PM.png" />
</Frame>

SPF, DKIM ve MX kayıtları SendGrid'in kurulum sihirbazı aracılığıyla otomatik olarak yapılandırılmalıdır.

<Frame caption="SendGrid alan adı kimlik doğrulama kurulumu">
  <img src="https://mintcdn.com/onesignal/YOTSrtBSoqdrJ37A/images/docs/41879e3-esp-sendgrid-domain-3.jpg?fit=max&auto=format&n=YOTSrtBSoqdrJ37A&q=85&s=deaeacb61d563fb01079199a4a1373be" width="2500" height="1600" data-path="images/docs/41879e3-esp-sendgrid-domain-3.jpg" />
</Frame>

## 3. API Anahtarı Oluşturun

SendGrid dashboard'da, [Settings -> API Keys](https://app.sendgrid.com/settings/api_keys)'e gidin ve 'Create API Key'e tıklayın.

<Frame caption="SendGrid API key oluşturma ekranı">
  <img src="https://mintcdn.com/onesignal/KSCNwSpBCNSQ8xdF/images/docs/f794466-esp-sendgrid-apikey.jpg?fit=max&auto=format&n=KSCNwSpBCNSQ8xdF&q=85&s=58f82278dd1461db66aedf9123723b50" width="2500" height="1270" data-path="images/docs/f794466-esp-sendgrid-apikey.jpg" />
</Frame>

API anahtarınızı `OneSignal API Key` gibi bir şey olarak adlandırın ve izinleri **Full Access** olarak ayarladığınızdan emin olun. Hazır olduğunuzda 'Create & View'a tıklayın.

<Frame caption="SendGrid API key izin ayarları">
  <img src="https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/afe1836-esp-sendgrid-apikey-2.jpg?fit=max&auto=format&n=RWtLFPeffHrC81wI&q=85&s=c2647bf1992dc79b00974c453a8ffb00" width="2500" height="1350" data-path="images/docs/afe1836-esp-sendgrid-apikey-2.jpg" />
</Frame>

Ardından, panonuza kopyalamak için API anahtarına tıklayın.

<Frame caption="SendGrid API key kopyalama">
  <img src="https://mintcdn.com/onesignal/56ctKxZSV4m5VEkn/images/docs/b8a9822-esp-sendgrid-apikey-3.jpg?fit=max&auto=format&n=56ctKxZSV4m5VEkn&q=85&s=df6331d166120cd300fac9d50bb04f82" width="2500" height="990" data-path="images/docs/b8a9822-esp-sendgrid-apikey-3.jpg" />
</Frame>

### İzin verebileceğim minimum API kısıtlamaları nelerdir?

İzin vermeniz gereken minimum erişim şu şekildedir:

<Frame caption="Minimum API izin gereksinimleri">
  <img src="https://mintcdn.com/onesignal/3zq1PvSaqvUE2bIx/images/docs/2d82f50-Screen_Shot_2021-12-09_at_1.25.57_PM.png?fit=max&auto=format&n=3zq1PvSaqvUE2bIx&q=85&s=d8857161192778c6714357b2d5e95ac3" width="986" height="1722" data-path="images/docs/2d82f50-Screen_Shot_2021-12-09_at_1.25.57_PM.png" />
</Frame>

<Warning>
  SendGrid'in allowlisting işlevini kullanıyorsanız, bu listeye OneSignal'i eklediğinizden emin olun.

  Aşağıdaki SSS'ye bakın [OneSignal'in IP'lerini nasıl allowlist'e eklerim?](./sendgrid-setup#how-do-i-whitelist-onesignals-ips)
</Warning>

## 4. Sendgrid Subscription Tracking'i Devre Dışı Bırakın

OneSignal, gönderilen her e-posta için otomatik olarak kendi varsayılan abonelikten çıkma bağlantılarını ekler.

Sendgrid'in metin ve HTML e-postalarının altına otomatik olarak kendi abonelikten çıkma bağlantısını eklemesini önlemek için sendgrid'de **Subscription Tracking**'i devre dışı bırakın.

<Frame caption="SendGrid subscription tracking ayarları">
  <img src="https://mintcdn.com/onesignal/tNi1OgLc_p9hiq7_/images/docs/1b863e8-Sendgrid_Tracking_Settings.png?fit=max&auto=format&n=tNi1OgLc_p9hiq7_&q=85&s=c483fc9706a46d3ab6cc4d00ee90802f" width="1235" height="647" data-path="images/docs/1b863e8-Sendgrid_Tracking_Settings.png" />
</Frame>

## 5. Email Messaging'i Etkinleştirin

OneSignal'de, **Settings > Platforms > Email**'e gidin ve e-posta ayarlarınızı yapılandırmak için Email'i **Activate** edin.

Sağlayıcı olarak **SendGrid**'i seçin.

<Frame caption="E-posta ayarlarından SendGrid seçme görüntüsü">
  <img src="https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/a42b5c0-Screenshot_2023-09-27_at_4.38.36_PM.png?fit=max&auto=format&n=RWtLFPeffHrC81wI&q=85&s=af1b1a422edf6fc979eeb9b4c3cfc42e" width="1880" height="1026" data-path="images/docs/a42b5c0-Screenshot_2023-09-27_at_4.38.36_PM.png" />
</Frame>

SendGrid API anahtarınızı sağlanan alana yapıştırın.

<Frame caption="API Anahtarınızı nereye gireceğinizi gösteren görüntü">
  <img src="https://mintcdn.com/onesignal/ciRrThfP6xMpI7GY/images/docs/0431d6a-Screenshot_2023-09-27_at_4.39.12_PM.png?fit=max&auto=format&n=ciRrThfP6xMpI7GY&q=85&s=bbb78dfd7e2c9deaf6699292dd55dab8" width="1862" height="644" data-path="images/docs/0431d6a-Screenshot_2023-09-27_at_4.39.12_PM.png" />
</Frame>

### Teslimat Varsayılanları

E-postalarınızın gelmesini istediğiniz varsayılan **isim** ve **e-posta adresini** ekleyin (bunlar daha sonra değiştirilebilir).

Bittiğinde Done'a basın.

<Frame caption="E-posta yapılandırması başarı banner'ı">
  <img src="https://mintcdn.com/onesignal/YOTSrtBSoqdrJ37A/images/docs/4b63e41-Screenshot_2023-09-27_at_4.41.02_PM.png?fit=max&auto=format&n=YOTSrtBSoqdrJ37A&q=85&s=7fa2706b1fa954740752c6b1557552cc" width="1874" height="884" data-path="images/docs/4b63e41-Screenshot_2023-09-27_at_4.41.02_PM.png" />
</Frame>

## 6. Aboneler Ekleyin

Hazır bir e-posta listeniz varsa, **Upload CSV**'yi seçin veya bunu her zaman daha sonra tekrar yapabilirsiniz.

Bir web siteniz varsa ve kullanıcılardan e-postalarını sağlamalarını istemek istiyorsanız. OneSignal'in [Email Web Prompt](./permission-requests)'unu kullanmak için **Add Web Prompt**'u seçin.

<Frame caption="E-posta abonesi kurulum seçenekleri">
  <img src="https://mintcdn.com/onesignal/MUgio66t0sYhGEvj/images/docs/6ba703e-Screenshot_2023-09-27_at_4.39.54_PM.png?fit=max&auto=format&n=MUgio66t0sYhGEvj&q=85&s=1073f5704e2367527d67cab6980789d2" width="1874" height="1174" data-path="images/docs/6ba703e-Screenshot_2023-09-27_at_4.39.54_PM.png" />
</Frame>

## 7. Test

**Messages > Email**'e gidin, **New Email**'i seçin.

Bir `Subject` ekleyin, bir Düzenleme deneyimi seçin (Drag & Drop Editor iyi bir başlangıçtır) ve **Send Test Email**'e tıklayın.

<Frame caption="E-posta test arayüzü">
  <img src="https://mintcdn.com/onesignal/6v_cVPknFpo5qSVB/images/docs/10d1976-Screenshot_2023-09-27_at_4.49.08_PM.png?fit=max&auto=format&n=6v_cVPknFpo5qSVB&q=85&s=5bd931f0ccb9ad064110678ce5e0e183" width="2206" height="692" data-path="images/docs/10d1976-Screenshot_2023-09-27_at_4.49.08_PM.png" />
</Frame>

E-postanızı girin ve **Send Test Email**'e basın. Kısa süre sonra gelen kutunuza bir e-posta gelmeli!

<Info>
  Sorunlarla karşılaşıyorsanız, [Email FAQ](./email-troubleshooting)'muza bakın.

  Takılırsanız, yardım için `support@onesignal.com` ile iletişime geçin.

  Daha hızlı yardım için lütfen şunları sağlayın:

  * OneSignal Uygulama ID'niz
  * Sorunun ayrıntıları, günlükleri ve/veya ekran görüntüleri.
  * Yeniden üretme adımları
</Info>

# Önerilir

## Kullanıcıları Tanımlama

**Entegrasyonlar kullanılıyorsa gereklidir.** **Birden fazla kanal (push, email, sms) arasında mesajlaşma için önerilir.**

OneSignal, subscription\_id adı verilen benzersiz bir ID altında abonelik düzeyinde kayıtlar oluşturur. Tek bir kullanıcı, uygulamanızla etkileşim kurmak için kaç cihaz, e-posta adresi ve telefon numarası kullandığına bağlı olarak birden fazla subscription\_id kaydına sahip olabilir.

Uygulamanızın kullanıcıları izlemek için kendi giriş sistemi varsa, tüm kanalları tek bir kullanıcıya bağlamak için herhangi bir zamanda `login`'i çağırın. Daha fazla ayrıntı için [Aliases & External ID](./users)'ye bakın.

## Yeni E-postalar Toplayın

**Email ve SMS mesajlaşması kullanılıyorsa önerilir.**

OneSignal'e yeni e-posta adreslerini iletmenin birkaç yolu vardır:

* Yeni e-postaları yakalamak için OneSignal'in Frontend SDK'sını kullanın. [Email SDK Methods](./mobile-sdk-reference#email)'a bakın.
* Sunucunuzdan e-postalar eklemek için [Create user](/reference/create-user) veya [Create subscription](/reference/create-subscription) API'lerini kullanın.
* CSV aracılığıyla e-postaları içe aktarmak istiyorsanız, [Import Email Addresses](./import)'a bakın.

## Tags Ekleyin

**İsteğe bağlı**

Tags, kullanıcı olaylarını ve özelliklerini izlemek için kullanılan özel `key : value` String veri çiftleridir. Daha karmaşık [segmentasyon](./segmentation) ve [mesaj kişiselleştirme](./message-personalization) için etiketleri ayarlamak gereklidir.

Daha fazla ayrıntı için [Tags](./add-user-data-tags)'e bakın.

<Check>
  Sonraki adımlar için [Email Tutorials](./email-messaging)'ı ziyaret edin.
</Check>

# E-postaları Dışa Aktarma

1. **Contact Lists Navigation**: `Marketing > Contacts`'a gidin.

2. <Frame caption="Contacts sayfasına gitme">
     <img src="https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/7c49df1-step-1-50.png?fit=max&auto=format&n=jBdBk5XvQR5eKOks&q=85&s=eb80902228ae5d891426577e09211c6a" width="224" height="1167" data-path="images/docs/7c49df1-step-1-50.png" />
   </Frame>

3. **List Identification**: Dışa aktarmak istediğiniz listeyi bulun.

4. **Export Selection**: **Action** liste başlığı altındaki bağlam menüsünü açın.

<Frame caption="Dışa aktarılacak İletişim Listesini seçme">
  <img src="https://mintcdn.com/onesignal/Z6xkXGfmy814If53/images/docs/d900c5a-step-3-50.png?fit=max&auto=format&n=Z6xkXGfmy814If53&q=85&s=4ef417459779b56fe9211305f082782e" width="1261" height="679" data-path="images/docs/d900c5a-step-3-50.png" />
</Frame>

4. **Begin Export**: **Export**'a tıklayın. Bu sizi `Contact > Active Exports`'a götürür.
5. **Download File**: **Status** 'Ready for Download' gösterene kadar bekleyin, ardından **Download CSV**'ye tıklayın.

<Frame caption="Dışa aktarılan CSV'yi indirme">
  <img src="https://mintcdn.com/onesignal/3zq1PvSaqvUE2bIx/images/docs/2d1c12f-step-5-50.png?fit=max&auto=format&n=3zq1PvSaqvUE2bIx&q=85&s=3f8102ca85b5dde7c55e10cb12643ce6" width="1261" height="630" data-path="images/docs/2d1c12f-step-5-50.png" />
</Frame>

6. **File Retrieval**: Dosya indirme dizininize kaydedilecektir.

# API Anahtarı Edinme

1. Sendgrid dashboard'unuza gidin ve sol kenar çubuğundan **Settings**'i açın.

<Frame caption="Settings > API Keys'e gitme">
  <img src="https://mintcdn.com/onesignal/4HyuQPBpu-4xjmQC/images/docs/cf3fe33-step-1-50.png?fit=max&auto=format&n=4HyuQPBpu-4xjmQC&q=85&s=0a162a955d877a4b66623bbe835cfcb7" width="1616" height="1365" data-path="images/docs/cf3fe33-step-1-50.png" />
</Frame>

2. **API Keys**'i seçin.

<Frame caption="Create API Key düğmesine tıklama">
  <img src="https://mintcdn.com/onesignal/9_Q1FZLh6C0BFLq-/images/docs/c3045de-step-2-50.png?fit=max&auto=format&n=9_Q1FZLh6C0BFLq-&q=85&s=2421e360c654dcf620110214bdceb187" width="1616" height="1365" data-path="images/docs/c3045de-step-2-50.png" />
</Frame>

3. Anahtarınızı adlandırın. İsteğe bağlı olarak, belirli izinler için *Restricted Access*'i seçin.

<Frame caption="Anahtarı adlandırma ve izinleri ayarlama">
  <img src="https://mintcdn.com/onesignal/0qspEXXeJ8zJbkJ-/images/docs/8770efc-step-3-50.png?fit=max&auto=format&n=0qspEXXeJ8zJbkJ-&q=85&s=f2c9125755ab5db955af0a8dd6d1edfc" width="1616" height="1365" data-path="images/docs/8770efc-step-3-50.png" />
</Frame>

*Restricted Access* kullanıyorsanız, Marketing için **Full Access** ayrıcalıkları verdiğinizden emin olun.

<Frame caption="Marketing'e Full Access verme">
  <img src="https://mintcdn.com/onesignal/0qspEXXeJ8zJbkJ-/images/docs/83d80f8-step-4-50.png?fit=max&auto=format&n=0qspEXXeJ8zJbkJ-&q=85&s=33a46fe982c60987c70cd4dfa9e0d07e" width="1616" height="1365" data-path="images/docs/83d80f8-step-4-50.png" />
</Frame>

4. **Create & View**'a tıklayın.

<Frame caption="Create & View düğmesine tıklama">
  <img src="https://mintcdn.com/onesignal/KSCNwSpBCNSQ8xdF/images/docs/f92f0c4-step-5-50.png?fit=max&auto=format&n=KSCNwSpBCNSQ8xdF&q=85&s=75a7a005e4040d66c4badf0d68260942" width="1616" height="1365" data-path="images/docs/f92f0c4-step-5-50.png" />
</Frame>

5. API anahtarınızı kopyalayın.

<Frame caption="API anahtarını kopyalama">
  <img src="https://mintcdn.com/onesignal/MUgio66t0sYhGEvj/images/docs/64034da-step-6-50.png?fit=max&auto=format&n=MUgio66t0sYhGEvj&q=85&s=73edf11c5792ca71d42301ac225594f6" width="1616" height="1365" data-path="images/docs/64034da-step-6-50.png" />
</Frame>

# SSS

## SendGrid'de zaten aktif bir Webhook'um varsa OneSignal'i nasıl kurarım?

Kurulumu basitleştirmek ve e-posta teslimat istatistiklerine erişebilmek için, OneSignal SendGrid ile Webhook'ları otomatik olarak yapılandıracaktır. Ne yazık ki, SendGrid belirli bir hesap için yalnızca tek bir webhook'u destekler. OneSignal, e-posta analitiği için webhook'lara ihtiyaç duyar ve bu, daha önce kurulmuş webhook'larla çakışabilir (örneğin, bir analitik entegrasyonu için).

Şu anda kurduğunuz webhook'a ihtiyacınız varsa, isteği `https://onesignal.com/email/hooks/sendgrid`'e iletebilirsiniz. En iyi sonuçlar için 30 saniyelik bir timeout ayarlayın.

Daha önce kurduğunuz webhook'a ihtiyacınız yoksa, onu değiştirmelisiniz. SendGrid'de, **Settings > Mail Settings**'e gidin ve 'Event Webhook'a tıklayın. HTTP Post URL `https://onesignal.com/email/hooks/sendgrid` olmalı ve gösterilen minimum ayarlara sahip olmalıdır:

<Frame caption="SendGrid webhook yapılandırma ayarları">
  <img src="https://mintcdn.com/onesignal/tc0EvmtSSX56SX0c/images/docs/989f714-Screen_Shot_2021-10-20_at_2.05.47_PM.png?fit=max&auto=format&n=tc0EvmtSSX56SX0c&q=85&s=fccfdce1d4e2ae9139c8a00bd1605bf2" width="2526" height="1522" data-path="images/docs/989f714-Screen_Shot_2021-10-20_at_2.05.47_PM.png" />
</Frame>

## OneSignal'in IP'lerini nasıl allowlist'e eklerim?

Ayrıntılar için [REST API Overview](/reference/rest-api-overview)'daki gereksinimlere bakın.

<Frame caption="OneSignal IP allowlist gereksinimleri">
  <img src="https://mintcdn.com/onesignal/56ctKxZSV4m5VEkn/images/docs/b7550d9-Screen_Shot_2022-05-27_at_5.32.06_PM.png?fit=max&auto=format&n=56ctKxZSV4m5VEkn&q=85&s=d107970e875efcb9418aea08ea412106" width="1626" height="1314" data-path="images/docs/b7550d9-Screen_Shot_2022-05-27_at_5.32.06_PM.png" />
</Frame>

***