챗봇

Chatbot 은 Twitch 채팅을 관리하는 데 도움을 줍니다. 명령어 실행, 메시지 모더레이션, 충성도 높은 시청자에게 리워드 제공 등을 할 수 있습니다. 캠페인에 참여 중이라면, Chatbot은 다음 작업도 수행할 수 있습니다:

• 시간 설정 메시지
• 채팅 명령어에 대한 응답
• 캠페인 링크 및 홍보 정보

Chatbot 설정 방법:

1. Twitch 계정으로 Partner Network에 가입하거나 기존 계정에 Twitch를 연결하세요 .
2. Chatbot 페이지로 이동하여 Chatbot 켜기을 클릭하세요. 이 작업은 Xsolla 챗봇을 채널에 추가하고 챗봇에게 모더레이터 권한을 부여합니다.

활성화되면 설정 > Chatbot 페이지에서 Chatbot을 제어하고 상태를 확인할 수 있습니다. Twitch 상태는 다음 값을 가질 수 있습니다:

• 연결됨 — Xsolla 챗봇이 채널에서 활성화되었습니다.
• 대기 중 — 서버 재시작 또는 업데이트 후 Xsolla 챗봇이 다시 연결 중입니다.
• 연결 끊김 — Xsolla 챗봇이 연결되지 않았습니다. 이는 Xsolla 챗봇이 채널에서 차단되었거나 모더레이터 권한이 없는 경우 발생할 수 있습니다.
• 알 수 없음 — Xsolla 챗봇의 상태를 확인할 수 없습니다. 문제가 지속되면 지원팀에 문의하세요.

모더레이터 상태는 다음 값을 가질 수 있습니다:

• 부여됨 — Xsolla 챗봇이 스팸 제거 및 방해가 되는 시청자 타임아웃을 포함하여 채팅을 관리할 수 있습니다.
• 부여되지 않음 — Xsolla 챗봇이 모더레이터 권한 없이 채팅을 관리할 수 없습니다.

모더레이션

관리할 콘텐츠를 선택하려면 Chatbot > 모더레이션 페이지로 이동하여, 채팅 필터 섹션에서 관리할 콘텐츠의 토글이 켜져 있는지 확인하세요:

다음은 기본 임계값입니다 — 경고 임계값 섹션에서 새로 추가하거나 조정할 수 있습니다:

게시된 링크의 페이지 제목을 챗봇이 응답하도록 하려면 링크 미리보기 토글을 켜세요.

알림

Chatbot은 팔로우, 구독, 팁 및 기타 이벤트에 대한 메시지를 채팅에 게시할 수 있습니다. 모든 알림을 한 번에 켜거나 각각 개별적으로 활성화하고 편집할 수 있습니다:

이 기본 메시지들은 다음 변수를 사용합니다:

이들은 사용자 정의 명령어에 사용할 수 있는 변수와는 별개입니다. 자세한 내용은 명령어 섹션을 참조하세요.

타이머

설정된 간격으로 자동 메시지를 게시하려면 Chatbot > 타이머 페이지로 이동하여, 추적 링크 또는 스토어프런트 를 홍보하거나, 소셜 미디어를 공유하거나, 채팅 규칙을 시청자에게 상기시키기 위한 메시지를 설정하세요. 메시지가 라이브 중일 때만 게시되도록 구성할 수 있습니다.

명령어

Chatbot > 명령어 페이지로 이동하여 채널에 대한 내장 명령어를 활성화하거나 비활성화하세요. 각 명령어는 자체 권한 수준(전체, 모더레이터 또는 소유자)을 가지며, 로열티 포인트 비용을 설정할 수 있습니다. 내장 명령어 외에도 새 명령어를 클릭하여 사용자 정의 명령어를 만들 수 있습니다. 또한, Twitch 채팅에서 !set 및 !unset을 직접 사용하여 사용자 정의 명령어를 빠르게 편집할 수 있습니다.

Chatbot에는 다음과 같은 내장 명령어가 포함되어 있습니다.

