Twitch

Bu rehberde: Twitch kanalınızı bağlarsınız. Yayına başladığınızda ve yeni takipçi geldiğinde iş akışı anında başlar; örneğin "Canlıdayız!" duyurusunu X, Instagram ve Discord'a otomatik gönderirsiniz.

⏱ 5 dakika

Kimlik kartı#

Ne işe yarar?#

Tetikleyiciler:

Twitch kutusu – Get stream: Kanalın şu an canlı olup olmadığını okur: live, title, gameName, viewerCount, startedAt, thumbnailUrl (1280×720), tags, url. Channel login boşsa bağlı kanal kullanılır. Yayın başlığı ve oyun bilgisi tetikleyicide gelmez – duyurudan önce bu kutuyu ekleyin.

Örnek: canlıya geçince her yerde duyur#

Entegrasyon olayı  TWITCH · Stream went live
  → Twitch · Get stream                         (başlık, oyun, küçük resim)
  → AI · Metin üret   "{{ $json.title }} yayını başladı" duyurusu
  → Gönderi yayınla   platform: X          text: {{ $json.body }} {{ $json.url }}
  → Gönderi yayınla   platform: INSTAGRAM  mediaUrls: {{ [$json.thumbnailUrl] }}
  → Mesaj gönder      kanal: DISCORD       "🔴 Canlıdayız: {{ $json.url }}"

Instagram JPEG görsel ister; Twitch küçük resmi JPEG'dir. Yayın yeni başladığında küçük resim birkaç dakika boş görünebilir – gerekirse araya Bekle (2–3 dakika) koyun.

Ön koşullar#

• Bir Twitch hesabı (yayıncı). Takipçi olayı için kanal sahibinin kendisi bağlanmalıdır (moderator:read:followers izni).
• Platform tarafında Twitch uygulaması (TWITCH_CLIENT_ID, TWITCH_CLIENT_SECRET) ve https (443) üzerinden erişilebilen webhook adresi (PUBLIC_WEBHOOK_URL). Yerel geliştirmede EventSub aboneliği oluşturulamaz.

Adım adım kurulum#

1. Entegrasyonlar → Twitch → Bağla → Proje seçin.
2. Twitch ile devam et → kanal hesabınızla giriş → Authorize.
3. Bağlantı sonrası OrqLabs iki EventSub aboneliği oluşturur; Twitch adresi doğrular. Kartta hata görünmüyorsa abonelikler etkindir.
4. Entegrasyon olayı tetikleyicisini ekleyin → hesap: Twitch bağlantınız → olay: TWITCH · Stream went live → Etkinleştir.

Platform yöneticisi: uygulama kaydı#

1. dev.twitch.tv/console → Register Your Application (hesapta iki adımlı doğrulama açık olmalı).
2. OAuth Redirect URLs: https://api.orqlabs.com/api/v1/integrations/oauth/twitch/callback; Category: Application Integration; Client Type: Confidential.
3. Client ID → TWITCH_CLIENT_ID, New Secret → TWITCH_CLIENT_SECRET; API'yi yeniden başlatın.
4. PUBLIC_WEBHOOK_URL geçerli sertifikalı bir https:// adresi olmalı; Twitch olayları …/api/v1/webhooks/twitch/<entegrasyon-id> adresine gönderir.
5. EventSub abonelikleri uygulama erişim anahtarıyla (client credentials) oluşturulur; ek ayar gerekmez. İstenen kullanıcı kapsamları: user:read:email, moderator:read:followers.

Her bildirim Twitch-Eventsub-Message-Signature başlığıyla imzalıdır (mesaj kimliği + zaman damgası + gövde, bağlantıya özel gizli anahtar). İmzası tutmayan veya 10 dakikadan eski bildirimler reddedilir; aynı bildirimin tekrarı yeni çalıştırma başlatmaz.

Sık karşılaşılan hatalar#

Sonraki adım#

• Tetikleyiciler, Sosyal medya kutuları, Discord