반응: 기초
반응은 봇의 핵심 구성 단위로, 언제 실행할지, 어떤 조건에서, 무엇을 할지를 정의하는 규칙입니다. 봇은 순서가 지정된 반응 목록으로 구성되며, 들어오는 이벤트마다 플랫폼이 목록을 위에서 아래로 순회하며 첫 번째로 일치하는 반응을 적용합니다. 왼쪽 메뉴의 반응 섹션에서 관리합니다.
반응의 구성 요소
반응은 네 가지 부분(편집기 탭)으로 구성됩니다.
- 트리거 — 반응이 응답하는 이벤트: 텍스트, 명령, 미디어, 버튼 클릭, 시스템 이벤트, 스케줄 등. 트리거를 참조하세요.
- 채팅에서 — 반응이 작동하는 범위: 개인 채팅, 봇을 멘션한 그룹, 특정 채팅; 사용자 상태 필터 포함.
- 조건 — 추가 필터(라벨, 매개변수, 시간, 메시지 수 등). 조건 및 채팅을 참조하세요.
- 액션 — 반응이 실행될 때 봇이 하는 일: 메시지 전송, 라벨 지정, 컬렉션에 쓰기, AI 호출 등. 액션을 참조하세요.
생성 및 편집
반응 만들기를 클릭하거나 기존 반응을 엽니다. 편집기 헤더에는 이름(필수), 번호 #N, 설명, 활성 토글이 있습니다. 왼쪽에는 트리거 / 채팅에서 / 조건 / 액션 섹션 탐색 메뉴가, 가운데에는 폼이, 오른쪽에는 블록·키보드·메뉴가 포함된 메시지 미리보기를 보여주는 Telegram 미리보기가 있습니다. 저장 버튼으로 저장합니다.
저장된 반응의 편집기에는 실행 횟수, 그래프, 최근 이벤트가 표시된 통계 패널이 표시됩니다.
순서 및 우선순위
목록의 반응은 드래그하여 순서를 변경할 수 있습니다 — 순서가 우선순위를 결정합니다. 이벤트에 대해 첫 번째로 일치하는 반응이 실행되고 순회가 중단됩니다. 순회를 계속해 다음으로 일치하는 반응이 실행되도록 하려면 다음 반응 액션(goto_next)을 추가하세요.
활성화 및 비활성화
목록 행의 토글(또는 편집기의 활성)을 사용해 반응을 삭제하지 않고 켜고 끌 수 있습니다. 비활성화된 반응은 순회에서 건너뜁니다.
복제 및 삭제
목록 행에는 복제(복사본 생성) 및 삭제 버튼이 있습니다. 복제는 작은 차이가 있는 유사한 반응을 만들 때 편리합니다.
가져오기 및 내보내기
반응을 JSON으로 내보낼 수 있으며(편집기의 내보내기 버튼), 다시 불러올 수 있습니다(목록의 가져오기). 이를 통해 봇 간에 반응을 이동하고 플랫폼 외부에 버전을 보관할 수 있습니다.
반응 일괄 전송
반응 행의 일괄 전송 버튼(「보내기」 아이콘)을 클릭하면 해당 반응을 봇의 모든 활성 구독자에게 발송합니다 — 공지사항 및 알림에 편리합니다. 라벨로 대상을 좁힐 수 있습니다. 자세한 내용은 일괄 전송을 참조하세요.
체이닝 및 대화
여러 반응으로 시나리오를 구성할 수 있습니다.
- 체인 반응(
chain) — 실행 중에 다른 반응을 시작하는 액션. - 다음 반응(
goto_next) — 목록의 다음으로 일치하는 반응에 제어를 넘깁니다. - 대화 단계 — 메시지 블록이 사용자의 응답을 기다릴 수 있으며(형식 확인 포함), 시나리오를 일시 중지합니다. 메시지 및 버튼을 참조하세요.
- 「아니면」 분기 — 반응의 조건이 충족되지 않으면 다른 반응을 시작할 수 있습니다(「조건」 섹션의 필드).