Автопублікація нових кліпів Twitch у Discord через EventSub
Кому підходить автопостинг кліпів Twitch у Discord
Вбудована інтеграція Twitch і Discord допомагає показувати статус стріму, видавати ролі та повідомляти про початок ефіру. Нові кліпи вона зазвичай не публікує в текстовий канал автоматично. Для цього потрібен готовий бот, сервіс автоматизації або власна зв'язка Twitch EventSub і Discord webhook.
Готові рішення підходять, якщо не потрібна розробка: ви підключаєте Twitch і Discord, вибираєте канал і налаштовуєте шаблон. Перед запуском перевірте, що сервіс реагує саме на створення кліпу, а не лише на старт трансляції. Недолік готових рішень — залежність від тарифів, доступних фільтрів і оформлення повідомлень.
Виберіть схему публікації до налаштування Twitch
Для швидкої перевірки створіть закритий канал Discord і протестуйте кілька кліпів вручну. Це допоможе побачити затримки, перевірити картку посилання і зрозуміти, чи не надходять повідомлення про кліпи, які не повинні потрапляти в спільноту.
- Готовий бот швидше підключається, але може не підтримувати потрібні умови публікації та власний формат embed.
- Конструктор автоматизацій дозволяє додавати розгалуження і фільтри, але частина тригерів і дій може бути обмежена планом сервісу.
- Власний обробник EventSub дає контроль над чергою, шаблоном, логами і захистом від дублів, але потребує сервера, OAuth і підтримки коду.
Заздалегідь визначте правило: публікувати всі кліпи, лише кліпи власника каналу, кліпи від модераторів або посилання після ручного схвалення. Недолік строгої фільтрації — вдалий момент, створений глядачем, може залишитися без публікації.
Створіть Discord webhook для каналу з кліпами
Webhook створюється в налаштуваннях потрібного текстового каналу Discord. Для цього необхідні права на керування webhook. Він надсилає повідомлення від заданого імені та з вибраною аватаркою, тому окремий акаунт Discord для базової публікації не потрібен.
- Відкрийте налаштування текстового каналу, куди будуть надходити кліпи.
- Перейдіть у розділ інтеграцій і знайдіть webhook.
- Створіть новий webhook, задайте зрозуміле ім'я і за потреби завантажте аватар.
- Скопіюйте URL і збережіть його в змінній оточення або захищеному сховищі.
- Надішліть тестове повідомлення в закритий канал.
URL webhook — секрет. Той, хто отримає це посилання, зможе надсилати повідомлення в канал від імені webhook. Не додавайте адресу в публічний репозиторій, скриншоти панелі або код клієнта. У разі витоку видаліть webhook і створіть новий: змінити URL у старої адреси недостатньо.
Підключіть подію створення кліпу через Twitch EventSub
У власній схемі Twitch надсилає подію channel.clip.created на HTTPS-адресу вашого обробника. Обробник перевіряє запит, зберігає дані про кліп, формує повідомлення і передає його в Discord webhook. Акаунт Twitch при цьому не отримує доступ до сервера Discord.
Для підписки знадобиться застосунок Twitch, ID каналу, callback URL і авторизація, що підходить для вибраного типу події. Вимоги до токена і дозволів варто звіряти з актуальною документацією EventSub: вони можуть змінюватися. Не використовуйте параметри авторизації зі старих прикладів без перевірки.
Користувацький токен власника каналу може спливти або бути відкликаний. Недолік такої схеми — refresh token потрібно зберігати безпечно і вчасно оновлювати доступ. Якщо оновлення не працює, підписка або створення нових підписок може перестати працювати без помітної помилки в Discord.
Підготуйте HTTPS-адресу для повідомлень Twitch
Callback URL має бути доступний з інтернету через HTTPS. Під час створення підписки Twitch надсилає запит перевірки з типом webhook_callback_verification. Сервер має переконатися в достовірності запиту і повернути значення challenge звичайним текстом. Поки цей етап не пройдено, підписка не стане активною.
Робочі події надходять з типом notification. На них краще швидко повернути успішну HTTP-відповідь, а публікацію передати в чергу або окремий обробник. Якщо чекати на відповідь Discord всередині запиту EventSub, затримка мережі підвищує ризик повторної доставки повідомлення.
Для локальної розробки можна використовувати HTTPS-тунель. Його недолік — публічна адреса може змінитися після перезапуску. Тунель зручний для тестів, але не замінює постійний endpoint для робочої автоматизації.
Перевіряйте підпис за вихідним тілом запиту
Підпис EventSub будується з ID повідомлення, часу надсилання і вихідного тіла HTTP-запиту. Спочатку отримайте байти body, збережіть їх без змін, потім перевіряйте HMAC. Не можна розібрати JSON і зібрати його заново до перевірки підпису. Порядок полів, пробіли або кодування можуть змінитися, і обчислений підпис не збіжиться.
Для перевірки потрібні заголовки Twitch-Eventsub-Message-Id, Twitch-Eventsub-Message-Timestamp і Twitch-Eventsub-Message-Signature. Рядок для HMAC SHA-256 складається так: messageId + timestamp + rawBody. Як ключ використовується секрет, заданий під час створення підписки. Результат у шістнадцятковому вигляді порівнюється зі значенням заголовка, яке починається з sha256=.
У Node.js логіка виглядає так: створіть HMAC SHA-256 із секретом підписки, передайте в нього messageId + timestamp + rawBody, додайте до хешу префікс sha256= і порівняйте з Twitch-Eventsub-Message-Signature через crypto.timingSafeEqual. Перед порівнянням перевірте однакову довжину рядків, інакше безпечне порівняння завершиться помилкою.

