# WebHook’lar

**Ayarlar > Webhooklar > Yeni Webhook Oluştur**

**Webhooklar** Netmera ile daha geniş dijital ekosistem arasındaki köprünüz olarak öne çıkar. Netmera merkeziniz ile harici uygulamalar arasında içgörüleri, tetikleyicileri ve aksiyonları gerçek zamanlı olarak taşıyan sanal bir haberciyi hayal edin. 

Bu nedenle, **Netmera’dan harici bir web uygulamasına veya servise gerçek zamanlı olarak bilgi göndermenizi sağlayan bir mekanizmadır.** Netmera uygulamanızı diğer sistemlerle entegre etmenin bir yoludur ve Netmera’daki belirli olaylar veya veri değişikliklerine bağlı olarak harici uygulamanızda aksiyonları tetiklemenizi sağlar.

{% hint style="info" %}
**İpucu:**

Örneğin, Netmera’dan gönderilen push bildirimleriyle kullanıcı etkileşimlerini izlemek ve analiz etmek istediğinizi düşünelim. Bir **Webhook** oluşturabilirsiniz; bu, bir kullanıcı push bildirimine tıkladığında (**Push Click** olayı) tetiklenir. Bu Webhook daha sonra tıklama olayıyla ilgili verileri daha ileri analiz ve raporlama için harici bir analitik sistemine gönderebilir.
{% endhint %}

### Yeni Webhook Oluştur

**Webhook Adı**

Webhook’u Netmera Kontrol Paneli ve raporlarda tanımlamak için kullanılan, kullanıcı tarafından belirlenen bir ad. Bu ad yalnızca organizasyon amaçlıdır ve Webhook’un çalışmasını etkilemez.

**Webhook URI**

Netmera’nın Webhook verilerini göndereceği URL (Uniform Resource Identifier). Bu URL, Webhook verilerini alacak harici web uygulamasının veya servisin uç noktasını işaret etmelidir. (Parametreleri, yer tutucuda gösterildiği gibi süslü parantez içinde girin. Parametreleri doğruladıktan sonra, bildirimi oluştururken kullanılan karşılık gelen etiketleri girmeniz gerekecektir.)

**İstek Yöntemi**

Webhook isteği gönderilirken kullanılacak HTTP yöntemi. Bu durumda, `GET`olup, Webhook’un belirtilen URI’ye bir HTTP GET isteği ile tetikleneceği anlamına gelir.

**Tetikleyici Türü**

Webhook’u tetikleyecek olay veya aksiyon türü. Bu durumda, mevcut seçenekler şunlardır:

* **Push Click:** Kullanıcı bir push bildirimine tıkladığında Webhook tetiklenecektir.
* **Mesaj Günlüğü:** Bir mesaj günlüğü olayı gerçekleştiğinde Webhook tetiklenecektir.
* **Geofence:** Bir geofence olayı algılandığında Webhook tetiklenecektir.

**Etkinlik Seç**

Eğer **Etkinlik** tetikleyici türü olarak seçildiğinde, bu alan Webhook’u tetikleyecek belirli bir olayı (örneğin belirli bir push bildirimi veya geofence) seçmenize olanak tanır.

<figure><img src="https://1655476697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FSXqCIji05iPjNvPSfOVy%2FScreenshot%202023-07-24%20at%2014.27.37.png?alt=media&#x26;token=97a3b187-0be1-4e41-b19a-6a4b3f7a5a52" alt=""><figcaption><p>Webhooklar</p></figcaption></figure>

{% hint style="info" %}
**Örnek:**

Belirli ürün kategorileriyle kullanıcı etkileşimlerini izlemek isteyebilirsiniz. Bir kullanıcı ürün detay ekranını görüntülediğinde tetiklenecek bir Webhook kurabilirsiniz. Ardından ürün kategorisini, görüntülenen ürünün bağlamından alınan bir başlık değeri olarak eklemek için "Context Parameter" seçeneğini kullanabilirsiniz. Bu şekilde, Webhook’u alan harici sistem farklı ürün kategorilerindeki kullanıcı ilgi alanlarını analiz edebilir.
{% endhint %}

**Webhook Başlıkları**

