연동

목록 조회

GET /integrations — 채널 연동(Kakao/Naver/LINE/email 등) 목록을 cursor pagination으로 조회합니다.

Scope: integrations:read
쿼리: limit(기본 50, 최대 100), cursor
최신순(created_at 내림차순)으로 정렬됩니다.
limit이 [1, 100] 범위를 벗어나면 400 INVALID_QUERY로 거부됩니다(자동 보정 없음). cursor는 발급 후 24시간이 지나면 만료됩니다.

curl "https://api.talk.zeroworks.ai/api/public/v1/integrations?limit=50" \
  -H "Authorization: Bearer ztpat_..."

응답

{
  "success": true,
  "data": [
    {
      "id": "e1f2a3b4-...",
      "provider": "kakao",
      "name": "카카오 상담톡",
      "status": "active",
      "created_at": "2026-01-01T00:00:00Z",
      "updated_at": "2026-05-01T10:00:00Z"
    }
  ],
  "meta": { "has_more": true, "next_cursor": "eyJ..." }
}

provider는 연동 벤더로, 고정된 값 집합입니다: web·kakao·naver·line·whatsapp·instagram·sms·email.

status는 연동 상태이며 다음 6개 값 중 하나입니다: active·inactive·error·pending·awaiting_setup·awaiting_activation. 완전히 연결되어 사용 가능한 상태는 active뿐이며, 나머지는 설정 대기·비활성·오류 등을 나타냅니다.

자격 증명은 노출되지 않습니다. 암호화된 credentials, webhook secret/token, 벤더별 config 등 모든 비밀 값은 SELECT 단계에서 제외되며 공개 API 응답에 포함되지 않습니다.

목록 조회​

목록 조회