ClawOps APIKakao Channels

카카오 채널 상세 조회

View as Markdown
연결된 채널 하나를 조회합니다. **목록과 달리 카카오 쪽 상태를 실제로 확인하고 `status` 를 갱신합니다.** 채널 연결 요청이 타임아웃됐을 때 결과를 확정하는 경로이기도 합니다 — 연결 요청을 재호출하면 중복 등록을 시도하게 되지만, 이 조회는 몇 번을 불러도 안전합니다. 카카오 쪽 조회에 실패해도 `404` 가 아닙니다. 연결 기록 자체는 유효하므로 `status` 를 `needs_attention` 으로 표시해 돌려줍니다 — 채널이 실제로 끊겼는지, 일시적인 조회 실패인지는 다시 호출해 확인하세요.

Authentication

AuthorizationBearer

API Key를 Bearer 토큰으로 전달

Path parameters

accountIdstringRequired

계정 ID

channelIdstringRequired

채널 목록에서 받은 ClawOps 채널 리소스 ID. 검색용 ID(example)가 아닙니다.

Response

채널 상세

idstringOptional

ClawOps 채널 리소스 ID. 템플릿 조회와 발송 요청에 이 값을 사용합니다.

searchIdstringOptional

카카오 채널 검색용 ID. @ 없는 형태로 저장·응답됩니다(@ 를 붙여 보내도 떼어냅니다). 채널 소유자가 카카오 비즈니스에서 바꿀 수 있는 값이므로 연동 키로 쓰지 마세요 — 키는 id 입니다.

namestringOptional

카카오 채널 이름

categoryCodestringOptional

채널 업종 카테고리 코드. 값 목록은 채널 카테고리 조회로 받습니다.

statusenumOptional

connected = 연결 완료. needs_attention = 연결 기록은 있으나 카카오 채널 상태를 확인하지 못한 상태입니다 (채널이 실제로 끊겼을 수도, 일시적인 조회 실패일 수도 있습니다). 상세 조회를 다시 호출하면 재확인합니다.

managerPhoneMaskedstring or nullOptional

채널 담당자 휴대전화번호(마스킹). 원문은 저장하지 않으므로 응답에도 마스킹된 값만 나갑니다.

connectedAtdatetimeOptional

채널이 이 계정에 연결된 시각

syncedAtdatetime or nullOptional

카카오 채널 상태를 마지막으로 확인한 시각. null 이면 연결 이후 한 번도 확인하지 않은 상태입니다.

createdAtdatetimeOptional
updatedAtdatetimeOptional

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error