공지
공지 기능은 서버 공지, 점검 안내, 이벤트 리마인더처럼 반복해서 올리는 메시지를 예약하는 곳이에요. 한 번만 보내는 공지와 매일·매주·매월 반복되는 공지를 만들 수 있고, 텍스트와 임베드를 함께 구성할 수 있어요.
이 기능은 슬래시 명령어로 즉석 공지를 쓰는 기능이 아니라 패널에서 일정을 만들어 두고 워커가 시간에 맞춰 보내는 구조예요.
무엇을 할 수 있나요?
| 기능 | 설명 |
|---|---|
| 1회 공지 | 특정 날짜와 시간에 한 번만 메시지를 보내요 |
| 반복 공지 | 매일, 매주, 매월 정해진 시간에 메시지를 보내요 |
| 대상 채널 | 공지가 올라갈 텍스트 채널을 선택해요 |
| 메시지 텍스트 | 일반 메시지 본문을 작성해요 |
| 임베드 | 제목, 설명, 색상, 이미지, 필드 같은 공지 카드 구성을 만들어요 |
| 변수 | 서버 이름, 현재 시간, 멤버 수 같은 값을 메시지에 넣어요 |
| 멘션 허용 | 필요할 때만 @everyone, @here 멘션을 열어요 |
| 테스트 발송 | 저장한 공지를 즉시 실행 대기 상태로 보내 확인해요 |
| 실행 이력 | 최근 실행 결과, 메시지 ID, 오류를 확인해요 |
처음 설정하는 순서
- 공지 페이지에서 새 일정을 눌러요.
- 나중에 알아보기 쉬운 이름을 적어요.
- 공지가 올라갈 대상 채널을 선택해요.
- 1회 또는 반복 실행을 선택해요.
- 날짜와 시간을 정해요. 반복이면 매일, 매주, 매월 중 하나를 골라요.
- 메시지 텍스트나 임베드를 작성해요.
- 전체 멘션이 필요하면 멘션 허용을 켜요.
- 저장한 뒤 테스트 발송으로 실제 채널 표시를 확인해요.
반복 일정
반복 일정은 현재 코드 기준으로 매일, 매주, 매월을 지원해요. 매주는 요일을 고르고, 매월은 날짜를 골라요. 시간대는 기본적으로 Asia/Seoul을 사용해요.
매월 31일처럼 달마다 없는 날짜를 고르면, 해당 달의 마지막 날짜로 맞춰 계산돼요. 예를 들어 2월에는 28일이나 29일로 계산될 수 있어요.
메시지와 변수
공지 문구에는 변수를 넣을 수 있어요. 패널에서 안내하는 기본 변수는 아래처럼 써요.
| 변수 | 의미 |
|---|---|
| {server} | 서버 이름 |
| {now} | 현재 시간 |
| {member_count} | 멤버 수 |
예를 들어 “{server} 점검 안내예요. 현재 멤버는 {member_count}명이에요.”처럼 쓸 수 있어요.
변수는 텍스트뿐 아니라 임베드 제목, 설명, 작성자, 푸터, 필드에도 반영돼요. 다만 지원되지 않는 변수명을 적으면 그대로 남아요.
멘션은 조심해서 켜요
기본값은 멘션 비허용이에요. @everyone이나 @here를 실제로 울리려면 멘션 허용을 켜고, 메시지 본문에도 해당 멘션이 들어가 있어야 해요.
운영 공지, 장애 안내, 긴급 점검처럼 모두가 알아야 하는 상황에만 켜는 편이 좋아요. 일반 이벤트나 주간 알림은 역할 멘션이나 일반 텍스트 안내가 더 안전해요.
상태와 실행 이력
공지 목록에서는 활성화 여부, 다음 실행 시간, 마지막 실행 시간, 마지막 상태를 확인해요. 상세 화면에서는 최근 실행 이력을 볼 수 있어요.
실패가 보이면 먼저 대상 채널이 삭제됐는지, 봇에게 메시지 보내기와 임베드 링크 권한이 있는지, 채널 검증이 가능한지 확인해요. 실행 이력에는 성공, 실패, 대기 상태와 오류 내용이 남아요.
AI와 함께 만들 수 있어요
Architect는 공지 스케줄을 만들거나 수정하는 작업도 제안할 수 있어요. 예를 들어 “매주 금요일 저녁 8시에 주말 이벤트 안내를 공지 채널에 올려줘”처럼 말하면 일정 초안을 만들 수 있어요.
다만 실제 발송은 서버에 영향을 주는 작업이에요. 그래서 채널, 일정, 멘션 여부, 메시지 내용을 확인하고 승인한 뒤 적용하는 흐름으로 보는 게 맞아요.
과장하면 안 되는 것
- 공지는 실시간 채팅봇 명령어가 아니라 예약 작업이에요.
- 모든 반복 규칙을 지원하지는 않아요. 현재는 매일, 매주, 매월 중심이에요.
- Discord 권한이나 채널 삭제 문제는 자동으로 해결하지 않아요.
- 전체 멘션은 기본으로 막혀 있어요. 필요할 때만 명시적으로 켜요.
- 발송 시각은 워커 실행 주기와 Discord API 상태의 영향을 받을 수 있어요.
캡처 기준
| 캡처 | 보여 줄 내용 |
|---|---|
| 공지 목록 | 일정 카드, 활성 상태, 다음 실행, 마지막 상태 |
| 새 일정 만들기 | 이름, 대상 채널, 1회·반복 선택 |
| 메시지 작성 | 텍스트, 임베드, 변수 삽입 영역 |
| 테스트 발송 | 저장 후 테스트 발송 버튼과 상태 변화 |
| 실행 이력 | 성공·실패 기록, 메시지 ID, 오류 상세 |
| Discord 결과 | 실제 공지 채널에 올라간 메시지와 임베드 |