워크플로

워크플로의 id·활성 여부·트리거 종류를 읽는 조회 API입니다. 자동화 연동에서 워크플로 목록을 확인하는 용도이며, 워크플로 정의(노드·조건 등)는 공개 API로 노출되지 않습니다.

목록 조회

GET /workflows — 워크스페이스의 모든 워크플로를 활성 상태와 함께 조회합니다.

• Scope: workflows:read
• 쿼리: 없음

워크플로 수는 관리자가 정의하는 소규모 집합이라 페이지네이션이 없으며(meta 없음), 전체 목록을 한 번에 반환합니다.

아래 요청은 워크플로 전체 목록을 조회합니다.

curl "https://api.talk.zeroworks.ai/api/public/v1/workflows" \
  -H "Authorization: Bearer ztpat_..."

응답

{
  "success": true,
  "data": [
    {
      "id": "11111111-1111-1111-1111-111111111111",
      "name": "영업시간 외 자동 응답",
      "is_active": true,
      "created_at": "2026-03-01T09:00:00Z",
      "trigger_type": "T2"
    },
    {
      "id": "22222222-2222-2222-2222-222222222222",
      "name": "리마인더 (비활성)",
      "is_active": false,
      "created_at": "2026-03-02T10:30:00Z",
      "trigger_type": "T3"
    }
  ]
}

워크플로가 없으면 data는 빈 배열([])입니다.

필드

필드	타입	설명
id	string	워크플로 UUID
name	string	워크플로 이름
is_active	boolean	발행·활성 여부. 비활성 워크플로도 함께 반환됩니다(필터 없음)
created_at	string	RFC 3339 시각
trigger_type	string	워크플로가 시작되는 조건의 코드 (아래 표 참조)

trigger_type 코드

코드	시작 조건
T1	새 대화 시작 (봇이 먼저 실행)
T2	대화 인입 (메시지 수신 즉시)
T3	고객 N분 무응답
T4	특정 키워드 감지
T7	담당자 변경
T8	대화 종료
T9	상담원/AI N분 무응답
T_IVR	IVR 전화 워크플로

목록 조회가 실패할 때

워크플로 목록은 별도 워크플로 엔진에서 조회합니다. 엔진에 일시 장애가 있으면 500 INTERNAL이 반환될 수 있습니다. 이 500 응답에는 details가 없습니다. 엔진 오류가 밖으로 노출되지 않도록 메시지를 비워 두기 때문입니다. 에러 가이드에 따라 백오프 후 다시 요청하는 것이 유일한 대응입니다.