Webhook | TikOyun Belgeleri

Webhook, TikOyun'un sizin belirlediğiniz bir adrese otomatik olarak mesaj göndermesidir. Yayında bir şey olduğunda, örneğin bir hediye geldiğinde, TikTok bunu TikOyun'a bildirir; TikOyun da aynı anda sizin sunucunuza haber verir. Bu sunucu kendi bilgisayarınızda çalışan bir program da olabilir, internetteki bir sunucu da.

Uyarı

Videoya geçmeden önce iki noktaya dikkat edin:

Webhook adresi http:// ya da https:// ile başlamalıdır.
Ayarları bitirdikten sonra eylemi Kaydet düğmesiyle kaydedin. Kaydetmediğiniz eylem çalışmaz.

Bildirimler ve Olaylar bölümündeki Webhook Tetikleyici, adım adım (yaklaşık 4 dakika).

Webhook eklemek#

TikWidget'ta Bildirimler ve Olaylar bölümünü açın ve Yeni Eylem Oluştur'a tıklayın.
Açılan pencerede Webhook Tetikleyici kutusunu işaretleyin. Altında Webhook URL'leri listesi açılır.
İsteğin gideceği adresi yazın. Kendi bilgisayarınızdaki bir program için http://localhost gibi yerel bir adres, internetteki bir sunucu için o sunucunun adresi yazılır.

Birden fazla adres#

Aynı eylemle birden fazla adrese aynı anda istek gönderebilirsiniz. Eylem çalıştığında listedeki adreslerin hepsine istek gider.

URL Ekle ile adresleri tek tek ekleyin.
Çok sayıda adresi bir seferde eklemek için Toplu Webhook Ekle'ye tıklayın ve açılan pencereye her satıra bir adres gelecek şekilde yapıştırın. Boş ve tekrar eden satırlar kendiliğinden temizlenir.

Listede bir eylem için en fazla 20 adres bulunabilir. Her adresin yanında isteğin metodu yazar; yanındaki ayar simgesi o adresin İstek Ayarları'nı açar, çöp kutusu simgesi de adresi listeden siler.

İstek ayarları#

Metod#

Metod, isteğin karşı tarafa ne yapmasını istediğini belirtir. Hangisini seçmeniz gerektiğini, istek gönderdiğiniz servis belirler; servisin kendi belgelerinde yazar.

Metod	Ne yapar
GET	Yalnızca haber verir, veri göndermez.
POST	Yeni bir bilgi gönderir. En yaygın kullanılan metoddur.
PUT	Sunucudaki bir kaydı baştan günceller.
PATCH	Bir kaydın yalnızca bir kısmını değiştirir.
DELETE	Bir kaydı siler.

Gövde formatı#

POST, PUT ya da PATCH seçtiğinizde bilginin hangi biçimde gönderileceğini de seçersiniz. Aynı bilgi iki biçimde şöyle görünür:

Form: TikFinity için hazırlanmış bir sisteminiz varsa bunu seçin.

kullanici=ahmet&hediye=Gül&adet=5

JSON: Günümüzde servislerin çoğunun beklediği biçimdir.

{
  "kullanici": "ahmet",
  "hediye": "Gül",
  "adet": 5
}

Parametreler#

Parametreler, isteğin içinde gönderilecek bilgilerdir. Her parametrenin bir adı ve bir değeri vardır. Parametre Ekle ile yeni satır eklersiniz; bir istekte en fazla 20 parametre bulunabilir.

Değişkenler#

Değer kutusuna tıkladığınızda sağda Değişkenler paneli açılır. Paneldeki bir değişkene tıkladığınızda değişken kutuya eklenir. Değişkenler, istek gönderilirken o anki gerçek bilgiyle değiştirilir: hediyeyi gönderen kullanıcının adı, beğeni sayısı ya da yorumun metni gibi.

Örneğin parametreleri şöyle ayarladığınızı düşünün:

Parametre	Değer
kullanici	`{event.user.username}`
hediye	`{event.gift.name}`
adet	`{event.gift.count}`

Yayında ahmet adlı izleyici 5 tane Gül gönderdiğinde sunucunuza kullanici için ahmet, hediye için Gül, adet için 5 bilgisi gider.

Kapatmak ve kaydetmek#

Ayarları bitirince İstek Ayarları penceresini Kapat düğmesiyle kapatın. Ardından eylemin çalışması için en sonda Kaydet'e tıklayın.

Not

Videodaki adımları uyguladığınız hâlde sorununuz çözülmediyse WhatsApp destek hattımıza yazın. Mesajınızda webhook adresini nereye gönderdiğinizi ve hangi adımda takıldığınızı belirtirseniz size daha hızlı yardımcı olabiliriz.