트리거
트리거는 반응이 응답하는 이벤트입니다. 편집기의 트리거 섹션에서 여러 유형을 동시에 활성화할 수 있으며, 이들은 「OR」 로 결합됩니다 — 활성화된 트리거 중 어느 하나라도 충족되면 반응이 실행됩니다. 추가 제한(라벨, 매개변수, 채팅)은 조건에서 별도로 설정합니다.
텍스트 메시지
텍스트 또는 미디어 캡션에 반응합니다. 「검색 내용」 필드에서 모드를 선택합니다.
- 키워드 — 단어/구문 목록. 「일치」 매개변수: 포함, 정확히 일치, 시작하는 단어, 정규식; 「대소문자 구분」 체크박스 포함.
- 링크 — 메시지에 URL이 포함된 경우.
- 이메일 — 이메일 주소가 포함된 경우.
- 멘션(@username) — 멘션이 포함된 경우.
- 모든 텍스트 — 모든 텍스트 메시지.
명령
슬래시 명령에 반응합니다. 「명령(「/」 제외)」 필드에 이름을 나열합니다 — 예: help, menu. 봇이 /help 및 /menu에 응답합니다.
/start 명령
/start에 대한 별도 트리거. 페이로드 필드는 딥링크 매개변수(/start <payload>)를 캡처하며, 빈 값이면 모든 /start에 반응합니다. 리퍼럴 및 캠페인 링크의 기반이 됩니다.
인라인 버튼 클릭(callback)
인라인 버튼 클릭에 반응합니다. 「버튼 데이터(callback_data)」 필드와 「일치」(정확히, 시작하는 단어, 포함, 정규식)가 어떤 버튼을 캡처할지 결정합니다.
미디어
선택한 유형의 첨부 파일에 반응합니다: 사진, 동영상, 동영상 메시지, 문서, 오디오, 음성, GIF, 스티커, 주사위, 게임, 설문조사, 연락처, 위치, 장소, 앨범.
시스템 이벤트
채팅 이벤트에 반응합니다: 링크로 참여, 채팅에 추가됨, 채팅 떠남, 채팅에서 제거됨, 상태 변경, 참여 신청, 메시지 반응, 반응 카운터. 환영 메시지, 모더레이션, 신청 접수에 유용합니다.
답장 및 전달
- 메시지 답장(reply) — 메시지가 다른 메시지에 대한 답장인 경우 반응합니다.
- 전달된 메시지 — 포워드에 반응합니다.
N번째 메시지마다
사용자의 N번째 메시지마다 반응합니다(「N번째 메시지」 필드). 주기적인 안내나 스팸 방지에 적합합니다.
스케줄(날짜)
지정된 시각에 반응합니다(날짜 목록). 예약된 반응은 기간이 도래하면 활성 구독자에게 발송됩니다 — 일괄 전송을 참조하세요.
인바운드 웹 요청(webhook)
외부 HTTP 요청에 반응합니다. 경로(전체 URL은 봇 주소와 경로로 구성됨), 시크릿 토큰(보호용), 메서드(POST / GET / PUT / ANY)를 설정합니다. 요청 데이터는 실행 컨텍스트에 들어가며 액션에서 {{ctx.필드}}로 접근할 수 있습니다. 자세한 내용은 웹 요청 및 webhook을 참조하세요.