Discord 웹훅 만들기

원래 작성자의 이름과 아바타로 복사본을 전달하고, 웹훅을 직접 만들거나 기존 Discord 봇으로 웹훅 전달을 시험합니다.

Discord 웹훅을 사용하면 ForwardMsg가 원래 작성자의 이름과 프로필 사진으로 복사된 메시지를 Discord 텍스트 채널에 보낼 수 있습니다. 예를 들어 Maya의 메시지는 Maya의 이름과 사진으로 도착하고, 다음에 Tom이 보낸 메시지는 Tom의 이름과 사진으로 도착합니다.

Discord로 복사본을 보내는 가장 간단한 방법인 경우가 많습니다. 봇을 만들거나 초대하지 않아도 됩니다. 봇 토큰이나 인텐트 및 권한 설정도 필요하지 않습니다. 수신 채널에서 웹훅을 만들고 URL을 ForwardMsg에 붙여넣으면 됩니다.

웹훅은 메시지를 보내지만 원본 채팅을 읽지는 않습니다. 연결된 계정이나 봇이 원본을 읽습니다. 웹훅 하나는 수신 채널 하나에 연결되지만 같은 자동화에 다른 대상을 추가할 수 있습니다.

웹훅과 Discord 봇 중 무엇을 선택하나요?

원하는 기능	Discord 웹훅	웹훅 모드를 사용하지 않는 Discord 봇
각 원래 작성자의 이름과 사진 사용	네. 복사된 메시지마다 달라질 수 있습니다.	복사본에는 봇 자체 이름과 사진이 표시됩니다.
전달 설정	웹훅을 만들고 URL을 붙여넣습니다. 봇 설정은 필요하지 않습니다.	봇을 만들고 연결하고 초대한 뒤 채널 접근 권한을 부여합니다.
텍스트, 이미지, 동영상, 파일 보내기	네. 미디어 기능을 활성화하고 업로드 제한을 넘지 않아야 합니다.	네. 미디어 기능, 파일 권한이 필요하며 업로드 제한을 넘지 않아야 합니다.
편집 및 삭제 미러링	네. ForwardMsg가 이미 복사한 메시지에 대해 해당 옵션을 켜면 작동합니다.	네. 해당 옵션을 켜면 작동합니다.
연결된 답장 및 고정/고정 해제 미러링	지원하지 않습니다.	네. 관련 권한과 미러 옵션을 켜야 합니다.

원본 대화처럼 복사본을 보이고 싶다면 웹훅을 선택하세요. Discord의 연결된 답장이나 고정/고정 해제 미러링이 필요하면 Discord 봇을 선택하세요. 해당 옵션은 답장, 편집 및 고정 동기화를 참조하세요.

기존 봇으로 웹훅 시험

이미 Discord 봇으로 전달 중이라면 그 봇과 현재 라우팅 대상을 그대로 사용하세요. 시험하려고 웹훅을 직접 만들거나 수신 채널을 바꿀 필요가 없습니다.

Discord에서 기존 봇에 수신 채널별로 Manage Webhooks 권한을 부여합니다. 봇 역할을 편집하려면 Server Settings → Roles를 열고, 특정 채널에 허용하려면 Edit Channel → Permissions를 엽니다. 기존 전달 권한은 유지하고 채널 규칙이 접근을 거부하지 않는지 확인하세요.
ForwardMsg에서 자동화를 열고 편집기 왼쪽 목록의 소스 채팅을 클릭해 설정을 엽니다.
고급 → 작성자 이름과 아바타 사진으로 보내기를 엽니다.
웹훅 활성화를 켭니다.
변경 사항 저장을 선택합니다. ForwardMsg에서 재시작 경고가 표시되면 자동화를 재시작하세요.
원본 채팅에서 새 메시지를 복사했을 때 원래 작성자의 이름과 사진이 표시되는지 확인합니다. 사용자 지정 작성자 재정의를 설정했다면 그 값이 표시될 수 있습니다.

ForwardMsg는 봇으로 수신 채널의 웹훅을 자동으로 만들거나 관리합니다. 저장된 봇과 라우팅은 그대로 유지되며 복사본을 게시하는 방법만 바뀝니다. 일반 봇 전달로 돌아가려면 웹훅 활성화를 끄고 다시 저장하세요.