Перевіряйте тип повідомлення і час його надсилання
Перевірка HMAC потрібна для кожного запиту EventSub, включно з callback verification, notification і revocation. Лише після успішної перевірки читайте JSON і визначайте тип повідомлення за заголовком Twitch-Eventsub-Message-Type. Для перевірки callback поверніть challenge, для notification створіть задачу на публікацію, для revocation запишіть причину відключення підписки в лог.
Додатково звіряйте час із Twitch-Eventsub-Message-Timestamp з поточним часом сервера. Обмежене вікно прийому допомагає відсіяти старі запити, повторно надіслані третьою стороною. Ця перевірка не замінює HMAC: timestamp можна прочитати із запиту, але без секрету не можна створити коректний підпис.
Секрет підписки зберігайте окремо від коду і URL Discord webhook. Недолік частої зміни секрету без процедури оновлення — наявна підписка перестане проходити перевірку. Спочатку створіть або оновіть підписку, потім перемикайте секрет в обробнику.
Не публікуйте один кліп двічі
EventSub може доставити одне повідомлення повторно, якщо endpoint довго відповідав, з'єднання обірвалося або сталася помилка мережі. Зберігайте Twitch-Eventsub-Message-Id у постійній базі з унікальним індексом. Якщо такий ID уже оброблено, не створюйте другу задачу і поверніть успішну відповідь.
Додайте другий унікальний ключ за ID кліпу з даних події. Це захищає від повторної публікації, коли одне й те саме відео надходить у різних повідомленнях або задачу було повторно запущено після збою. Спочатку спробуйте записати clip_id у таблицю опублікованих кліпів, і лише після успішного запису надсилайте повідомлення в Discord.
У цієї схеми є недолік: збій між записом clip_id і надсиланням webhook може залишити кліп позначеним як опублікований без повідомлення в Discord. Для таких випадків зберігайте статус задачі: створена, надсилається, опублікована, помилка. Задачі зі статусом помилки можна повторювати вручну або за правилами черги.
Зберіть embed-повідомлення для Discord
У повідомлення корисно передати назву кліпу, ім'я автора, назву каналу, категорію і пряме посилання. Не підставляйте текст із Twitch у JSON вручну через конкатенацію рядків: лапки і спеціальні символи можуть зламати запит. Формуйте об'єкт засобами мови і надсилайте його як JSON.
Шаблон embed може виглядати так: заголовок «Новий кліп на каналі», опис «Автор: {creator_name}», URL «{clip_url}», поле «Назва» зі значенням «{clip_title}», поле «Категорія» зі значенням «{game_name}». Якщо в події немає категорії або імені автора, залишайте поле порожнім або не додавайте його.
Можна додати згадку ролі, але не надсилайте її на кожен кліп без обмежень. Недолік постійних повідомлень — учасники сервера почнуть вимикати канал або роль. Для активного каналу краще публікувати кліпи без пінгу або згадувати роль лише за окремим правилом.
Перевірте сценарій перед публікацією в основному каналі
Спочатку використовуйте тестовий Discord-канал і створіть кілька кліпів з різними назвами, авторами і категоріями. Перевірте, чи проходить callback verification, чи валідується підпис до розбору JSON, чи з'являється одна картка на один clip_id і чи не публікується повідомлення під час повторної доставки EventSub.
- Перевірте, що сервер читає raw body до JSON-парсера або зберігає вихідні байти запиту.
- Переконайтеся, що challenge повертається лише після успішної перевірки Twitch-Eventsub-Message-Signature.
- Перевірте обробку помилки Discord webhook і повтор задачі без створення другого повідомлення.
- Подивіться логи за message ID, clip_id, типом EventSub-повідомлення і статусом надсилання.
Не записуйте в логи секрет підписки, OAuth-токени і повний URL Discord webhook. Для діагностики достатньо ID події, ID кліпу, коду відповіді Discord і тексту технічної помилки без конфіденційних заголовків.
Останні статті
Що змінилося в дизайні та функціоналі Ми оновили сайт, щоб працювати з ним було швидше та зручніше. Основні зміни стосуються інтерфейсу, особистого к..
Доброго времени суток, собрал все новости за это время:1. Главная новость - сильно снижены цены на твич зрителей, пока твич откатил почти все защиты, ..
1. Використовуйте промокод "December2025" на 15% знижки для всіх наших глядачів2. Ми знизили до 1 січня базові ціни на наш конфігуратор і най дешевшу ..
Послуги Twitch працюють стабільно, тому ми готові співпрацювати з командами, реселерами, власниками сервісів, ботами і багатьма іншими.Індивідуальні..
Ми повністю оновили наші послуги перегляду Twitch, і тепер вони працюють стабільно. Ми використовуємо лише якісні IP-адреси для перегляду.Нюанс поля..
Всем доброго времени суток. Сегодня мы анонсируем новую функцию - "Конфигуратор Twitch зрителей".Теперь Вы сможете сами себе собрать любой тариф для т..
Приветствую, составил гайд для стримеров, который на данный момент будет очень актуален. Сейчас ютуб и твич отключили монетизацию с просмотров из ..
Мы наконец-то разработали API Теперь нашим сайтам партнерам будет удобнее с нами работать.По обновлению максимальных тарифов на ютуб - апдейт уже на п..
У зв'язку з величезною популярністю послуг партнерства та реферальної програми ми зробили таблицю співпраці.Суть дуже проста: більше живої аудиторії –..
Наші послуги для стрімерів

Shopee
Наші послуги для контент-мейкерів









