---
title: 워크플로우 문제 해결
info: 문제 해결 기술 및 성능 최적화 팁으로 워크플로우를 디버그하고 최적화하세요.
image: /images/user-guide/what-is-twenty/20.png
sectionInfo: 프로세스를 자동화하고 외부 도구와 통합하세요
---

<Frame>
  <img src="/images/user-guide/what-is-twenty/20.png" alt="Header" />
</Frame>

## 워크플로우 실행으로 디버깅하기

문제를 디버그하기 위해 **워크플로우 실행** 인터페이스를 사용하세요:

- 워크플로우 편집기의 **실행** 패널을 통해 접근
- 각 단계의 입력/출력 데이터를 보려면 개별 실행을 클릭하세요
- 단계 간의 실행 상태, 오류 메시지 및 데이터 흐름을 확인하세요

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

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

**문제**: 워크플로우가 예상대로 실행되지 않음.

**해결책**:

- 워크플로우가 **활성화**되었는지 확인 (초안 모드 아님)
- 트리거 설정이 데이터 구조와 일치하는지 확인하세요
- 레코드 트리거의 경우, 올바른 객체와 필드가 선택되었는지 확인
- 웹훅 트리거의 경우 URL과 예상 데이터 형식을 검증
- 예약된 트리거의 경우, 타이밍 구성을 점검

### 양식에 접근할 수 없음

**문제**: 자동 워크플로우에서 양식 작업 찾기 또는 접근이 어려움.

<Warning>
양식은 현재 수동 트리거에만 설계되어 있습니다. 다른 트리거 (레코드 생성, 업데이트 등)와 함께하는 워크플로우의 경우, 형식은 워크플로우 실행 인터페이스를 통해서만 접근 가능하여 기대와 달라짐. 2026년 자동 워크플로우에서 양식을 적절히 지원하기 위한 알림 센터가 출시될 예정입니다.
</Warning>

**임시 해결책**: 양식이 필요한 경우 수동 트리거 사용 또는 자동 흐름에서 양식 사용을 피하기 위해 워크플로우 구조를 변경.

### 높은 크레딧 소비

**문제**: 예상보다 더 많은 크레딧을 소모하는 워크플로우.

**일반 원인 및 해결책**:

- **비효율적인 API 호출**: 개별 요청 대신 배치 API 호출 사용
- **잘못된 수동 트리거 구성**: `단일` 대신 `벌크` 가용성을 사용하여 하나의 워크플로우 실행에서 여러 레코드를 처리
- **필터 누락**: 조건이 충족되지 않을 때 워크플로우를 중지할 조건부 로직 추가
- **불필요한 단계**: 불필요한 작업 제거하고 워크플로우 논리 최적화
- **실시간 대 예약**: 긴급하지 않은 프로세스에는 예약된 워크플로우 사용

### 동시 워크플로우 제한

**문제**: 워크스페이스당 100개의 동시 워크플로우 제한을 초과합니다.

<Warning>
You cannot run more than 100 workflows in parallel at any given time per workspace.
</Warning>

**해결책**:

- 수동 트리거의 `벌크` 가용성을 사용하여 하나의 실행에서 여러 레코드를 처리
- 예약된 트리거를 사용하여 워크플로우 실행 간 지연을 구현
- 워크플로우를 최적화하여 더 빠르게 실행되고 동시 실행 시간을 줄임
- 비활성화 시간에 일괄 처리 실행 고려

### API 속도 제한

**문제**: 외부 API 호출이 속도 제한으로 인해 실패합니다.

**해결책**:

- 가능한 경우 실시간 트리거 대신 예약된 워크플로우 사용
- 코드 작업에서 API 호출 간 지연을 구현
- 외부 서비스가 지원할 경우, 배치 API 요청 사용
- 속도 제한 오류를 모니터링하고 타이밍 조정

### 이터레이터 문제

**문제**: 이터레이터 작업이 예상대로 작동하지 않음.

**해결책**:

- **참고**: 이터레이터는 현재 베타 버전입니다. 설정 -> 릴리즈 -> 랩에서 활성화
- 입력이 이전 단계의 레코드 배열인지 확인
- 이터레이터 내부의 작업이 올바르게 구성되어 있는지 확인
- 최적의 성능을 위해 `벌크` 수동 트리거와 함께 이터레이터 사용

### 권한 누락

**문제**: 워크플로우 섹션에 접근 불가.

<Warning>
워크플로우 섹션이 보이지 않는 경우, 이는 권한 문제 때문입니다. 워크플로우에 대한 접근을 위해 워크스페이스 관리자에게 연락하세요.
</Warning>

## 최적화 팁

### 성능 최적화 모범 사례

- **단순하게 시작**하고 점진적으로 복잡성 추가
- 수동 트리거에 대해 **`벌크` 가용성 사용**하여 여러 레코드를 효율적으로 처리
- 기준이 충족되지 않을 때 워크플로우를 중지하기 위해 **초기에 필터 추가**
- **API 호출 배치**하고 긴급하지 않은 프로세스에는 예약된 워크플로우 사용
- 로딩 성능을 개선하기 위해 모든 워크플로우를 표시하는 페이지에서 **워크플로우 실행 숨기기**
- 설정 -> 청구에서 크레딧 사용량을 **정기적으로 모니터링**

### 오류 예방

- 워크플로우를 활성화하기 전에 **초안 모드로 테스트**
- API 응답을 **검증**하고 대체 작업 구현
- **유지관리를 쉽게 하려면** 설명적인 단계 이름 사용
- 팀원을 위해 복잡한 로직을 **문서화**

## 도움 받기

### 셀프 서비스 자료

- 기술 세부 사항은 [워크플로우 기능](/l/ko/user-guide/workflows/workflow-features) 검토
- 최적화 팁을 위해 [워크플로우 크레딧](/l/ko/user-guide/workflows/workflow-credits) 확인
- 예시는 [내부 자동화](/l/ko/user-guide/workflows/internal-automations) 및 [외부 도구 통합](/l/ko/user-guide/workflows/external-tool-integration) 탐색

### 전문 지원

- 복잡한 문제 해결을 위해 [전문 서비스](/l/ko/user-guide/workflows/professional-services)에 문의
- 기술 지원을 위해 contact@twenty.com으로 연락

