반응: 시작하기
명령, 버튼 클릭, 이벤트에 봇이 응답하도록 설정하고 반응의 순서와 연결을 관리하는 방법.
이 페이지에서
반응은 봇의 행동 규칙 하나입니다. 예를 들어 “사용자가 /price를 보내면 가격표를 전송”하거나 “결제 후 ‘결제 완료’ 레이블을 붙이고 접근 권한을 제공”할 수 있습니다.
반응 메뉴에서 시작 이벤트, 추가 조건, 실행할 액션을 설정합니다. 봇은 규칙을 위에서부터 확인하고 처음으로 맞는 반응을 실행합니다. 따라서 특정 명령에 대한 규칙을 모든 메시지에 응답하는 일반 규칙보다 위에 두는 편이 좋습니다.
반응을 구성하는 요소
가격표를 보내려면 /price 명령을 선택하고 가격이 적힌 메시지를 추가하면 됩니다. 특정 사용자나 채팅에만 적용해야 할 때는 다른 설정을 사용합니다. 편집기에는 네 탭이 있습니다.
| 탭 | 설정할 내용 | 예시 |
|---|---|---|
| 트리거 | 언제 시작할지: 텍스트, 명령, 미디어, 버튼, 이벤트, 일정 | 사용자가 /price 입력 |
| 채팅 | 어디에서 작동할지: 개인 채팅, 그룹에서 봇을 부를 때, 특정 채팅; 사용자 상태도 확인 | 개인 채팅에서만 |
| 조건 | 추가로 확인할 내용: 레이블, 매개변수, 시간, 메시지 수 | ‘결제 완료’ 레이블 보유 |
| 액션 | 봇이 할 일: 메시지 전송, 레이블 변경, 데이터 기록, AI 호출 | 가격표 전송 |
만들기와 편집
반응 만들기를 누르거나 기존 반응을 엽니다. 편집기 상단에 필수 이름, 번호 #N, 설명을 입력하고 활성 스위치를 설정합니다. 왼쪽에서 트리거 / 채팅 / 조건 / 액션을 선택하고 가운데 양식을 채웁니다. 오른쪽에는 블록, 버튼, 메뉴가 포함된 Telegram 메시지 미리보기가 표시됩니다. 마지막으로 저장을 누릅니다.
저장된 반응의 편집기에는 실행 횟수, 그래프, 최근 이벤트가 표시됩니다.
변경 내역과 복원
저장된 반응에서 Change history를 엽니다. 최근 변경 20건의 시간, 수정자, 수정 경로와 “Before / After” 차이를 볼 수 있습니다. 특정 변경이 이루어지기 직전 상태로 되돌릴 수 있으므로 먼저 차이를 검토한 뒤 복원을 확인하세요.
복원은 저장하지 않은 편집 내용을 덮어쓰며, 복원 작업 자체도 변경 내역에 기록됩니다. 반응 설정은 되돌리지만 이미 보낸 메시지나 변경된 데이터는 취소하지 않습니다. 검토 중 다른 사람이 반응을 수정했다면 비교 결과를 새로 고치세요. 단계별 설명과 연습을 참고하세요.
순서와 우선순위
검색과 필터가 꺼져 있고 폴더를 선택하지 않았을 때 수동 순서로 반응을 끌어 놓을 수 있습니다. 순서가 우선순위입니다. 한 이벤트에는 처음 일치하는 반응 하나가 실행되고 확인이 끝납니다. 다음에 일치하는 반응도 확인하려면 다음 반응 액션(goto_next)을 추가하세요.
검색, 필터, 그룹화
목록 위에서 이름이나 번호로 검색하고 다음 필터를 적용할 수 있습니다.
- 상태: 전체, 활성 반응만, 비활성 반응만.
- 생성일 시작 / 종료: 사용자의 시간대 기준 달력 날짜이며 양 끝 날짜를 포함합니다.
- 정렬: 수동(봇이 확인하는 순서), 최신순, 오래된순.
- 그룹화: 생성일의 일 또는 월별. 날짜순 정렬에서만 작동합니다. 수동 순서에서 켜면 목록이 최신순으로 전환됩니다. 기존 날짜순 정렬은 유지되며 수동 순서로 돌아가면 그룹화가 해제됩니다.
필터는 현재 페이지가 아닌 모든 반응에 적용되고 검색 및 폴더와 함께 사용할 수 있습니다. 결과 건수가 표시됩니다. 설정은 페이지 주소에 들어가므로 새로 고침, 링크 공유, ‘뒤로’ 이동에도 유지됩니다. 필터 초기화는 검색, 필터, 정렬, 그룹화를 지우지만 선택한 폴더는 그대로 둡니다.
필터와 화면 정렬은 목록 표시만 바꿉니다. 봇이 반응을 확인하는 실제 순서는 바뀌지 않습니다.
활성화와 비활성화
목록의 스위치 또는 편집기의 활성 스위치로 삭제하지 않고 반응을 켜거나 끌 수 있습니다. 봇은 꺼진 반응을 건너뜁니다.
복제와 삭제
반응 행에는 사본을 만드는 복제와 삭제가 있습니다. 비슷한 규칙을 조금 수정해 만들 때 복제가 편리합니다.
가져오기와 내보내기
편집기의 내보내기로 반응을 JSON 파일로 받고, 목록의 리액션 가져오기로 다시 올릴 수 있습니다. 봇 사이에서 반응을 옮기거나 플랫폼 밖에 버전을 보관할 때 사용합니다.
반응 일괄 전송
반응 행의 전송 아이콘이 붙은 보내기… 버튼은 모든 활성 구독자에게 해당 반응을 실행합니다. 레이블로 대상을 좁힐 수 있습니다. 일괄 전송을 참고하세요.
연결된 반응과 대화
예를 들어 첫 반응이 카탈로그를 보여주고 버튼이 상품 카드가 있는 두 번째 반응을 시작한 뒤 배송 주소를 물을 수 있습니다. 반응은 여러 방식으로 연결할 수 있습니다.
- 연쇄 반응 (
chain): 현재 반응 실행 중 다른 반응을 시작합니다. - 다음 반응 (
goto_next): 목록에서 다음으로 일치하는 반응으로 넘깁니다. - 대화 단계: 메시지 블록이 사용자 응답을 기다리며 형식을 확인하고 흐름을 잠시 멈춥니다. 메시지와 버튼을 참고하세요.
- ‘그렇지 않으면’ 분기: 조건이 맞지 않을 때 조건 설정에서 다른 반응을 실행합니다.
- 다음 단계 선택 (
branch_result): 검색 결과가 없음, 한 건, 여러 건, 불완전함 등의 경우를 나눕니다. - 값에 따라 단계 선택 (
branch_value):updated면 예약을 확인하고conflict면 현재 상태를 다시 읽도록 안내하는 식으로 나눕니다. - 액션 결과: 지원되는 액션에서 성공, 충돌, 레코드 없음, 오류에 따라 다른 반응으로 이동합니다. 결과별 경로을 참고하세요.
- Call block (
call_block): 공통 계산에 입력값을 전달하고 정의된 출력값을 현재 반응에 받습니다. 블록 라이브러리와 버전을 참고하세요.
데이터 흐름은 컬렉션 검색 → 다음 단계 선택 → 버튼 → 관련 레코드 찾기처럼 만들 수 있습니다. 외부 서비스에서 목록을 받았다면 목록 처리 → 그룹 및 합계를 사용합니다. 각 액션의 결과 이름을 정하고 다음 액션에서 선택하세요. 실습에서 수업과 신청 사례를 볼 수 있습니다.
설정 중에는 경로를 외우지 말고 이전 단계 데이터 선택을 사용하세요. 저장 전 초안 테스트로 연습 데이터를 넣고 분기와 예정된 메시지를 확인합니다. 저장 후에는 연결된 봇과 채널에서도 사용자 경로를 직접 확인하세요. 실제 액션은 그곳에서 실행됩니다.