Support
Twitch 클립을 Discord에 자동 게시하는 방법

EventSub을 통한 Twitch 신규 클립 Discord 자동 게시

Twitch 클립 Discord 자동 게시가 적합한 경우

Twitch와 Discord의 기본 통합 기능은 방송 상태 표시, 역할 부여, 방송 시작 알림에 유용합니다. 하지만 일반적으로 새 클립을 텍스트 채널에 자동으로 게시하지는 않습니다. 이를 위해서는 전용 봇, 자동화 서비스 또는 Twitch EventSub와 Discord webhook을 직접 연동한 구성이 필요합니다.

개발이 필요 없는 경우에는 기성 솔루션이 적합합니다. Twitch와 Discord를 연결하고 채널을 선택한 뒤 템플릿을 설정하면 됩니다. 시작하기 전에 해당 서비스가 방송 시작뿐만 아니라 클립 생성에도 반응하는지 확인하세요. 기성 솔루션의 단점은 요금제, 사용 가능한 필터, 메시지 디자인에 종속된다는 점입니다.

Twitch 설정 전에 게시 방식을 선택하세요

빠른 확인을 위해 비공개 Discord 채널을 만들고 여러 클립을 수동으로 테스트하세요. 이렇게 하면 지연 시간을 확인하고, 링크 카드가 어떻게 표시되는지 점검하며, 커뮤니티에 게시되어서는 안 되는 클립 알림이 오지 않는지 파악할 수 있습니다.

  • 기성 봇은 연결이 빠르지만 필요한 게시 조건과 원하는 embed 형식을 지원하지 않을 수 있습니다.
  • 자동화 빌더는 분기와 필터를 추가할 수 있지만 일부 트리거와 액션은 서비스 요금제에 따라 제한될 수 있습니다.
  • 직접 구현한 EventSub 핸들러는 큐, 템플릿, 로그, 중복 방지를 완전히 제어할 수 있지만 서버, OAuth, 코드 유지보수가 필요합니다.

규칙을 미리 정하세요. 모든 클립 게시, 채널 소유자의 클립만 게시, 모더레이터의 클립만 게시, 또는 수동 승인 후 링크 게시 중에서 선택합니다. 엄격한 필터링의 단점은 시청자가 만든 좋은 순간이 게시되지 않을 수 있다는 점입니다.

클립 채널용 Discord webhook 생성

Webhook은 원하는 Discord 텍스트 채널 설정에서 생성합니다. 이를 위해서는 webhook 관리 권한이 필요합니다. Webhook은 지정된 이름과 선택한 아바타로 메시지를 전송하므로 기본 게시에는 별도의 Discord 계정이 필요하지 않습니다.

  1. 클립이 도착할 텍스트 채널 설정을 엽니다.
  2. 통합 섹션으로 이동하여 webhook을 찾습니다.
  3. 새 webhook을 만들고 알아보기 쉬운 이름을 지정하며 필요하면 아바타를 업로드합니다.
  4. URL을 복사하여 환경 변수나 보안 저장소에 보관합니다.
  5. 비공개 채널로 테스트 메시지를 보냅니다.

Webhook URL은 비밀입니다. 이 링크를 얻은 사람은 webhook 이름으로 채널에 메시지를 보낼 수 있습니다. 주소를 공개 저장소, 패널 스크린샷, 클라이언트 코드에 추가하지 마세요. 유출된 경우 webhook을 삭제하고 새로 만드세요. 기존 주소의 URL만 변경하는 것으로는 충분하지 않습니다.

Twitch EventSub으로 클립 생성 이벤트 연결

직접 구성하는 방식에서는 Twitch가 channel.clip.created 이벤트를 핸들러의 HTTPS 주소로 전송합니다. 핸들러는 요청을 검증하고, 클립 데이터를 저장하며, 메시지를 구성하여 Discord webhook으로 전달합니다. 이때 Twitch 계정이 Discord 서버에 접근하지는 않습니다.

구독에는 Twitch 애플리케이션, 채널 ID, callback URL, 그리고 선택한 이벤트 유형에 맞는 인증이 필요합니다. 토큰 및 권한 요구 사항은 변경될 수 있으므로 최신 EventSub 문서와 대조하세요. 확인 없이 오래된 예제의 인증 파라미터를 사용하지 마세요.

채널 소유자의 사용자 토큰은 만료되거나 취소될 수 있습니다. 이 방식의 단점은 refresh token을 안전하게 보관하고 제때 갱신해야 한다는 점입니다. 갱신이 작동하지 않으면 Discord에서 눈에 띄는 오류 없이 구독 또는 새 구독 생성이 중단될 수 있습니다.

Twitch 알림용 HTTPS 주소 준비

Callback URL은 인터넷에서 HTTPS로 접근 가능해야 합니다. 구독을 생성할 때 Twitch는 webhook_callback_verification 유형의 검증 요청을 보냅니다. 서버는 요청의 진위를 확인하고 challenge 값을 일반 텍스트로 반환해야 합니다. 이 단계를 통과해야만 구독이 활성화됩니다.

