액션
액션은 반응이 실행될 때 봇이 수행하는 작업입니다. 반응은 여러 액션을 가질 수 있으며, 위에서 아래로 순서대로 실행됩니다. 편집기의 액션 섹션에서 액션 추가 버튼으로 추가합니다. 액션은 실행 컨텍스트(ctx)와 사용자 매개변수를 통해 데이터를 공유합니다 — 치환 및 수식을 참조하세요.
메시지 및 응답
- 메시지 전송 — 핵심 액션: 블록(텍스트, 사진, 파일, 지연, AI, 반응 호출)으로 응답을 구성하고, 인라인 버튼, 메뉴, 대화 단계를 추가합니다. 자세한 내용은 메시지 및 버튼을 참조하세요.
- 메시지 저장 — 들어오는 메시지 텍스트를 사용자 매개변수에 기록합니다.
- 전달 — 들어오는 메시지를 지정된 채팅으로 전달합니다(옵션: 토픽 ID 포함).
- 알림 — 사용자, 채팅, 텍스트 데이터가 포함된 알림을 서비스 채팅에 전송합니다.
사용자: 라벨 및 매개변수
- 라벨 변경 — 구독자 라벨을 추가 및/또는 삭제합니다.
- 매개변수 변경 — 사용자 매개변수 값을 설정, 삭제 또는 증가시킵니다.
모더레이션
- 받은 메시지 삭제 — 들어오는 메시지를 삭제합니다(옵션: 사용자의 모든 메시지, 지연 포함).
- 보낸 메시지 삭제 — 봇의 메시지를 삭제합니다(이 반응의 메시지 또는 채팅의 모든 메시지, 지연 포함).
- 권한 변경 — 참여자를 음소거 / 음소거 해제 / 차단 / 차단 해제 / 권한 제한하거나, 기간 설정 또는 영구 적용; 제한 시 특정 권한을 선택합니다.
- 중요 반응(색상) — 오퍼레이터를 위해 대화를 색상으로 표시합니다.
데이터 및 컬렉션
- 레코드 생성 — 컬렉션에 행을 추가합니다. 「중복 제거 키」를 사용하면 upsert(중복 없음)로 작동합니다.
- 레코드 업데이트 — 필터와 일치하는 행을 수정합니다.
- 레코드 찾기 — 행을 배열로 컨텍스트에 읽어옵니다(순회용).
- 레코드 삭제 — 필터로 행을 삭제합니다.
- 목록 순회 —
ctx의 배열을 순회하며 각 항목에 대해 중첩 액션을 실행합니다(예: 목록 일괄 전송).
컬렉션에 대한 자세한 내용은 컬렉션 및 데이터를 참조하세요.
외부 요청
- 웹 요청 — HTTP 요청(GET/POST/PUT/DELETE)으로 헤더, 본문, 성공 코드, 타임아웃, 재시도를 설정합니다. 응답은 JSONPath로 매개변수 또는
ctx에 저장됩니다. 비동기 실행 및 성공/오류 시 반응 시작을 지원합니다. - URL 로드 — 페이지를 다운로드하고 읽을 수 있는 텍스트를
ctx에 저장합니다(이후 처리 또는 AI용). - 소스 요청 — 연결된 커넥터(REST / OzmaDB)에서 데이터를
ctx로 읽어옵니다. - 소스에 쓰기 — 커넥터에 데이터를 씁니다(POST/PUT/DELETE).
소스 및 키에 대한 내용은 소스 및 키를 참조하세요.
AI 및 계산
- AI — 언어 모델 호출: 프롬프트, 매개변수/
ctx에 응답 저장, 구조 추출을 위한 옵션 JSON 스키마, 사용자에게 응답 전송. AI 응답을 참조하세요. - 계산 — 수식 또는 결정 테이블(「조건 → 결과」 규칙, 첫 번째 참인 규칙이 적용됨)로 계산하고 결과를
ctx/매개변수에 저장합니다.
로직 및 시나리오
- 체인 반응 — 이름으로 다른 반응을 시작합니다.
- 다음 반응 — 목록의 다음으로 일치하는 반응에 제어를 넘깁니다.
- 시나리오 시작 — 단계별 마법사(flow)를 시작합니다. 시나리오를 참조하세요.
- 승인 요청 — 승인자에게 카드를 전송합니다. 「승인」/「거절」 버튼이 지정된 반응을 시작합니다.
- 오퍼레이터에게 전달 — 대화를 오퍼레이터 인박스로 전환합니다. 채팅 및 오퍼레이터를 참조하세요.
통합
GetCourse, Google Sheets, Google Drive 액션은 동명의 통합을 통해 연결됩니다(통합 참조). 반응 구성기에서 이 액션들은 「출시 예정」으로 표시됩니다 — 현재는 통합 설정, 웹 요청 또는 AI를 통해 사용하세요. 외부 서비스에 대한 범용 전송은 Webhook 통합 및 웹 요청 액션을 통해 가능합니다.