자동 기능
워크플로우
트리거와 액션을 조합하여 서버 자동화를 구성합니다.
개요
워크플로우는 특정 이벤트(트리거)가 발생했을 때, 조건을 평가하고 지정한 동작(액션)을 자동으로 실행하는 자동화 시스템입니다. 코드 없이 조건 분기와 다단계 액션을 조합하여 복잡한 서버 자동화를 구성할 수 있습니다.
서버당 최대 5개의 워크플로우를 생성할 수 있습니다.
작동 방식
워크플로우는 트리거 → 조건 → 액션 순서로 실행됩니다. 조건 노드에서 결과에 따라 서로 다른 액션 분기를 타게 됩니다.
조건과 액션을 여러 단계로 중첩할 수 있어, 하나의 워크플로우로 다양한 상황에 대응할 수 있습니다.
설정 방법
대시보드 > 워크플로우에서 비주얼 에디터를 통해 워크플로우를 만들고 관리합니다.
- 새 워크플로우 생성 — 워크플로우 이름과 아이콘을 지정합니다
- 트리거 설정 — 워크플로우를 시작할 이벤트를 선택합니다
- 조건 추가 — 필요한 경우 조건 분기를 추가합니다
- 액션 추가 — 각 분기에 실행할 동작을 추가합니다
- 저장 — 워크플로우를 저장합니다
- 워크플로우는 웹 대시보드에서만 생성 및 편집할 수 있습니다.
- 무한 루프가 발생하지 않도록 주의하세요. 예를 들어 "경고 추가" 트리거에서 "경고 부여" 액션을 실행하면 무한 반복될 수 있습니다.
- 경고 액션에 의한 자동화는 경고 자동화와는 별개로 동작합니다.
트리거
워크플로우를 시작시키는 이벤트입니다. 워크플로우 하나에 트리거 하나를 지정합니다.
| 트리거 | 설명 |
|---|---|
| 반응 추가 | 멤버가 메시지에 반응(이모지)을 추가했을 때 |
| 멤버 입장 | 새 멤버가 서버에 참여했을 때 |
| 경고 추가 | 멤버에게 경고가 부여되었을 때 |
| 경고 제거 | 멤버의 경고가 제거되었을 때 |
| 레벨업 | 멤버가 레벨이 올랐을 때 |
조건
조건 노드는 트리거된 멤버의 상태를 평가하여 **충족(then)**과 미충족(else) 두 갈래로 분기합니다.
조건 필드
| 조건 | 설명 | 예시 |
|---|---|---|
| 경고 횟수 | 멤버의 누적 경고 수 | 경고 3회 이상이면 타임아웃 |
| 레벨 | 멤버의 현재 레벨 | 레벨 10 도달 시 역할 부여 |
| 경험치 | 멤버의 누적 경험치 | 경험치 1000 이상이면 보상 |
| 역할 보유 | 특정 역할을 갖고 있는지 여부 | VIP 역할이 없으면 환영 메시지 |
| 계정 나이 | Discord 계정 생성 후 경과 일수 | 신규 계정(7일 미만) 감지 |
| 서버 참여 기간 | 서버 참여 후 경과 일수 | 30일 이상 활동 멤버에게 역할 부여 |
비교 연산자
| 연산자 | 의미 | 사용 예시 |
|---|---|---|
| 이상 (≥) | 값이 기준 이상 | 경고 횟수 ≥ 3 |
| 이하 (≤) | 값이 기준 이하 | 레벨 ≤ 5 |
| 초과 | 값이 기준 초과 | 경험치 > 500 |
| 미만 | 값이 기준 미만 | 계정 나이 < 7일 |
| 같음 | 값이 정확히 같음 | 레벨 = 10 |
| 다름 | 값이 다름 | 경고 횟수 ≠ 0 |
| 역할 보유 | 특정 역할을 갖고 있음 | VIP 역할 보유 |
| 역할 미보유 | 특정 역할을 갖고 있지 않음 | 인증 역할 미보유 |
액션
조건이 충족되었을 때 실행할 동작입니다. 하나의 분기에 여러 액션을 순서대로 추가할 수 있습니다.
| 액션 | 설명 | 필요 봇 권한 |
|---|---|---|
| 역할 추가 | 멤버에게 역할을 부여합니다 | 역할 관리 |
| 역할 제거 | 멤버의 역할을 제거합니다 | 역할 관리 |
| 메시지 전송 | 지정한 채널에 메시지를 보냅니다 | 메시지 전송 |
| 경고 부여 | 멤버에게 경고를 추가합니다 | — |
| 경고 제거 | 멤버의 경고를 제거합니다 | — |
| 타임아웃 | 멤버를 일정 시간 타임아웃합니다 | 멤버 관리 |
| 경험치 지급 | 멤버에게 경험치를 지급합니다 | — |
| 경험치 차감 | 멤버의 경험치를 차감합니다 | — |
| 추방 | 멤버를 서버에서 추방합니다 | 멤버 추방 |
| 차단 | 멤버를 서버에서 차단합니다 | 멤버 차단 |
Aztra 봇에 해당 액션을 수행할 수 있는 권한이 있어야 합니다. 권한이 부족하면 해당 액션은 실행되지 않습니다.
활용 예시
신규 멤버 환영 + 신규 계정 감지
경고 누적 시 자동 제재
레벨업 보상
마지막 업데이트