준비 중인 채널

Discord

포샌디로 AI가 Discord 채널에 올리게 될 방법이에요. 글 채널 하나에 만드는 웹후크, 기본으로 알림이 안 가는 멘션, 웹후크로 안 되는 것을 정리했어요.

준비 중인 채널이에요. 아래는 연결이 열리면 쓰게 될 방법이에요. 열리면 블로그와 이 페이지에 알려드려요.

연결 방법: 웹후크 하나로

봇도 플랫폼 심사도 없이, 웹후크 하나로 연결하게 돼요.

Discord에서 서버 설정 > 연동 > 웹후크로 가요.
'새 웹후크'를 누르고 글을 올릴 글 채널을 골라요.
'웹후크 URL 복사'를 눌러요.
복사한 URL을 대시보드에 붙여넣어요.

그 서버에서 웹후크 관리 권한이 있어야 해요. 포럼 채널과 미디어 채널은 안 돼요. 이 채널들은 글마다 새 스레드를 열어야 하기 때문이에요.

한눈에

항목	종류	값
글자 수	텍스트	2,000
이미지	미디어	글 하나에 10장까지. 더 넣으면 앞의 10장만 올라가고 경고가 붙어요
캐러셀	미디어	2~10개, 이미지와 영상 섞기 가능
영상	미디어	글 하나에 10개
텍스트만	미디어	가능
24시간 발행	한도	28,800
24시간 삭제	한도	이 웹후크가 보낸 메시지만 삭제 가능, 하루 한도는 공개된 값 없음
상태	상태	준비 중

연결이 열리면 서버가 이 값으로 검사하게 돼요. 메시지 하나에 2,000자, 첨부 10개까지 들어가요. 글자는 코드포인트로 세서 이모지도 1자예요. 첨부 파일은 하나에 20MB까지예요.

@everyone을 써도 알림이 안 가는 이유

포샌디는 따로 정하지 않으면 Discord 메시지의 멘션 알림을 꺼서 보내게 돼요. @everyone, @here, 역할, 사람 멘션이 글자로만 보이고 아무에게도 알림이 가지 않아요. AI가 실수로 서버 전체에 알림을 보내는 일을 막으려는 거예요.

원하는 것	`options.discord.mentions` 값
아무에게도 알림 안 보내기	`none` (기본값)
멘션한 사람에게만 알리기	`users`
역할, @everyone, @here까지 알리기	`all`

첫 글 올리기

본문이나 첨부, 또는 둘 다 넣어 publish를 부르게 돼요. Discord가 마크다운을 직접 그려서 굵게, 목록, 링크가 쓴 대로 보여요.

curl -X POST https://api.posendy.com/v1/posts \
  -H "Authorization: Bearer $POSENDY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Release notes are up. **v2.4** ships today.",
    "accountIds": ["conn_..."],
    "options": { "discord": { "silent": true } }
  }'

options.discord 값

이름	타입	설명
`username`	string	이 메시지 하나에만 보일 보낸 사람 이름이에요. 1~80자. 빼면 웹후크 이름을 써요. 이름에 "discord"나 "clyde"가 들어가면 Discord가 거절해요.
`silent`	boolean	푸시 알림이나 데스크톱 알림 없이 올려요(Discord의 @silent).
`suppressEmbeds`	boolean	본문에 있는 URL의 링크 미리보기를 안 보여줘요.
`mentions`	`none` / `users` / `all`	본문의 멘션이 실제로 누구에게 알림을 보낼지 정해요. `none`(기본값): 아무에게도 안 가요. @everyone, @here, 역할과 사람 멘션은 글자로만 보여요. `users`: 멘션한 사람에게만 가요. `all`: 사람, 역할, @everyone, @here 모두에게 가요. `all`은 사용자가 서버 전체에 알리라고 했을 때만 써요.
`content`	string	이 채널에만 보낼 본문이에요. 넣으면 공통 본문 대신 이 값이 나가고, 글자 수와 미디어 검사도 이 값으로 해요. 안 넣으면 공통 본문을 써요.

모두 넣지 않아도 되는 값이에요. 다른 채널과 같이, 이 채널에만 보낼 본문 content도 받게 돼요.

안 되는 것

답글, 댓글, 채널 메시지 목록: 웹후크는 올리기만 하고 채널을 읽지 못해요. 그래서 list_replies, reply, list_channel_posts는 지원하지 않는다고 답하게 돼요.
수정은 본문만 바꾸고 첨부는 그대로 둬요.
삭제는 이 웹후크가 보낸 메시지만 돼요.
숫자는 반응 수 합계 하나만 받아요.

자주 묻는 것

포샌디가 내 Discord 계정이나 서버를 보나요?

아니요. 내가 만든 웹후크 URL을 암호화해서 보관하고, 그걸로 올리기만 해요. 웹후크는 연결된 채널 하나에 올리는 일만 할 수 있고, 메시지나 멤버를 읽지 못해요.

Discord에서 웹후크를 지우면 어떻게 되나요?

다음 발행이 실패하고 연결 상태가 '만료'로 바뀌어요. 웹후크를 새로 만들고, 그 URL로 다시 연결해요. 반대로 포샌디에서 연결을 끊어도 Discord의 웹후크는 지워지지 않아요. 더 쓰지 않으면 Discord에서 직접 지워요.

포럼 채널은 왜 거절되나요?

포럼 채널과 미디어 채널은 글마다 새 스레드를 열어야 하는데, 포샌디는 스레드를 만들지 않아요. 일반 글 채널에 웹후크를 만들어요.

이전Pinterest 다음Ghost