Bunlar, Webhook isteğine eklenebilecek HTTP başlıklarıdır. Harici uygulamanın işlemesi için ek bilgi veya kimlik doğrulama verileri taşıyabilirler.

1. **Context Parameter:** Bir başlık için "Context Parameter" seçeneği kullanıldığında, başlığın değeri Webhook’u tetikleyen belirli olayın bağlamından alınır. Bağlam, bir kullanıcının profil özelliği, cihaz özelliği veya olaya özgü diğer ilgili verilerle ilişkili olabilir. Bu, olaya dayalı dinamik bilgi aktarmanıza olanak tanır.
2. **Sabit Değer:** Bir başlık için "Sabit Değer" seçeneği kullanıldığında, her Webhook isteğinde başlık değeri olarak gönderilecek statik bir değer sağlarsınız. Bu, Webhook’u tetikleyen belirli olaydan bağımsız olarak aynı değerin kullanılacağı anlamına gelir. Başlık değeri tüm Webhook istekleri için sabitse kullanışlıdır.

{% hint style="info" %}
**Anahtar:** Başlık parametresinin adı.&#x20;

**Değer Kaynağı:** Başlık parametresinin değerinin nasıl belirleneceğini belirtir. Kullanıcının profil özniteliğinden, cihaz özniteliğinden veya sabit bir değerden alınabilir.&#x20;

**Değer:** Başlık parametresinin gerçek değeri.
{% endhint %}

{% hint style="warning" %}
**Önemli Not:**

Bazı durumlarda, Webhook isteklerini **kimlik doğrulaması yapmak** için isteğin başlıklarına bir **API anahtarı veya kimlik doğrulama belirteci** eklemeniz gerekebilir. Bu senaryoda, API anahtarını veya belirteci başlıkta statik bir değer olarak sağlamak için **"Sabit Değer"** seçeneğini kullanabilirsiniz. Bu, onları tetikleyen belirli olaydan bağımsız olarak tüm Webhook isteklerinin gerekli kimlik doğrulamayı taşımasını sağlar.
{% endhint %}

<figure><img src="https://1655476697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FGyE314qKNrAGOZAJxYMp%2FScreenshot%202023-07-24%20at%2014.34.53.png?alt=media&#x26;token=aab3dba3-10c6-453a-8697-1a01348f9ca1" alt=""><figcaption><p>Webhook Başlıkları</p></figcaption></figure>

**Webhook Parametreleri**

Bunlar, Webhook isteğine eklenebilecek ek parametrelerdir. Başlıklar gibi, Webhook’u tetikleyen olayla ilgili belirli verileri de taşıyabilirler.

<figure><img src="https://1655476697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FErfLYGLtqmXI7fQXB6C2%2FScreenshot%202023-07-24%20at%2014.35.33.png?alt=media&#x26;token=f86eed45-2ecb-43ce-af06-9103d5082834" alt=""><figcaption><p>Webhook Parametreleri</p></figcaption></figure>

{% hint style="info" %}
**Anahtar:** Parametrenin adı.&#x20;

**Değer Kaynağı:** Parametrenin değerinin nasıl belirleneceğini belirtir. Kullanıcının profil özniteliğinden, cihaz özniteliğinden veya sabit bir değerden alınabilir.&#x20;

**Değer:** Parametrenin gerçek değeri.
{% endhint %}

**Örnek İstek**

Örnek bir istek, Webhook isteğinin nasıl yapılacağını gösteren bir cURL komutu olarak sunulmuştur. `${hook.url}` istek gönderildiğinde gerçek Webhook URI’si ile değiştirilecek bir yer tutucudur.

<figure><img src="https://1655476697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FkBRahuV0Ko3ay8Do1tdm%2FScreenshot%202023-07-24%20at%2014.36.29.png?alt=media&#x26;token=67d0254b-6084-4d54-a005-fc542cbae114" alt=""><figcaption><p>Örnek</p></figcaption></figure>

Genel olarak, Netmera’da bir Webhook oluşturmak; onu diğer servislerle entegre ederek, iş akışlarını otomatikleştirerek ve kullanıcı davranışına dair daha derin içgörüler elde ederek uygulamanızın işlevselliğini genişletmenizi sağlar.