카카오 채널 연결
담당자 휴대전화로 받은 인증번호로 채널 연결을 완료합니다. 먼저 인증번호 요청을 호출해야 합니다.
앞 단계에서 보낸 searchId 와 phoneNumber 를 여기서 다시 보냅니다 — 서버는 등록 도중 상태를 저장하지 않습니다
(미완료 상태의 담당자 전화번호를 남기지 않기 위해서입니다).
멱등입니다. 이미 이 계정에 연결된 채널이면 인증번호를 소모하지 않고 기존 연결을 200 으로 돌려줍니다.
새로 연결된 경우에만 201 입니다. 다른 계정에 이미 연결된 채널이면 멱등이 아니라 충돌이므로 409 입니다.
타임아웃되면 이 요청을 다시 보내지 마세요. 이미 연결에 성공했을 수 있어 중복 등록을 시도하게 됩니다. 대신 채널 목록이나 상세 조회로 실제 등록 여부를 확인한 뒤 결과를 확정하세요.
Authentication
API Key를 Bearer 토큰으로 전달
Path parameters
계정 ID
Request
카카오 채널 검색용 ID. @ 를 붙여 보내도 떼어내고 처리합니다.
인증번호를 받은 담당자 휴대전화번호. 하이픈·+82 형태 모두 허용됩니다.
채널 업종 카테고리 코드. 채널 카테고리 조회 응답의 code 를 그대로 보냅니다.
담당자 휴대전화로 받은 인증번호. 저장하지 않고 확인에만 사용합니다.
Response
이미 이 계정에 연결된 채널 — 기존 연결을 그대로 반환(멱등)
ClawOps 채널 리소스 ID. 템플릿 조회와 발송 요청에 이 값을 사용합니다.
카카오 채널 검색용 ID. @ 없는 형태로 저장·응답됩니다(@ 를 붙여 보내도 떼어냅니다). 채널 소유자가 카카오 비즈니스에서 바꿀 수 있는 값이므로 연동 키로 쓰지 마세요 — 키는 id 입니다.
카카오 채널 이름
채널 업종 카테고리 코드. 값 목록은 채널 카테고리 조회로 받습니다.
connected = 연결 완료. needs_attention = 연결 기록은 있으나 카카오 채널 상태를 확인하지 못한 상태입니다 (채널이 실제로 끊겼을 수도, 일시적인 조회 실패일 수도 있습니다). 상세 조회를 다시 호출하면 재확인합니다.
채널 담당자 휴대전화번호(마스킹). 원문은 저장하지 않으므로 응답에도 마스킹된 값만 나갑니다.
채널이 이 계정에 연결된 시각
카카오 채널 상태를 마지막으로 확인한 시각. null 이면 연결 이후 한 번도 확인하지 않은 상태입니다.