> ## Documentation Index
> Fetch the complete documentation index at: https://docs.twenty.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 워크플로우 문제 해결

> 일반적인 워크플로우 문제와 해결 방법.

## 일반적인 문제와 해결책

### 워크플로우가 작동하지 않음

**증상**: 워크플로우가 예상한 시점에 실행되지 않습니다.

**가능한 원인**:

1. **워크플로우가 활성화되지 않음**: 워크플로우가 "Draft"가 아니라 "Active"로 설정되어 있는지 확인하세요
2. **트리거 조건 불충족**: 트리거가 예상한 이벤트와 일치하는지 확인하세요
3. **필드가 모니터링되지 않음**: "Record is Updated" 트리거의 경우 특정 필드가 모니터링되고 있는지 확인하세요
4. **권한**: 워크플로우를 실행할 권한이 있는지 확인하세요

**해결책**:

* 워크플로우 목록에서 워크플로우 상태를 확인하세요
* 해당 트리거를 유발할 것으로 예상되는 특정 작업으로 테스트하세요
* 트리거 구성을 검토하세요
* 권한과 관련해 관리자에게 문의하세요

### 워크플로우 트리거가 너무 일찍 발생함(빈 필드)

**증상**: UI에서 레코드를 수동으로 생성할 때 모든 필드를 채우기 전에 워크플로우가 트리거됩니다. 대부분의 필드 값이 비어 있는 상태로 워크플로우가 실행됩니다.

**발생 원인**: Twenty는 모든 내용을 실시간으로 저장합니다 — 별도의 "edit" 및 "read" 모드는 없습니다. 레코드를 생성하면 즉시 저장되어 추가 필드를 채우기 전에 "Record is created" 이벤트가 트리거됩니다.

**"Record is created"가 적절한 경우**:

* API 호출로 생성된 레코드(단일 요청으로 필드가 채워짐)
* 가져오기로 생성된 레코드
* 다른 워크플로우에서 자동으로 생성된 레코드

**해결 방법**: UI에서 수동으로 생성된 레코드의 경우 트리거로 \*\*"Record is created or updated"\*\*를 사용하세요. 이렇게 하면:

* 사용자가 필드를 모두 작성하고 저장한 후에 워크플로우가 트리거됩니다
* 빈 값이 아닌 완전한 데이터를 얻을 수 있습니다

<Tip>
  레코드당 한 번만 워크플로우를 실행하려면, `createdAt equals updatedAt`(첫 저장)과 같은 필드를 확인하는 필터 액션을 추가하거나, 워크플로우가 이미 실행되었는지 추적하기 위해 사용자 지정 체크박스 필드를 사용하세요.
</Tip>

### 액션 실패

**증상**: 워크플로우는 실행되지만 일부 액션이 실패합니다.

**가능한 원인**:

1. **데이터 누락**: 필수 필드가 비어 있음
2. **잘못된 참조**: 이전 단계의 변수가 존재하지 않음
3. **API 오류**: 외부 서비스가 오류를 반환함
4. **권한 문제**: 액션에 필요한 권한이 없음

**해결책**:

* 워크플로우 실행 세부 정보에서 오류 메시지를 확인하세요
* 모든 필수 필드에 값이 있는지 확인하세요
* API 연결을 별도로 테스트하세요
* 역할 권한을 검토하세요

### HTTP 요청 오류

**증상**: HTTP 요청 액션이 실패하거나 예상치 못한 결과를 반환합니다.

**일반적인 오류 코드**:

* **400**: 잘못된 요청 - 요청 본문 형식을 확인하세요
* **401**: 인증되지 않음 - API 키를 확인하세요
* **403**: 접근 거부 - API 권한을 확인하세요
* **404**: 찾을 수 없음 - 엔드포인트 URL을 확인하세요
* **429**: 너무 많은 요청 - 요청 속도 제한을 구현하세요
* **500**: 서버 오류 - 외부 서비스 문제

**해결책**:

* API 엔드포인트 URL을 확인하세요
* 인증 헤더를 확인하세요
* 먼저 Twenty 밖에서 API 호출을 테스트하세요
* 코드 액션에 오류 처리를 추가하세요

### 코드 액션 오류

**증상**: JavaScript 코드가 실행되지 않습니다.

**일반적인 문제**:

1. **구문 오류**: 오탈자 또는 유효하지 않은 JavaScript
2. **정의되지 않은 변수**: 존재하지 않는 변수를 참조함
3. **타입 오류**: 잘못된 데이터 타입에 대한 연산
4. **시간 초과**: 코드 실행에 너무 오래 걸림

**해결책**:

* 내장 코드 편집기의 유효성 검사를 사용하세요
* 먼저 JavaScript 콘솔에서 코드 로직을 테스트하세요
* 디버깅을 위해 console.log 문을 추가하세요
* 복잡한 연산을 단순화하세요

### 이메일이 전송되지 않음

**증상**: 이메일 보내기 액션이 이메일을 전송하지 않습니다.

**가능한 원인**:

1. **이메일 계정이 연결되지 않음**: Settings → Accounts를 확인하세요
2. **잘못된 이메일 주소**: 수신자 이메일이 형식에 맞지 않음
3. **전송 한도**: 이메일 제공업체의 속도 제한에 도달함
4. **스팸 필터**: 이메일이 차단됨

**해결책**:

* 이메일 계정 연결 상태를 확인하세요
* 수신자 이메일 주소를 검증하세요
* 이메일 제공업체의 제한을 확인하세요
* 스팸 트리거가 될 수 있는 이메일 콘텐츠를 검토하세요

## 워크플로우 디버깅

### 워크플로우 실행 활용

1. 워크플로우 편집기로 이동하세요
2. **Runs** 패널을 엽니다
3. 실패한 실행을 찾으세요
4. 클릭하여 단계별 세부 정보를 확인하세요
5. 오류 메시지와 출력 데이터를 검토하세요

### 개별 단계 테스트

1. 코드 액션의 경우 **Test** 버튼을 사용하세요
2. HTTP 요청의 경우 엔드포인트를 별도로 테스트하세요
3. 워크플로우를 트리거하기 위한 테스트 레코드를 생성하세요
4. 제어된 테스트를 위해 수동 트리거를 사용하세요

### 일반적인 디버깅 패턴

**로깅 추가**:
디버깅을 위해 코드 액션을 사용해 중간 값을 기록하세요.

**단계 격리**:
실패를 식별하기 위해 각 단계를 개별적으로 테스트하세요.

**데이터 흐름 확인**:
각 단계가 예상된 입력 데이터를 수신하는지 확인하세요.

## 문제를 피하기 위한 모범 사례

### 활성화 이전

* 초안 모드에서 충분히 테스트하세요
* 모든 API 연결을 검증하세요
* 트리거 조건을 주의 깊게 검토하세요
* 예상 동작을 문서화하세요

### 개발 중

* 알기 쉬운 단계 이름을 사용하세요
* 코드 액션에 주석을 추가하세요
* 현실적인 데이터로 테스트하세요
* 엣지 케이스를 대비하세요

### 활성화 이후

* 초기 실행을 면밀히 모니터링하세요
* 실패에 대한 알림을 설정하세요
* 실행 기록을 정기적으로 검토하세요
* 가능한 경우 워크플로우를 단순하게 유지하세요