Discord 웹후크

Discord 웹후크를 사용하면 그 URL을 아는 무엇이든 Discord 채널 하나에 글을 올릴 수 있습니다. Discord 웹후크 연동은 웹후크를 이름으로 저장하고, 메시지용 비주얼 편집기가 있는 액션 하나, Discord 웹후크 메시지 보내기를 제공합니다. Macro Deck이 실행 중인 컴퓨터에 Discord 앱이나 Discord 계정이 필요 없습니다.

보낼 수 있는 내용

편집기에는 탭이 네 개 있습니다.

• 메시지: Discord Markdown과 줄 바꿈을 쓸 수 있는 메시지 텍스트와, 사용자 또는 역할 멘션, @everyone, @here를 넣는 버튼.
• 임베드: 최대 10개의 임베드. 각각 제목과 제목 링크, 설명, 색상, 타임스탬프, 작성자, 바닥글, 이미지, 썸네일, 나란히 표시할 수 있는 필드 최대 25개를 가집니다.
• 프로필: 웹후크 자체의 것 대신 이 메시지에 쓸 사용자 이름과 아바타.
• 멘션: 메시지의 멘션으로 누구에게 알림을 보낼 수 있는지.

기본적으로 메시지는 누군가, @everyone 또는 @here를 멘션하더라도 아무에게도 알림을 보내지 않습니다. 멘션은 Discord에 그대로 표시되지만 알림만 가지 않습니다. 모든 텍스트 필드에서 템플릿 변수를 쓸 수 있고 액션이 실행될 때 값이 채워지므로, 메시지에 현재 장면, 노래, 시청자 수를 담을 수 있습니다.

편집기 아래의 미리 보기는 입력하는 대로 바뀌며 Discord가 그리는 모습 그대로 메시지를 보여 줍니다. 미리 보기는 Discord에 아무것도 보내지 않습니다. 이미지는 자리 표시자로 표시되고, 변수는 쓴 그대로 나타납니다. 테스트 메시지 보내기는 지금 보내기로 확인하면 메시지를 바로 Discord에 보내므로, 실제로 어떻게 보이는지 확인할 수 있습니다.

활용 예:

• 방송 제목과 링크가 담긴 임베드를 공지 채널에 올리는 방송 시작 버튼.
• 재생 중인 노래를 음악 채널에 올리는 버튼.
• 방송에서 무언가 일어나면 모더레이터 채널에 메시지를 보내는 자동화.

저장된 웹후크와 사용자 지정 URL

채널마다 구성을 하나씩 추가한 다음, 모든 액션에서 웹후크를 이름으로 고르세요. URL이 바뀌면 한 곳에서만 바꾸면 됩니다. 일회성 메시지라면 웹후크를 사용자 지정 URL로 설정하고 URL을 액션에 붙여 넣을 수도 있습니다. Macro Deck은 모든 웹후크 URL을 암호화해 저장하며, 다시 보여 주지 않고 로그에도 기록하지 않습니다.

Macro Deck은 보내기 전에 Discord의 제한을 확인합니다. 예를 들어 메시지 텍스트는 2000자, 모든 임베드를 합쳐 6000자까지이며, 편집하는 동안 문제가 있으면 미리 보기 위에 나열합니다. Discord가 웹후크의 게시 빈도를 제한하면, 대기 시간이 5초 이하일 때 Macro Deck이 기다렸다가 한 번 더 시도합니다.