다른 채팅에도 이 설정이 상속되게 하려면 원본 채팅 하나를 선택하는 대신 전역 설정을 사용하세요. 채팅별 재정의는 설정 작동 방식을 참조하세요.

답장과 고정에는 일반 봇 전달을 사용하세요

이 모드에서는 원래 작성자의 이름과 사진으로 복사본을 보낼 수 있지만 연결된 답장과 고정/고정 해제 미러링은 사용할 수 없습니다. 해당 작업이 필요한 경로에는 일반 봇 전달을 유지하세요.

일반 텍스트 채널에서 이 설정을 사용하세요. 스레드나 포럼/미디어 채널의 게시물에는 봇 전달을 유지하세요.

다음 섹션은 봇을 사용하지 않고 직접 웹훅을 만드는 방법입니다.

웹훅을 직접 만들거나 대신 만들어 주는 사람에게 수신 Discord 채널의 Manage Webhooks 권한이 필요합니다. 서버 소유자일 필요가 없습니다. 봇에 Administrator 권한을 부여할 필요도 없습니다. Webhooks 제어 항목이 보이지 않으면 서버 관리자에게 권한을 부여하거나 대신 웹훅을 만들어 달라고 요청하세요. Discord에서 웹훅을 만들려면 이 권한이 필요합니다.

Discord에서 수신 텍스트 채널의 설정을 엽니다. 이 설정에서는 스레드나 포럼/미디어 게시물이 아니라 일반 텍스트 채널을 사용하세요.
Integrations → Webhooks를 엽니다.
New Webhook(또는 현재 표시되는 해당 항목)을 선택합니다.
알아보기 쉬운 이름을 지정합니다.
복사본을 받을 채널에 연결되어 있는지 확인합니다.
Copy Webhook URL을 선택합니다. URL을 아는 사람은 채널에 메시지를 게시할 수 있으므로 비공개로 보관하세요.
ForwardMsg에서 왼쪽 목록의 모니터링 중인 소스 채팅을 클릭해 설정을 엽니다.
라우팅을 엽니다.
Discord 웹훅 추가를 선택해 웹훅 대상 행을 추가합니다.
해당 행의 웹훅 선택기를 열고 Discord 웹훅 추가를 선택합니다. 웹훅이 이미 저장되어 있으면 선택하고 변경 사항 저장으로 넘어갑니다.
URL을 붙여넣고 추가를 선택합니다.
ForwardMsg에서 웹훅 이름을 유지하거나 변경합니다. 이름을 바꿨다면 저장, 그대로 두려면 닫기를 선택합니다.
라우팅 행에서 웹훅이 선택되어 있는지 확인한 다음 변경 사항 저장을 선택합니다. ForwardMsg에서 재시작 경고가 표시되면 전달을 확인하기 전에 자동화를 재시작하세요.

원본 채팅의 새 메시지를 복사할 때 수신 채널을 확인합니다. Discord 웹훅 추가로 추가한 대상에는 웹훅 활성화가 필요하지 않습니다. 이 옵션은 봇 대상용입니다.

고급 옵션

원래 작성자 대신 모든 복사본에 본인의 브랜드를 표시하고 싶다면 왼쪽 목록에서 소스 채팅을 클릭해 설정을 열고 라우팅 → 웹훅 작성자 재정의를 엽니다. Community Updates 같은 사용자 지정 작성자 이름과 로고 링크 같은 사용자 지정 아바타 URL을 설정하세요. 그런 다음 변경 사항 저장을 선택합니다.

사용자 지정 재정의가 없으면 복사본에는 원래 작성자의 이름과 사진이 사용됩니다. 필드를 비워 두어도 전역 설정이나 상위 채팅의 사용자 지정 값을 상속할 수 있습니다. 복사본에 고정 이름이나 사진이 계속 표시되면 해당 설정도 확인하세요. 설정 작동 방식을 참조하세요.

이 설정은 웹훅으로 전달되는 복사본의 작성자 정보에 적용되며 Discord 봇 이름은 바꾸지 않습니다. 사용자 지정 웹훅 이름 및 이미지를 참조하세요.

웹훅 업로드 제한

