발신프로필 API

처음 설정할 때는 채널 연동만 따라가면 돼요. 이 페이지의 API는 연결된 채널을 코드로 확인하거나 관리할 때 사용해요.

카테고리 조회

카카오톡 채널을 새로 만들거나 등록하는 API가 아니에요. POST /alimtalk/senders를 직접 호출하면서 채널 업종 코드가 필요할 때만 조회해요.

curl -X GET "https://message.bootapi.com/alimtalk/categories" \
  -H "Authorization: Basic {base64(client_key:secret_key)}"bash

require 'bootpay'

commerce = BootpayStore::RestClient.new(client_key: 'your-commerce-client-key', secret_key: 'your-commerce-secret-key')
response = commerce.alimtalk_categories
puts response.dataruby

채널 목록

이 프로젝트에 연결된 발신프로필을 확인해요.

코드 예제

curl -X GET "https://message.bootapi.com/alimtalk/senders" \
  -H "Authorization: Basic {base64(client_key:secret_key)}"bash

require '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-27T10:00:00+09:00",
      "template_count": 3
    }
  ],
  "count": 1
}json

채널 상세

응답에서 주로 확인할 값은 verified와 group_key_registered예요. group_key_registered가 true여야 공식 템플릿을 보낼 수 있어요. 평소에는 부트페이에 저장된 값을 읽고, sync=true일 때만 카카오에서 상태를 다시 조회해요.

요청 파라미터

코드 예제

curl -X GET "https://message.bootapi.com/alimtalk/senders/6a718d6cdd5558fb1fff72af?sync=true" \
  -H "Authorization: Basic {base64(client_key:secret_key)}"bash

response = commerce.alimtalk_sender_detail(
  ksp_id: '6a718d6cdd5558fb1fff72af',
  sync: true
)
puts response.dataruby

응답 필드

채널의 비밀값인 senderKey 는 목록에도 상세에도 실리지 않아요. 발송할 때 서버가 알아서 채우니 따로 보관할 필요가 없어요.

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

에러 코드