채널 연동

카카오톡 채널은 카카오비즈니스 파트너센터에서 먼저 만들어요. 이 페이지에서는 이미 만든 채널을 부트페이 프로젝트의 발신프로필​​로 연결하는 API를 다뤄요.

연결 순서는 인증번호 받기 → 발신프로필 등록이에요. 인증번호는 채널 관리자 휴대폰으로 전송되며, 관리자 목록에 없는 번호로는 받을 수 없어요. 발신프로필을 등록한 뒤에는 공식 템플릿을 사용할 수 있도록 그룹키 연결도 시도해요.

시작 전에 확인하세요

• 카카오톡 채널이 비즈니스 채널​​로 전환되어 있어야 해요.
• 채널이 공개 상태여야 해요(채널 정보 → 채널 공개). 고객센터 정보도 입력되어 있어야 해요.
• 인증에 쓸 휴대폰 번호가 해당 채널의 관리자로 등록되어 있어야 해요.
• 채널의 검색용 아이디(@...)를 확인해 두세요.

이 조건을 충족하지 않으면 발신프로필이 등록되지 않아요. 채널 설정은 카카오비즈니스 파트너센터에서 확인할 수 있어요.

1OTP 발송

yellow_id와 관리자 휴대폰 번호를 보내면 인증번호가 문자로 와요. 받은 번호는 2단계의 otp에 넣어요.

요청 파라미터

코드 예제

curl -X POST "https://message.bootapi.com/alimtalk/senders/otp" \
  -H "Authorization: Basic {base64(client_key:secret_key)}" \
  -H "Content-Type: application/json" \
  -d '{
    "yellow_id": "@부트페이",
    "phone": "01012345678"
  }'bash

response = commerce.alimtalk_sender_otp(
  yellow_id: '@부트페이',
  phone: '01012345678'
)
puts response.dataruby

2발신프로필 등록

앞에서 확인한 채널 정보와 인증번호를 보내 발신프로필을 등록해요.

요청 파라미터

코드 예제

curl -X POST "https://message.bootapi.com/alimtalk/senders" \
  -H "Authorization: Basic {base64(client_key:secret_key)}" \
  -H "Content-Type: application/json" \
  -d '{
    "otp": "123456",
    "yellow_id": "@부트페이",
    "phone": "01012345678",
    "category_code": "008001001"
  }'bash

response = commerce.alimtalk_sender_create(
  otp: '123456',
  yellow_id: '@부트페이',
  phone: '01012345678',
  category_code: '008001001'
)
puts response.dataruby

응답

성공 응답

{
  "id": "6a718d6cdd5558fb1fff72af",
  "ksp_id": "6a718d6cdd5558fb1fff72af",
  "yellow_id": "@부트페이",
  "channel_name": "부트페이",
  "verified": true,
  "group_key_registered": true,
  "status": "active",
  "created_at": "2026-08-27T10:00:00+09:00",
  "template_count": 0
}json

verified와 group_key_registered가 모두 true면 채널 연결이 끝난 상태예요. 공식 템플릿을 골라 발송할 수 있어요.

같은 채널(yellow_id)을 다시 등록하면 새로 만들지 않고 기존 발신프로필을 그대로 재사용해요.

발신프로필은 등록됐지만 그룹키 연결에 실패할 수도 있어요. 이때 응답의 verified·group_key_registered가 false로 오고, 자체 템플릿 생성은 3018, 공식 템플릿 발송은 3016으로 막혀요. 부트페이에 문의해 연결 상태를 확인해 주세요.

시각 필드 형식은 응답의 시각 형식을 먼저 봐요.

에러 응답

{
  "error_code": "SENDER_NOT_VERIFIED",
  "message": "발신프로필 검증에 실패했습니다. 카카오채널의 비즈니스 인증(비즈니스 채널 전환 · 홈 공개 ON · 고객센터 정보 입력)을 완료했는지 확인해 주세요."
}json

error_code는 숫자가 아니라 문자열이에요. 상류가 돌려준 응답이 있으면 payload에 원문이 함께 담기고, 없으면 payload 키가 빠져요.

발신프로필 상태 (status)

에러 코드

다음 단계

채널 연결이 끝났다면 보낼 문구를 정해요. 주문·배송·구독 안내는 공식 템플릿 검색에서 찾고, 서비스에 맞는 별도 문구가 필요하면 자체 템플릿 만들기로 이어가세요.