Discord 웹후크 테스터

Discord 웹후크를 몇 초 만에 테스트합니다. URL을 붙여넣고 검증한 뒤, 정상 작동을 확인할 테스트 메시지를 보내세요.

Discord 웹후크란 무엇인가요?

Discord 웹후크는 봇 없이도 특정 Discord 채널로 메시지를 보낼 수 있는 고유한 URL입니다. 웹후크는 GitHub 알림, 서버 모니터링 경고, CI/CD 파이프라인 업데이트, 맞춤 연동에 널리 쓰입니다. 각 웹후크에는 고유한 이름과 아바타가 있으며 특정 채널에 연결됩니다.

Discord 웹후크 만드는 방법

1. Discord 서버를 열고 서버 설정으로 이동하세요
2. 연동 > 웹후크로 이동하세요
3. 새 웹후크를 클릭하세요
4. 이름을 정하고 대상 채널을 선택하세요
5. 웹후크 URL 복사를 클릭하세요
6. 위 테스터에 URL을 붙여넣어 작동하는지 확인하세요

이 테스터의 작동 방식

웹후크 URL을 붙여넣고 확인을 클릭하세요. 도구가 Discord API로 URL을 검증하고 웹후크의 이름, 아바타, 연결된 채널을 보여줍니다. URL이 유효하면 원하는 메시지를 입력해 웹후크로 보내 정상 작동을 확인할 수 있습니다. 웹후크 URL은 보안을 위해 저희 서버를 거치지만 (브라우저는 CORS 때문에 Discord API를 직접 호출할 수 없습니다) 저장하거나 기록하지 않습니다.

자주 겪는 Discord 웹후크 오류 코드

웹후크 요청이 실패하면 Discord는 숫자 code와 message가 담긴 JSON 본문과 함께 HTTP 상태를 반환합니다. 실제로 마주치게 되는 것은 다음과 같습니다.

• 400 Bad Request - JSON 본문이 잘못되었거나, 임베드가 전체 6,000자를 넘었거나, 필드 길이가 제한을 초과했습니다. 보내기 전에 페이로드를 로컬에서 검증하세요.
• 401 Unauthorized - 웹후크 토큰이 틀렸거나 재발급되었습니다. 서버 설정에서 웹후크를 재발급하면 기존 URL은 즉시 무효가 됩니다.
• 404 Not Found - 웹후크가 삭제되었거나, 채널이 삭제되었거나, URL에 오타가 있습니다. 서버 설정 > 연동에서 URL을 다시 복사하세요.
• 429 Too Many Requests - 속도 제한에 걸렸습니다. Discord는 다시 시도할 시점을 알려주는 retry_after 필드를 초 단위로 반환합니다. 반드시 지키세요.
• Code 50027 (Invalid Webhook Token) - 401과 근본 원인이 같으며, URL의 토큰 부분이 손상되거나 잘렸을 때 반환됩니다.
• Code 50006 (Cannot send empty message) - 페이로드에 content도 embeds도 files도 없습니다. 최소한 하나는 있어야 합니다.
• Code 50035 (Invalid Form Body) - 가장 흔한 원인은 embed.color를 10진 정수가 아니라 16진 문자열로 보낸 경우입니다. 보내기 전에 #9B59B6를 10181046으로 변환하세요.

Discord 웹후크 속도 제한

Discord는 웹후크별, 채널별로 속도 제한을 적용하며, 버킷의 정확한 크기는 고정된 숫자가 아니라 서버에서 정해져 응답 헤더로 전달됩니다. 성공한 응답에는 항상 X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset-After가 들어 있습니다. 다음 요청을 계획할 때 이 값들을 읽고, 고정된 속도를 코드에 넣지 마세요. 429 응답 본문에는 retry_after 값도 초 단위로 담깁니다. 대량으로 보내는 연동(빌드 파이프라인, 로그 수집)에서는 여러 이벤트를 한 메시지로 묶으세요. 웹후크 한 번의 호출로 임베드를 최대 10개까지, 임베드당 합계 6,000자까지 보낼 수 있어 대개 이벤트가 몰릴 때도 요청 하나로 정리됩니다.

웹후크 보안 모범 사례

웹후크 URL은 소지자 자격 증명입니다. 전체 URL을 가진 사람은 누구나 별도의 인증 없이 웹후크 봇으로 채널에 글을 올릴 수 있습니다. 비밀번호처럼 다루세요.

• 웹후크 URL을 공개 Git 저장소에 커밋하지 마세요. GitHub의 시크릿 스캐닝이 유출된 Discord 웹후크를 자동으로 찾아 무효화하지만, 이미 노출된 뒤의 이야기입니다.
• 웹후크 URL은 환경 변수나 시크릿 매니저에 보관하고, 소스 코드나 버전 관리에 포함된 설정 파일에는 두지 마세요.
• 웹후크가 노출되면 서버 설정 > 연동 > 웹후크에서 즉시 삭제하세요. 다시 만들면 새 토큰이 발급되고 기존 URL은 작동을 멈춥니다.
• 클라이언트에서 사용할 때는(브라우저 앱에서 Discord로 게시하는 경우) 직접 만든 백엔드를 거쳐 호출해 URL이 사용자 브라우저에 닿지 않게 하세요. 브라우저 앱에서 유출된 URL은 악용을 부릅니다.
• Discord 웹후크는 allowed_mentions가 명시적으로 허용하지 않는 한 @everyone과 @here 멘션을 무시합니다. 멘션 알림이 필요 없다면 "parse": []로 설정하세요.

curl로 웹후크 직접 테스트하기

터미널에서 테스트하고 싶다면 최소 페이로드는 content 필드 하나입니다. POST가 성공하면 빈 본문과 함께 HTTP 204가 반환되고, URL에 ?wait=true를 붙이면 생성된 메시지 JSON과 함께 HTTP 200이 반환됩니다. 메시지 ID를 돌려받아야 할 때 ?wait=true를 쓰세요(예를 들어 나중에 /webhooks/<id>/<token>/messages/<message_id> 엔드포인트로 메시지를 수정하거나 삭제할 때입니다).

무료 Discord 도구 더 보기

• Snowflake Checker - Discord 계정의 생성 시점을 확인합니다
• Colored Text Generator - ANSI 코드로 색이 들어간 메시지를 만듭니다
• Message Length Counter - 메시지가 Discord 제한에 맞는지 확인합니다
• Color Role Previewer - 모든 Discord 테마에서 역할 색을 미리 봅니다

Powered by Pigona - Discord를 위한 무료 번역