연결된 채널의 카테고리·목록·상세를 조회합니다. 채널 연결은 채널 연동에서 다룹니다.
| API | 용도 |
|---|---|
| 카테고리 조회 | 발신프로필 등록 요청에 넣을 category_code를 직접 찾아야 할 때 |
| 목록 조회 | 프로젝트에 어떤 채널이 연결되어 있는지 확인할 때 |
| 상세 조회 | 한 채널의 상태를 확인하거나 카카오 상태를 다시 읽을 때 |
카테고리 조회
카카오톡 채널을 새로 만들거나 등록하는 API가 아닙니다. 발신프로필 등록의 category_code(카카오 업종 코드)에 넣을 값을 조회합니다. category_code를 안 보내면 01800010001(인터넷/통신 > 웹서비스)로 등록되므로, 업종을 따로 정할 때만 필요합니다.
curl -X GET "https://message.bootapi.com/alimtalk/categories" \
-H "Authorization: Basic {base64(client_key:secret_key)}"bashrequire 'bootpay'
commerce = BootpayStore::RestClient.new(client_key: 'your-commerce-client-key', secret_key: 'your-commerce-secret-key')
response = commerce.alimtalk_categories
puts response.dataruby응답
카카오가 정한 업종 목록을 그대로 돌려줍니다(2026년 11월 기준 148개).
{
"result": 0,
"code": "200",
"resultMsg": "정상",
"data": [
{ "code": "00100010001", "name": "건강,병원,종합병원" },
{ "code": "00600040001", "name": "소매(쇼핑몰),식품,식품" },
{ "code": "01800010001", "name": "인터넷/통신,웹서비스,웹호스팅/도메인/기타웹서비스" }
]
}json| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
data |
Array | 필수 | 업종 목록 |
code |
String | 필수 | 업종 코드 11자리(대분류 3 + 중분류 4 + 소분류 4). 발신프로필 등록의 category_code에 넣습니다 |
name |
String | 필수 | 「대분류,중분류,소분류」 이름 |
result · code · resultMsg |
Number · String · String | 필수 | 카카오 업종 조회 결과(0 · 200 · 정상) |
채널 목록
이 프로젝트에 연결된 발신프로필을 조회합니다.
코드 예제
curl -X GET "https://message.bootapi.com/alimtalk/senders" \
-H "Authorization: Basic {base64(client_key:secret_key)}"bashrequire 'bootpay'
commerce = BootpayStore::RestClient.new(client_key: 'your-commerce-client-key', secret_key: 'your-commerce-secret-key')
response = commerce.alimtalk_sender_list
puts response.dataruby응답
{
"list": [
{
"id": "6a718d6cdd5558fb1fff72af",
"ksp_id": "6a718d6cdd5558fb1fff72af",
"yellow_id": "@부트페이",
"channel_name": "부트페이",
"verified": true,
"group_key_registered": true,
"status": "active",
"created_at": "2026-08-27 10:00:00 +0900",
"template_count": 3
}
],
"count": 1
}json채널 상세
응답에서 주로 확인할 값은 verified와 group_key_registered입니다. group_key_registered가 true여야 공식 템플릿을 보낼 수 있습니다. 평소에는 부트페이에 저장된 값을 읽고, sync=true일 때만 카카오에서 상태를 다시 조회합니다.
요청 파라미터
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
ksp_id |
String | 필수 | 채널 id (경로 파라미터) |
sync |
Boolean | 선택 | true면 채널을 다시 조회해 verified 값이 오면 반영합니다. 응답에 이 값이 없으면 바뀌는 것이 없습니다. 기본은 false이고, true는 응답이 느립니다 |
코드 예제
curl -X GET "https://message.bootapi.com/alimtalk/senders/6a718d6cdd5558fb1fff72af?sync=true" \
-H "Authorization: Basic {base64(client_key:secret_key)}"bashresponse = commerce.alimtalk_sender_detail(
ksp_id: '6a718d6cdd5558fb1fff72af',
sync: true
)
puts response.dataruby응답 필드
| 필드 | 타입 | 설명 |
|---|---|---|
| ksp_id | String | 채널 id. 템플릿·해지·예문 API에서 사용 |
| yellow_id | String | 카카오 채널 검색용 아이디 |
| channel_name | String | 채널 이름 |
| verified | Boolean | 카카오 심사(그룹키 등록) 완료 여부. OTP 인증을 마쳤다는 뜻이 아닙니다. false면 자체 템플릿 생성이 3018로 막힙니다 |
| group_key_registered | Boolean | true여야 공식 템플릿을 보낼 수 있습니다 |
| status | String | 채널 상태 (active: 사용 가능, blocked: 차단, released: 해제) |
| template_count | Integer | 이 채널이 가진 자체 템플릿 수 |
채널의 비밀값인 senderKey 는 목록에도 상세에도 실리지 않습니다. 발송할 때 서버가 채우므로 따로 보관할 필요가 없습니다.
시각 필드 형식은 응답의 시각 형식을 참고합니다.
에러 코드
| 코드 | error_code | 메시지 | 대처 방법 |
|---|---|---|---|
3024 |
SENDER_NOT_LINKED |
발신프로필 미연결 | 채널이 없거나 이 프로젝트에 연동되지 않았습니다. 채널 연동을 먼저 진행합니다 |
3012 |
KAKAO_SENDER_REQUEST_FAILED |
채널 조회 실패 (HTTP 500) | sync=true 일 때만 발생합니다. 잠시 후 다시 시도하거나 sync 를 뺍니다 |
3024 는 400 이 아닙니다
채널을 찾지 못하면 404, 다른 프로젝트의 채널이면 403으로 옵니다. HTTP 상태가 아니라 error_code로 분기합니다.



