새로운 문서를 작성 중입니다.새 문서로 이동
ClawOps Docs
API Reference

카카오 채널 연결 해제

DELETE
/v1/accounts/{accountId}/kakao/channels/{channelId}

채널 연동을 해제합니다. 카카오톡 채널 자체는 지워지지 않고, ClawOps(SOLAPI)와의 연동만 끊깁니다.

⚠️ 되돌릴 수 없고, 그 채널에 등록된 알림톡 템플릿도 함께 삭제됩니다. 템플릿은 카카오 검수를 다시 받아야 하므로 복구에 시간이 걸립니다 — 호출 전에 사용자에게 이 사실을 알리고 확인을 받으세요.

해제 후에는 그 채널을 다시 연결할 수 있습니다(본인이든 다른 계정이든). 인증번호 요청부터 다시 시작하면 됩니다.

이미 해제된 채널이나 이 계정 소유가 아닌 채널은 404 입니다. 다른 계정의 채널은 해제할 수 없습니다.

되돌릴 수 없는 동작이므로 사용자 확인을 거친 뒤 호출하세요. 이 API 는 확인 절차를 대신해 주지 않습니다 — 대시보드에서 해제할 때는 삭제되는 내용을 안내하고 확인을 받습니다.

해제 요청은 감사 기록에 남습니다. API 키로 호출하면 키에는 사용자 정보가 없어 "누가" 는 남지 않고 "API 키로 해제됨" 으로만 기록됩니다 — 담당자 단위 추적이 필요하면 대시보드에서 해제하세요.

Authorization

BearerAuth
AuthorizationBearer <token>

API Key를 Bearer 토큰으로 전달

In: header

Path Parameters

accountId*string

계정 ID

channelId*string

카카오 채널 식별자(channelId). 검색용 ID(example)가 아닙니다.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/v1/accounts/AC1a2b3c4d/kakao/channels/KA01PF250101000000000abcdefg"
{
  "id": "clx9kak0001",
  "channelId": "KA01PF250101000000000abcdefg",
  "searchId": "example",
  "name": "러너스 고객센터",
  "categoryCode": "00100010001",
  "status": "connected",
  "managerPhoneMasked": "010-****-5678",
  "connectedAt": "2019-08-24T14:15:22Z",
  "syncedAt": "2019-08-24T14:15:22Z",
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z"
}
{
  "error": "string",
  "code": "recipient_blocked"
}
{
  "error": "string",
  "code": "recipient_blocked"
}
{
  "error": "string",
  "code": "recipient_blocked"
}
{
  "error": "string",
  "code": "recipient_blocked"
}
{
  "error": "string",
  "code": "recipient_blocked"
}