실제 이벤트는 notification 유형으로 도착합니다. 이 경우 빠르게 성공 HTTP 응답을 반환하고 게시 작업은 큐나 별도 핸들러로 넘기는 것이 좋습니다. EventSub 요청 안에서 Discord 응답을 기다리면 네트워크 지연으로 인해 알림이 재전송될 위험이 높아집니다.

로컬 개발에는 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로 구성합니다. 키로는 구독 생성 시 설정한 시크릿을 사용합니다. 16진수 결과를 sha256=으로 시작하는 헤더 값과 비교합니다.

Node.js에서는 다음과 같이 구현합니다. 구독 시크릿으로 HMAC SHA-256을 생성하고 messageId + timestamp + rawBody를 전달한 뒤, 해시 앞에 sha256= 접두사를 붙이고 crypto.timingSafeEqual로 Twitch-Eventsub-Message-Signature와 비교합니다. 비교 전에 문자열 길이가 같은지 확인하세요. 그렇지 않으면 안전한 비교가 오류로 종료됩니다.

EventSub을 통해 새 Twitch 클립 알림이 Discord 채널로 전달되는 구조도

메시지 유형과 전송 시간 확인

HMAC 검증은 callback verification, notification, revocation을 포함한 모든 EventSub 요청에 필요합니다. 검증에 성공한 후에만 JSON을 읽고 Twitch-Eventsub-Message-Type 헤더로 메시지 유형을 판별하세요. callback 검증에는 challenge를 반환하고, notification에는 게시 작업을 생성하며, revocation에는 구독 해제 사유를 로그에 기록합니다.

추가로 Twitch-Eventsub-Message-Timestamp의 시간을 서버 현재 시간과 대조하세요. 제한된 수신 시간 범위는 제3자가 재전송한 오래된 요청을 걸러내는 데 도움이 됩니다. 이 검사는 HMAC을 대체하지 않습니다. timestamp는 요청에서 읽을 수 있지만 시크릿 없이는 올바른 서명을 만들 수 없습니다.

구독 시크릿은 코드 및 Discord webhook URL과 분리하여 보관하세요. 갱신 절차 없이 시크릿을 자주 변경하는 것의 단점은 기존 구독이 검증을 통과하지 못하게 된다는 점입니다. 먼저 구독을 생성하거나 갱신한 다음 핸들러의 시크릿을 전환하세요.

같은 클립을 두 번 게시하지 마세요

Endpoint가 오랫동안 응답하지 않거나 연결이 끊기거나 네트워크 오류가 발생하면 EventSub이 동일한 알림을 다시 전송할 수 있습니다. Twitch-Eventsub-Message-Id를 고유 인덱스가 있는 영구 데이터베이스에 저장하세요. 이미 처리된 ID라면 두 번째 작업을 생성하지 말고 성공 응답을 반환합니다.

이벤트 데이터의 클립 ID를 기준으로 두 번째 고유 키를 추가하세요. 이렇게 하면 동일한 영상이 서로 다른 알림으로 도착하거나 장애 후 작업이 다시 실행될 때 중복 게시를 방지할 수 있습니다. 먼저 게시된 클립 테이블에 clip_id를 기록하고, 기록에 성공한 후에만 Discord로 메시지를 보내세요.

이 방식의 단점은 clip_id 기록과 webhook 전송 사이에 장애가 발생하면 Discord에 메시지 없이 클립이 게시된 것으로 표시될 수 있다는 점입니다. 이런 경우를 위해 작업 상태(생성됨, 전송 중, 게시됨, 오류)를 저장하세요. 오류 상태의 작업은 수동으로 또는 큐 규칙에 따라 재시도할 수 있습니다.

Discord용 embed 메시지 구성

메시지에는 클립 제목, 작성자 이름, 채널 이름, 카테고리, 직접 링크를 포함하는 것이 좋습니다. Twitch의 텍스트를 문자열 연결로 JSON에 직접 삽입하지 마세요. 따옴표와 특수 문자가 요청을 깨뜨릴 수 있습니다. 언어 기능으로 객체를 구성하고 JSON으로 전송하세요.

Embed 템플릿은 다음과 같을 수 있습니다. 제목 «채널의 새 클립», 설명 «작성자: {creator_name}», URL «{clip_url}», «제목» 필드 값 «{clip_title}», «카테고리» 필드 값 «{game_name}». 이벤트에 카테고리나 작성자 이름이 없으면 필드를 비워두거나 추가하지 마세요.

역할 멘션을 추가할 수 있지만 제한 없이 모든 클립에 보내지 마세요. 지속적인 알림의 단점은 서버 멤버가 채널이나 역할 알림을 끄기 시작한다는 점입니다. 활발한 채널에서는 핑 없이 클립을 게시하거나 별도 규칙에 따라서만 역할을 멘션하는 것이 좋습니다.