명령어	설명
!song	스트리머가 듣고 있는 음악을 보여줍니다.
!ping	봇이 온라인 상태인지 확인하기 위해 pong을 보냅니다.
!uptime	스트림이 얼마나 오래 라이브되었는지 보여줍니다.
!reset [command]	명령어가 실행된 횟수를 보여주는 카운터를 초기화합니다.
!unset [command]	사용자 정의 메시지가 있는 명령어를 제거합니다.
!set [name] [message]	사용자 정의 메시지가 있는 새 명령어를 만듭니다.
!allow [user]	지정된 사용자가 링크를 게시할 수 있도록 일시적으로 허용합니다.
!warn [user] [silent] [reason]	지정된 사용자에게 경고를 발행합니다.
!warnings [user]	사용자가 받은 경고 수를 검색합니다.
!unwarn [user]	지정된 사용자의 경고 횟수를 초기화합니다.
!mute [user] [silent] [duration]	지정된 사용자를 음소거합니다. 만료 시간을 정의할 수 있습니다.
!unmute [user]	지정된 사용자의 음소거를 해제합니다.
!clear [user]	지정된 사용자가 최근에 말한 모든 메시지를 삭제합니다.
!boosts	사용 가능한 부스트 및 포인트 부스트에 대한 정보를 검색합니다.
!takepoints [user] [points]	지정된 사용자로부터 포인트를 가져옵니다.
!give [user] [points]	발신자로부터 다른 사용자에게 포인트를 전송합니다.
!buyboost [boost]	포인트 부스트를 구매하며, 나중에 업그레이드할 수 있지만 다운그레이드할 수 없습니다.
!addpoints [user] [points]	특정 사용자에게 포인트를 제공합니다.
!points [user]	특정 사용자가 가진 포인트 수를 보여줍니다.
!boost [user]	사용자의 현재 포인트 부스트 및 만료 날짜를 검색합니다.
!giveall [points]	채널의 모든 사용자에게 포인트를 제공합니다.
!leaderboard [count]	지정된 수까지 포인트가 가장 많은 사용자를 보여줍니다.
!rank	사용자의 현재 순위를 보여줍니다.
!removequote [quote]	봇의 데이터베이스에서 인용문을 제거합니다.
!quote [quote]	무작위 인용문을 반환하거나 명령어에 지정된 특정 인용문을 반환합니다.
!addquote [person] [message]	봇의 데이터베이스에 새 인용문을 추가합니다.
!raffleend	현재 추첨을 종료하고 무작위로 승자를 선택합니다.
!raffleset [word] [followers]	경품 행사를 시작하고 봇이 찾을 키워드를 설정합니다.
!addschedule [message]	일정의 메시지 휠에 새 메시지를 추가합니다.
!commands	채팅에서 명령어 목록을 보여줍니다.
!setgame [game]	봇이 연결된 모든 플랫폼에서 스트림 게임을 변경합니다.
!settitle [title]	봇이 연결된 모든 플랫폼에서 스트림 제목을 변경합니다.

사용자 정의 명령어는 더 고급 응답을 위한 변수를 지원합니다.

변수	설명
$user	명령어 실행 시 사용자 이름을 인수로 받습니다 (예: !costream @Xsolla). 입력하지 않아도 항상 @로 시작합니다.
$sender	명령어를 실행한 사용자의 이름.
$title, $game, $url	Twitch 채널의 스트림 제목, 현재 게임, 채널 URL — 기본적으로 자신의 채널에 대한 정보입니다. 명령어에 $user를 포함하여 다른 Twitch 채널에서 이 정보를 가져올 수 있습니다 (예: !costream $user $title로 소개).
$count	명령어가 실행된 횟수. 관리자는 !reset [command]로 초기화할 수 있습니다.
$arg1, $arg2, $arg3, …	명령어 뒤에 전달된 추가 인수, 공백으로 구분됩니다.
$args	명령어 뒤의 모든 것, 공백을 무시합니다.

기본적으로 응답은 사용자 이름으로 시작합니다 — 명령어를 생성할 때 Start with @username의 선택을 해제하여 이를 비활성화할 수 있습니다. 단일 명령어에서 변수를 혼합하여 사용할 수 있습니다.

명령어에서 이미지를 트리거하거나 스트림에서 소리를 재생할 수도 있습니다 — 자세한 내용은 Overlay의 트리거를 참조하세요.

로열티

Chatbot > 로열티 페이지로 이동하여 로열티 프로그램을 설정하세요. 설정를 클릭하고 세 가지 시스템 중 하나를 선택하세요:

• 정기 시청자 — 충성도 높은 시청자에게 추가 명령어에 대한 특별 채팅 역할을 수동으로 부여합니다. 정기 시청자를 클릭하여 사용자 이름으로 시청자를 추가하세요.
• 순위 — 시청 시간이 기준이 되어 사용자 정의 등급을 통해 시청자가 진행합니다. 순위를 클릭하고 순위(이름 + 필요한 시간)를 설정하세요. 그런 다음 !rank 명령어를 활성화하여 시청자가 채팅에서 자신의 순위를 확인할 수 있도록 하고, 크리에이터 사이트 또는 !leaderboard로 리더보드를 확인하세요.
• 포인트 — 완전히 사용자 정의 가능한 채팅 내 통화입니다. 시청자는 포인트를 사용하여 Overlay의 트리거 레이어와 연결된 명령어를 실행하거나, 채팅을 통해 진행하는 추첨에 참여할 수 있습니다. 시청자가 포인트를 얻는 방법을 구성하려면 다음 필드를 완료하세요:
  • 포인트 이름 — 통화의 이름(기본값: 포인트).
  • 구독자 배수 — 구독자가 얻은 포인트에 적용되는 배수.
  • 시청 — 채팅, 라이브 스트림 시청, 오프라인 시청으로 얻은 포인트. 각 항목에 대한 금액과 간격을 구성할 수 있습니다.
  • 이벤트 — 팔로우, 구독, 구독 선물, 팁, 추첨 승리, 호스팅, 응원, 공격에 대한 보너스 포인트.
  • 무시된 사용자 — 포인트 획득에서 제외된 계정(예: 다른 채팅 봇).

인용문

채팅에서 기억에 남는 순간을 텍스트로 저장하여 나중에 다른 사람들이 다시 발견할 수 있도록 하세요. 저장할 수 있는 인용문 수에는 제한이 없습니다. Chatbot > 인용문 페이지에서 인용문을 추가하세요 — 누군가가 채팅에서 !quote를 실행하면, Chatbot은 저장된 인용문 중 하나를 무작위로 게시합니다.

마지막 업데이트: 2026년 9월 14일