9o도리 소개
치지직(Chzzk) 스트리머를 위한 챗봇 서비스입니다.
9o도리는 방송 중 시청자와의 상호작용을 더욱 풍부하게 만들어드립니다.
봇 초대부터 시작해 커스텀 명령어, 신청곡, 투표 등 다양한 기능을 간편하게 설정할 수 있습니다.
주요 기능
📝
커스텀 명령어
원하는 명령어를 직접 만들어 봇이 자동으로 응답하도록 설정합니다.
🎵
신청곡
시청자가 유튜브 곡을 신청하면 스트리머 화면에서 바로 재생됩니다.
📊
투표
채팅 명령어로 실시간 투표를 진행하고 결과를 확인합니다.
⏱
매크로
일정 간격으로 공지, 링크 등을 자동으로 채팅에 전송합니다.
📅
방송 시간표
요일별 방송 일정을 등록해 시청자가 확인할 수 있게 공유합니다.
🚫
채팅 관리
사용자 차단, 타임아웃 및 채팅 키워드 필터를 관리합니다.
💡
9o도리가 처음이라면 봇 초대 방법부터 시작하세요.
봇 초대 방법
봇이 채팅방에서 동작하려면 먼저 채널 관리자로 봇 계정을 추가해야 합니다.
초대 절차
- 치지직 스튜디오의 채널/권한 관리 메뉴의 권한 관리 메뉴로 이동합니다.
- 권한 관리 입력창에 9o도리 봇 계정의 닉네임을 입력합니다.
- 검색된 봇 계정을 채팅 매니저 권한으로 추가합니다.
ℹ️
봇이 채팅방에 정상 입장하면
방송이 인식됐습니다 👋 메시지가 자동으로 출력됩니다.
봇이 입장하지 않을 때
- 방송 시작 후 봇이 입장하는 데 최대 1분 정도 소요될 수 있습니다.
!방송인식명령어를 채팅에 입력해 봇의 인식 여부를 확인할 수 있습니다.
⚠️
봇은 방송 중일 때만 채팅방에 입장합니다. 방송이 종료되면 봇은 자동으로 비활성화됩니다.
로그인 & 대시보드
대시보드에서 봇의 모든 기능을 설정하고 관리할 수 있습니다.
로그인 방법
- 9o도리 웹사이트에 접속합니다.
- 상단의 로그인 버튼을 클릭합니다.
- 치지직 계정으로 OAuth 인증을 진행합니다.
- 인증 완료 후 대시보드로 자동 이동됩니다.
ℹ️
로그인에 사용하는 치지직 계정이 봇을 설정할 채널의 소유자여야 합니다.
대시보드 메뉴 구성
| 메뉴 | 설명 |
|---|---|
| 명령어 | 기본 명령어 확인 및 커스텀 명령어 추가/관리 |
| 신청곡 | 신청곡 플러그인 설정 및 대기열 관리 |
| 투표 | 실시간 투표 생성 및 진행 |
| 매크로 | 자동 채팅 전송 설정 |
| 시간표 | 방송 일정 등록 및 관리 |
| 채팅 관리 | 사용자 제한 및 채팅 키워드 필터 |
기본 명령어
별도 설정 없이 바로 사용할 수 있는 내장 명령어 목록입니다.
| 명령어 | 설명 | 비고 |
|---|---|---|
!명령어 |
명령어 목록 페이지 URL을 채팅에 출력합니다 | |
!방송인식 |
봇이 현재 방송을 인식 중인지 확인합니다 | |
!시간표 |
방송 시간표 페이지 URL을 채팅에 출력합니다 | |
!리스트 / !sl |
신청곡 대기열 페이지 URL을 채팅에 출력합니다 | |
!방제변경 [제목]!title [제목] |
방송 제목을 변경합니다 | 스트리머 전용 |
!신청곡 [검색어/URL]!sr [검색어/URL] |
유튜브 신청곡을 대기열에 추가합니다 | 신청곡 플러그인 |
!투표 [번호] |
진행 중인 투표에 참여합니다 | 투표 플러그인 |
ℹ️
!리스트와 !sl은 신청곡 ON/OFF 상태와 무관하게 항상 동작합니다.
커스텀 명령어
직접 만든 명령어로 봇이 원하는 내용을 자동으로 응답하도록 설정합니다.
명령어 추가
- 대시보드 상단 메뉴에서 명령어를 클릭합니다.
- 오른쪽 상단 + 추가 버튼을 클릭합니다.
- 트리거와 응답 내용을 입력하고 옵션을 설정한 뒤 저장합니다.
설정 항목
| 항목 | 설명 |
|---|---|
| 트리거 | 명령어를 실행시키는 텍스트입니다. 예: !안녕 |
| 응답 | 봇이 채팅에 출력할 메시지입니다. 시스템 변수를 사용할 수 있습니다. |
| 매치 타입 | 트리거를 인식하는 방식입니다. 아래 설명을 참고하세요. |
| 쿨타임 | 동일 명령어 재사용 대기 시간입니다. 최소 5초. |
| 권한 | 명령어를 사용할 수 있는 역할입니다. 모두 / 매니저 / 스트리머. |
매치 타입
| 타입 | 동작 방식 | 예시 |
|---|---|---|
| 정확히 일치 | 채팅 메시지 전체가 트리거와 동일할 때만 반응 | 트리거 !안녕 → "!안녕"에만 반응 |
| 포함 | 채팅 메시지에 트리거 텍스트가 포함되면 반응 | 트리거 안녕 → "안녕하세요", "안녕~" 등에 반응 |
| 시작 | 채팅 메시지가 트리거 텍스트로 시작하면 반응 | 트리거 !말해봐 → "!말해봐 오늘 날씨"에 반응 |
빠른 시작 — 예시 명령어 추가
명령어 페이지 하단 예시 명령어 섹션에서 자주 쓰는 명령어를 바로 추가할 수 있습니다.
| 트리거 | 응답 예시 |
|---|---|
!팔로우 | {user}님은 $(followage)일 째 팔로우 중입니다. |
!출석 | {user}님의 출석 횟수는 $(attendance)입니다. |
!주사위 | {user}님의 주사위 결과: $(random 1|2|3|4|5|6) |
시스템 변수
응답 메시지에 동적 값을 삽입할 때 사용하는 특수 변수입니다.
| 변수 | 설명 | 출력 예시 |
|---|---|---|
{user} |
명령어를 입력한 시청자 닉네임 | 홍길동 |
$(input) |
명령어 뒤에 입력한 텍스트 | 안녕하세요 |
$(category) |
현재 방송의 카테고리명 | Just Chatting |
$(uptime) |
방송 시작 후 경과 시간 | 1시간 23분 |
$(followage) |
팔로우 기간 (숫자, 단위 없음) | 30 |
$(attendance) |
시청자의 출석 누적 횟수 | 5 |
$(count) |
해당 명령어가 사용된 총 횟수 | 42 |
$(random 항목1|항목2|항목3) |
|로 구분된 항목 중 하나를 무작위로 출력 |
항목2 |
사용 예시
| 응답 설정 | 출력 결과 |
|---|---|
{user}님은 $(followage)일 째 팔로우 중입니다. |
홍길동님은 30일 째 팔로우 중입니다. |
{user}님의 주사위: $(random 1|2|3|4|5|6) |
홍길동님의 주사위: 4 |
{user}님이 $(count)번 째 갈고리 수집 중 |
홍길동님이 15번 째 갈고리 수집 중 |
ℹ️
$(followage)는 일(day) 단위의 숫자만 반환합니다. 단위는 응답에서 직접 붙여 사용하세요. 예: $(followage)일 째
신청곡
시청자가 유튜브 곡을 신청하면 스트리머 화면에서 순서대로 재생됩니다.
시청자 명령어
| 명령어 | 설명 |
|---|---|
!신청곡 [검색어] / !sr [검색어] |
검색어로 유튜브를 검색해 대기열에 추가합니다 |
!sr [유튜브 URL] |
유튜브 URL로 직접 신청합니다 |
!리스트 / !sl |
현재 신청곡 대기열 페이지 URL을 채팅에 출력합니다 |
스트리머 대시보드
- ON/OFF 토글 — 신청곡 기능을 켜고 끕니다
- 건너뛰기 — 현재 재생 중인 곡을 건너뜁니다
- 완료 삭제 — 재생이 끝난 곡을 대기열에서 정리합니다
- 볼륨 슬라이더 — 재생 볼륨을 조절합니다
- 대기열 삭제(✕) — 개별 신청곡을 대기열에서 제거합니다
설정 옵션 (⚙ 설정)
| 설정 | 설명 |
|---|---|
| 대기열 최대 곡 수 | 전체 대기열에 쌓일 수 있는 최대 곡 수 (1~200) |
| 유저당 최대 예약 수 | 한 명이 동시에 예약할 수 있는 최대 곡 수 (1~20) |
| 신청 최소 권한 | 신청 가능한 최소 권한 (모든 시청자 / 매니저 이상 / 스트리머만) |
| 유저당 한도 면제 | 예약 수 제한을 면제받는 권한 |
| 뮤직 카테고리만 허용 | YouTube Music 카테고리 영상만 신청 가능하도록 제한 |
| 좋아요 > 싫어요인 영상만 허용 | 좋아요 수가 싫어요보다 많은 영상만 신청 가능하도록 제한 |
⚠️
재생 시간이 10분을 초과하는 영상은 신청할 수 없습니다.
지원 URL 형식:
지원 URL 형식:
youtube.com/watch?v=... 또는 youtu.be/...
투표
채팅 명령어로 실시간 투표를 진행하고 대시보드에서 결과를 확인합니다.
투표 진행 방법
- 대시보드 > 투표 메뉴로 이동합니다.
- 투표 항목을 2개 이상 입력합니다.
- 투표 시작 버튼을 클릭합니다.
- 시청자는 채팅에
!투표 1,!투표 2등으로 참여합니다. - 결과를 확인한 후 투표 종료 버튼을 클릭합니다.
시청자 명령어
| 명령어 | 설명 |
|---|---|
!투표 [번호] |
해당 번호의 항목에 투표합니다. 1인 1표이며 변경 불가합니다. |
ℹ️
투표는 1인 1표로 진행됩니다. 중복 투표 및 투표 변경은 불가합니다.
매크로
일정 시간 간격으로 봇이 자동으로 채팅 메시지를 전송합니다.
유튜브 채널 링크, 반복 공지, 이벤트 안내 등 주기적으로 알려야 하는 내용을 자동화할 때 유용합니다.
매크로 추가
- 대시보드 > 매크로 메뉴로 이동합니다.
- + 추가 버튼을 클릭합니다.
- 이름, 메시지, 반복 간격(분)을 입력하고 저장합니다.
- 목록의 토글 스위치로 활성화/비활성화를 조절합니다.
설정 항목
| 항목 | 설명 |
|---|---|
| 이름 | 매크로를 구분하기 위한 이름입니다. |
| 메시지 | 채팅에 전송될 내용입니다. |
| 반복 간격 | 메시지 전송 간격입니다. 1분 ~ 1440분(24시간) 사이로 설정합니다. |
| 활성화 | 토글로 매크로를 켜고 끌 수 있습니다. |
⚠️
매크로는 방송 중일 때만 전송됩니다. 방송이 종료되면 자동으로 멈춥니다.
방송 시간표
요일별 방송 일정을 등록해 시청자가 언제든 확인할 수 있도록 공유합니다.
시간표 등록
- 대시보드 > 시간표 메뉴로 이동합니다.
- 방송하는 요일과 시작/종료 시간을 입력합니다.
- 저장하면 공개 시간표 링크가 자동으로 생성됩니다.
명령어
| 명령어 | 설명 |
|---|---|
!시간표 |
채팅에 시간표 페이지 URL을 출력합니다. 시청자가 클릭해 바로 확인할 수 있습니다. |
ℹ️
시간표 페이지는 로그인 없이 누구나 접근할 수 있는 공개 페이지입니다.
채팅 관리
특정 사용자를 제한하거나 채팅 키워드 필터를 설정합니다.
⚠️
채팅 관리의 모든 기능은 봇 계정이 채팅 매니저로 등록된 경우에만 작동합니다.
치지직 채널 관리 → 채팅 관리자 설정에서 봇 계정을 매니저로 추가해주세요.
치지직 채널 관리 → 채팅 관리자 설정에서 봇 계정을 매니저로 추가해주세요.
매니저 등록 방법
- 치지직 스튜디오 설정 → 채팅 관리자 메뉴로 이동합니다.
- 봇 계정 닉네임을 검색해 매니저 권한으로 추가합니다.
- 대시보드 채팅 관리 페이지에서 권한 확인 메시지가 사라지면 정상 등록된 것입니다.
기능 목록
| 기능 | 설명 | 매니저 권한 필요 |
|---|---|---|
| 스팸 필터 | 금지 키워드가 포함된 채팅을 자동으로 감지하고 삭제합니다. | 필요 |
| 채팅 삭제 | 채팅 기록에서 특정 메시지를 삭제합니다. | 필요 |
| 타임아웃 | 지정한 시간 동안 사용자의 채팅을 제한합니다. | 필요 |
| 영구 차단 | 해당 사용자의 채팅을 영구적으로 차단합니다. | 필요 |
ON / OFF 설정
채팅 관리 페이지 우측 상단 토글로 기능 전체를 켜고 끌 수 있습니다. OFF 상태에서는 스팸 필터 자동 삭제가 중단되고 페이지 기능이 모두 비활성화됩니다.