업로드 제한은 자동화가 전달하는 전체 용량이 아니라 파일마다 적용됩니다. ForwardMsg는 Discord 웹훅에 10 MB 기본 제한을 사용합니다. 연결된 봇을 통해 서버의 업로드 제한을 확인할 수 있으면 더 높은 감지된 제한을 자동으로 사용할 수 있습니다.

URL로 추가한 웹훅은 웹훅 업로드 부스트를 수신 서버의 지원 부스트 레벨과 맞추세요.

현재 레벨을 확인하려면 서버 소유자나 관리자가 Discord 채널 목록 위쪽의 Server Boosts를 열어 레벨과 활성 혜택을 확인할 수 있습니다. 메뉴를 열 수 없다면 수신 서버의 레벨을 먼저 확인해 달라고 요청한 뒤 덮어쓰기 값을 선택하세요.

사용할 업로드 허용량	ForwardMsg 설정	파일당 ForwardMsg 제한
더 높은 제한을 감지하지 못했을 때 기본값	상속된 설정을 포함해 업로드 부스트 재정의를 설정하지 않음	기본 10 MB
부스트 레벨 2	업로드 부스트 활성화 → 레벨 2	50 MB
부스트 레벨 3	업로드 부스트 활성화 → 레벨 3	100 MB

자동화를 열고 왼쪽 목록에서 파일을 전달할 소스 채팅을 클릭해 설정을 엽니다.
고급 → 웹훅 업로드 부스트를 엽니다.
업로드 부스트 활성화를 켭니다.
수신 서버가 실제로 사용하는 부스트 레벨을 선택합니다.
변경 사항 저장을 선택합니다. ForwardMsg에서 재시작 경고가 표시되면 자동화를 재시작하세요.

설정을 상속하는 채팅에는 전역 설정에서 설정할 수도 있습니다. 한 채팅에서 끄면 해당 채팅의 재정의가 해제되지만 전역 설정이나 상위 채팅에서 설정한 부스트 레벨은 계속 적용될 수 있습니다. 기본값으로 되돌리려면 설정 작동 방식에서 상속된 설정을 확인하세요.

예를 들어 20 MB 동영상은 기본 10 MB 제한보다 큽니다. 수신 서버가 레벨 2라면 레벨 2를 선택해 서버의 50 MB 허용량 안에서 업로드할 수 있습니다. 전달 옵션에서 동영상 기능도 켜야 합니다.

이 설정은 Discord 업로드 허용량을 구매하거나 늘리지 않습니다

레벨 3을 선택해도 부스트하지 않은 서버의 업로드 제한이 100 MB로 바뀌지 않습니다. 본인의 Nitro 허용량도 웹훅 제한을 높이지 않습니다. 수신 서버가 실제로 허용하는 용량에 맞추세요. 그 용량을 넘는 파일은 Discord에서 거부될 수 있습니다.

원본 채팅 하나의 부스트 설정은 수신 서버마다 따로 적용되지 않고 해당 채팅의 모든 웹훅 대상에 적용됩니다. 모든 대상 서버가 지원하는 레벨을 선택하세요. 별도의 채팅 설정은 원본 채팅마다 대상이 다를 때만 도움이 됩니다.

레벨 2와 레벨 3의 허용량은 Discord 서버 부스트 FAQ를 참조하세요. 자세한 내용은 업로드 제한과 웹훅 업로드 부스트를 확인하세요.

웹훅 전달이 중단된 경우

직접 추가한 웹훅: 수신 채널에 아직 있는지, 라우팅 대상이 올바르게 저장된 웹훅을 사용하는지 확인합니다. 삭제되었다면 대체 웹훅을 만들고 저장하세요. URL이 노출된 경우 해당 웹훅을 삭제하고 새로 만드세요. URL을 지원팀이나 공개 메시지에 공유하지 마세요.
봇을 사용하는 웹훅 모드: 봇의 기존 채널 접근 및 전달 권한과 함께 해당 채널의 Manage Webhooks 권한을 확인합니다.
큰 파일만 실패: 파일 크기, 수신 서버의 부스트 레벨, 위의 웹훅 업로드 부스트를 확인합니다.

Discord의 웹훅 제어 항목은 웹훅 소개를 참조하세요. 채널 접근 문제는 전달 및 권한 문제를 참조하세요.