메인 채널 게시 전 시나리오 점검

먼저 테스트 Discord 채널을 사용하고 서로 다른 제목, 작성자, 카테고리를 가진 여러 클립을 만드세요. callback verification이 통과하는지, JSON 파싱 전에 서명이 검증되는지, clip_id당 카드가 하나만 나타나는지, EventSub 재전송 시 메시지가 게시되지 않는지 확인하세요.

  • 서버가 JSON 파서보다 먼저 raw body를 읽거나 요청의 원본 바이트를 저장하는지 확인하세요.
  • Twitch-Eventsub-Message-Signature 검증에 성공한 후에만 challenge가 반환되는지 확인하세요.
  • 두 번째 메시지를 생성하지 않고 Discord webhook 오류 처리와 작업 재시도가 이루어지는지 확인하세요.
  • message ID, clip_id, EventSub 메시지 유형, 전송 상태별 로그를 확인하세요.

구독 시크릿, OAuth 토큰, 전체 Discord webhook URL을 로그에 기록하지 마세요. 진단에는 이벤트 ID, 클립 ID, Discord 응답 코드, 민감한 헤더가 없는 기술 오류 텍스트로 충분합니다.

Last Articles

새로운 사이트 디자인

디자인과 기능에서 변경된 사항 사이트를 더 빠르고 편리하게 사용할 수 있도록 업데이트했습니다. 주요 변경 사항은 인터페이스, 개인 계정 및 주문 관리와 관련이 있습니다. 데이터베이스 쿼리 최적화 덕분에 페이지 로딩 속도가 평균 3분의 1 빨라졌습니다. 내비게이션 메..

2026-08-15 신규

News SP

Good afternoon, I've collected all the news during this time.: 1. The main news is that prices for twitch viewers have been greatly reduced, while Tw..

2026-04-08 업데이트

01.01.2026까지 진행 중인 모든 프로모션과 추첨을 여러분을 위해 모았습니다

1. 모든 시청자분들께 15% 할인을 드리는 프로모션 코드 "December2025"를 사용하세요2. 1월 1일까지 당사 구성 도구와 가장 저렴한 시청자 카테고리의 기준 가격을 25% 인하했습니다3. 당사 채널에서 3개의 추첨이 진행 중입니다! - 당사 구매 ..

2025-12-26 종료

분대 및 리셀러와의 협력

트위치 서비스는 안정적으로 일해서,그래서 우리는 분대,전매자와 협력하게 준비되어 있습니다, 서비스 소유자,봇 소유자 및 기타 많은 사람들.개별 용어는 전보에서 관리자와 논의 할 수 있습니다...

2025-10-22 파트너 대상

트 위치 시청자는 안정적이지만 약간의 뉘앙스가 있습니다.

우리 완전히 우리의 트 뷰어 서비스를 업데이트 한,그들은 지금 안정적으로 일. 우리는 시청자에 대한 높은 품질의 아이피 주소를 사용합니다.뉘앙스는 최대 150 명의 시청자를 위한 주문에 있습니다. 전체 시청자 수가 200 명에 도달하면 떨어집니다.에 대한 예..

2025-10-22 업데이트

Twitch Viewer Configurator

Hello everyone! Today, we are announcing a new feature—"Twitch Viewer Configurator". Now, you can customize any plan for your Twitch channel. Choo..

2025-06-15 신규

If YouTube is blocked, where to stream now?

Greetings, I have compiled a guide for streamers, which will be very relevant at the moment. Now YouTube and twitch have disabled monetization from vi..

2022-03-16 중요

API SP

We have finally developed the APINow it will be more convenient for our partner sites to work with us.To update the maximum tariffs for YouTube, an up..

2021-09-02 파트너 대상

파트너 및 추천: 새로운 약관!

파트너십 서비스와 추천 프로그램의 엄청난 인기로 인해, 우리는 협력 테이블을 만들었습니다. 요점은 매우 간단합니다. 더 많은 라이브 청중 - 우리의 더 많은 광고.프로그램 약관을 다운로드하거나 확인하세요파트너에게 설정된 내용을 다운로드하려면 (소개 + 로고)스트리머의 ..

2020-08-12 파트너 대상

시청자 관리 패널 [Twitch | Kick | YouTube | VK Video Live]

나만의 맞춤 요금제를 만드세요
잔액 충전, 원클릭 주문, 할인 및 보너스는 회원만 이용할 수 있습니다. 회원가입.
원하는 서비스를 찾지 못했거나 더 저렴한 곳을 찾으셨다면 텔레그램 고객지원 또는 채팅으로 문의하세요. 무엇이든 해결해 드립니다.
신규

Telegram 봇 @BOT_SP_RU_BOT

1분 만에 주문·재주문, 잔액과 주문 상태 확인 — Telegram에서 바로

주문 반복주문 상태잔액 충전프로모션 코드