워크플로

목록 조회

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

Scope: workflows:read

자동화 연동에서 워크플로의 id·활성 여부·트리거 종류를 조회하는 용도입니다. 워크플로 정의(노드·조건 등)는 공개 API로 노출되지 않습니다. 워크플로 수는 관리자가 정의하는 소규모 집합이라 페이지네이션이 없으며(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는 빈 배열([])입니다. is_active는 발행/활성 여부 플래그로, 비활성 워크플로도 함께 반환됩니다(필터 없음).

trigger_type은 워크플로가 어떤 조건에서 시작되는지를 나타내는 코드입니다.

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

워크플로 목록은 별도 워크플로 엔진에서 조회하므로, 엔진 일시 장애 시 500 INTERNAL이 반환될 수 있습니다 — 에러 가이드에 따라 백오프 후 재시도하세요. 이 500의 응답 본문에는 별도 details가 없으므로(상류 엔진 오류 노출 방지를 위해 메시지가 비어 있음), 백오프 후 재시도가 유일한 대응입니다.

목록 조회​

목록 조회