ClawOps APIKakao Channels

카카오 채널 연결

View as Markdown
담당자 휴대전화로 받은 인증번호로 채널 연결을 완료합니다. **먼저 인증번호 요청을 호출해야 합니다.** 앞 단계에서 보낸 `searchId` 와 `phoneNumber` 를 여기서 다시 보냅니다 — 서버는 등록 도중 상태를 저장하지 않습니다 (미완료 상태의 담당자 전화번호를 남기지 않기 위해서입니다). **멱등입니다.** 이미 이 계정에 연결된 채널이면 인증번호를 소모하지 않고 기존 연결을 `200` 으로 돌려줍니다. 새로 연결된 경우에만 `201` 입니다. 다른 계정에 이미 연결된 채널이면 멱등이 아니라 충돌이므로 `409` 입니다. **타임아웃되면 이 요청을 다시 보내지 마세요.** 이미 연결에 성공했을 수 있어 중복 등록을 시도하게 됩니다. 대신 채널 목록이나 상세 조회로 실제 등록 여부를 확인한 뒤 결과를 확정하세요.

Authentication

AuthorizationBearer

API Key를 Bearer 토큰으로 전달

Path parameters

accountIdstringRequired

계정 ID

Request

This endpoint expects an object.
searchIdstringRequired

카카오 채널 검색용 ID. @ 를 붙여 보내도 떼어내고 처리합니다.

phoneNumberstringRequired

인증번호를 받은 담당자 휴대전화번호. 하이픈·+82 형태 모두 허용됩니다.

categoryCodestringRequired

채널 업종 카테고리 코드. 채널 카테고리 조회 응답의 code 를 그대로 보냅니다.

tokenstringRequired

담당자 휴대전화로 받은 인증번호. 저장하지 않고 확인에만 사용합니다.

Response

이미 이 계정에 연결된 채널 — 기존 연결을 그대로 반환(멱등)

idstringOptional

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

searchIdstringOptional

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

namestringOptional

카카오 채널 이름

categoryCodestringOptional

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

statusenumOptional

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

managerPhoneMaskedstring or nullOptional

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

connectedAtdatetimeOptional

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

syncedAtdatetime or nullOptional

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

createdAtdatetimeOptional
updatedAtdatetimeOptional

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
409
Conflict Error
422
Unprocessable Entity Error
429
Too Many Requests Error
503
Service Unavailable Error