키라봇
SOOP 스트리머 유키라의 방송 시작과 종료, 방송 제목 변경, 방송국 게시글, 유튜브 새 영상을 디스코드 채널로 알려 주는 봇입니다.
서버에 추가한 뒤 알림을 받을 채널에서 /키라봇설정 전체를 켜기로 입력하면 바로 시작합니다.
- 누구를 위한 봇인가요
- 디스코드 서버 관리자
- 어디에서 쓰나요
- 디스코드 텍스트·공지 채널
- 상태
- 운영 중
받을 수 있는 알림
알림 종류마다 받을 채널을 따로 정할 수 있습니다. 새로 추가한 서버는 모든 알림이 꺼진 상태로 시작합니다.
방송 시작과 종료
방송이 켜지고 꺼질 때 방송 제목과 방송 화면 이미지를 함께 보냅니다.
/키라봇설정 방송시작/키라봇설정 방송종료방송 제목 변경
방송 중에 제목이 바뀌면 이전 제목과 현재 제목을 나란히 보여 줍니다.
/키라봇설정 방제변경숲 게시글
방송국에 새 글이 올라오면 글을 이미지로 만들어 보냅니다. 이미지를 만들지 못하면 글로 보냅니다.
/키라봇설정 숲게시글유튜브 새 영상
새 영상이 올라오면 링크를 보내고, 디스코드의 유튜브 미리보기로 바로 볼 수 있습니다.
/키라봇설정 유튜브
이렇게 도착해요
실제 알림 형식을 그대로 옮긴 예시입니다. 방송·게시글 알림은 제목을 누르면 원문으로 이동합니다.
방송 제목과 게시글, 영상 제목은 예시로 새로 쓴 것입니다. 게시글 이미지는 실제로는 원문 글을 그대로 그린 그림입니다.
명령어
모든 명령은 서버 주인이나 관리자 권한이 있는 사람만 쓸 수 있고, 결과는 명령을 입력한 사람에게만 보입니다.
설정 명령은 알림을 받을 일반 텍스트 채널이나 공지 채널에서 입력합니다. 켜기를 고르면 그 채널이 알림을 받는 채널이 됩니다.
/키라봇사용법- 키라봇 사용법을 확인합니다.
/키라봇현황- 이 서버에서 켠 알림 종류와 알림을 받는 채널을 확인합니다.
/키라봇설정 전체켜기 / 끄기- 모든 알림을 이 채널로 켜거나, 이 서버의 모든 알림을 끕니다.
/키라봇설정 방송시작켜기 / 끄기- 방송 시작 알림을 이 채널에서 받거나 끕니다.
/키라봇설정 방송종료켜기 / 끄기- 방송 종료 알림을 이 채널에서 받거나 끕니다.
/키라봇설정 방제변경켜기 / 끄기- 방송 중 제목 변경 알림을 이 채널에서 받거나 끕니다.
/키라봇설정 숲게시글켜기 / 끄기- 방송국 게시글 알림을 이 채널에서 받거나 끕니다.
/키라봇설정 유튜브켜기 / 끄기- 유튜브 업로드 알림을 이 채널에서 받거나 끕니다.
요청하는 권한
알림을 켤 때 키라봇이 그 채널에서 아래 네 가지 권한을 가졌는지 확인하고, 없으면 무엇이 빠졌는지 알려 줍니다.
- 채널 보기
- 알림을 보낼 채널에 들어가기 위해 필요합니다.
- 메시지 보내기
- 알림 메시지를 보내기 위해 필요합니다.
- 링크 첨부
- 방송·게시글 알림을 카드 모양으로 보여 주고, 유튜브 미리보기를 띄우기 위해 필요합니다.
- 파일 첨부
- 방송 화면 이미지와 게시글 이미지를 함께 보내기 위해 필요합니다.
- 관리자(Administrator) 권한은 요청하지 않습니다.
- 서버의 대화 내용이나 멤버 목록을 읽는 권한을 쓰지 않습니다.
어떻게 동작하나요
공개된 정보만 확인합니다. 방송 상태는 공개 방송 정보와 SOOP 공식 API를 함께 써서 확인하고, 유튜브는 YouTube Data API로 새 영상을 확인합니다.
잠깐의 오류를 방송 종료로 보지 않습니다. 조회에 실패한 것과 방송이 끝난 것을 구분해서, 일시적인 오류 때문에 종료 알림이 가지 않게 합니다.
처음 연결할 때 지난 소식을 한꺼번에 보내지 않습니다. 처음에는 현재 상태만 기억하고, 그 뒤에 생긴 소식부터 알립니다.
알림은 몇 분 늦을 수 있습니다. 일정한 간격으로 확인하는 방식이라 바로 도착하지 않을 수 있고, 아주 짧게 켰다 끈 방송은 알리지 못할 수 있습니다.