상담 태그
상담(채널)에 붙이는 태그의 카탈로그입니다. 연락처 태그(/contact-tags)와는 완전히 별개의 목록이라, 같은 이름의 태그가 한쪽에만 있을 수 있습니다.
특정 상담에 실제로 붙어 있는 태그는 이 엔드포인트가 아니라 채널 객체의 tags 배열에 있습니다 — 채널 참조.
목록 조회
GET /channel-tags — 워크스페이스에 정의된 상담 태그 카탈로그를 cursor pagination으로 조회합니다.
- Scope:
channel-tags:read - 쿼리:
limit(기본 50, 최대 100),cursor
정렬은 created_at 내림차순입니다.
curl "https://api.talk.zeroworks.ai/api/public/v1/channel-tags?limit=50" \
-H "Authorization: Bearer ztpat_..."
응답
{
"success": true,
"data": [
{
"id": "t1a2b3c4-...",
"name": "환불요청",
"color": "#ff0000",
"created_at": "2026-01-01T00:00:00Z",
"updated_at": "2026-05-01T10:00:00Z"
},
{
"id": "t5d6e7f8-...",
"name": "재고문의",
"created_at": "2026-01-02T00:00:00Z",
"updated_at": "2026-01-02T00:00:00Z"
}
],
"meta": { "has_more": false }
}
color는 미지정 시 null이 아니라 키가 생략됩니다 ("color" in tag로 판별). 위 예시의 두 번째 태그가 색상 미지정 상태입니다.
상담 태그의 사용 횟수 값은 대시보드 내부에서도 신뢰하지 않는 값이라 공개 API로 내보내지 않습니다. 특정 태그가 붙은 상담 수가 필요하면 채널 목록을 ?tags=로 필터링해 세어 주세요.
태그로 상담 찾기
카탈로그에서 이름을 얻은 뒤, 채널 목록을 그 이름으로 필터링합니다.
# '환불요청' 또는 'VIP' 가 붙은 상담
curl "https://api.talk.zeroworks.ai/api/public/v1/channels?tags=환불요청,VIP&tag_match=any" \
-H "Authorization: Bearer ztpat_..."
# 둘 다 붙은 상담
curl "https://api.talk.zeroworks.ai/api/public/v1/channels?tags=환불요청,VIP&tag_match=all" \
-H "Authorization: Bearer ztpat_..."
파라미터 정의는 채널 — 목록 조회에 있습니다. 다음 페이지를 받을 때 cursor와 함께 tags·tag_match를 다시 보내야 합니다 — 커서는 위치만 담고 필터는 담지 않습니다.
태그 부여·해제
상담에 태그를 붙이고 떼는 것은 채널 — 태그 부여·해제에 있습니다. 이 페이지의 사전은 어떤 태그가 있는지를 알려주고, 실제 부여는 채널 엔드포인트가 합니다.
태그 사전 자체를 만들거나 지우는 것은 제공하지 않습니다. 이름 변경·삭제는 그 태그가 붙은 모든 상담에서 되돌릴 수 없게 떨어져 나가는 작업이라 대시보드에서 관리자만 할 수 있습니다.
다만 상담에 사전에 없는 이름을 붙이면 그 이름이 사전에 자동으로 추가됩니다. 연동이 임의의 이름을 계속 만들면 태그 목록이 늘어나고, 정리는 대시보드에서만 가능합니다 — 가능하면 이 페이지로 기존 이름을 먼저 조회해 쓰세요.