템플릿 생성

알림톡은 문구를 그때그때 지어 보내는 메시지가 아니에요. 카카오 검수에서 승인(APR)된 템플릿으로만 보낼 수 있어요. 예약 확정, 수강 안내, 청구서처럼 고객의 이용에 따른 정보성 안내를 템플릿으로 먼저 만들고, 승인을 받은 뒤 변수만 바꿔 보내요.

공식 템플릿에 맞는 문구가 있으면 그걸 쓰는 편이 빨라요. 부트페이가 검수를 받아 둔 템플릿이라 그룹키가 등록된 채널이면 검수 없이 바로 보낼 수 있어요. 맞는 문구가 없을 때 여기서 자체 템플릿을 만들어요.

승인까지의 순서

반려되면 반려 사유대로 수정한 뒤 다시 검수를 요청해요.

만들기만 해서는 카카오 검수가 시작되지 않아요. 검수를 요청하기 전까지는 고치거나 지울 수 있으니, 검수 요청 전에 문구를 확인하면 돼요.

요청 파라미터

메시지 유형

강조 유형

아이템리스트형 글자 수 제한

버튼

버튼 링크에는 변수를 쓸 수 있고, 그 변수도 required_variables에 잡혀요.

코드 예제

curl -X POST "https://message.bootapi.com/alimtalk/templates" \
  -H "Authorization: Basic {base64(client_key:secret_key)}" \
  -H "Content-Type: application/json" \
  -d '{
    "ksp_id": "6a718d6cdd5558fb1fff72af",
    "name": "예약 확정 안내",
    "content": "#{company_name}\n#{user_name}님, #{booking_date} 예약이 확정되었어요.",
    "msg_type": "BA",
    "buttons": [
      {
        "name": "예약 확인하기",
        "linkType": "WL",
        "linkMo": "https://#{mobile_link}",
        "linkPc": "https://#{pc_link}"
      }
    ]
  }'bash

require 'bootpay'

commerce = BootpayStore::RestClient.new(client_key: 'your-commerce-client-key', secret_key: 'your-commerce-secret-key')
response = commerce.alimtalk_template_create(
  ksp_id: '6a718d6cdd5558fb1fff72af',
  name: '예약 확정 안내',
  content: "\#{company_name}\n\#{user_name}님, \#{booking_date} 예약이 확정되었어요.",
  msg_type: 'BA',
  buttons: [
    {
      name: '예약 확인하기',
      linkType: 'WL',
      linkMo: 'https://#{mobile_link}',
      linkPc: 'https://#{pc_link}'
    }
  ]
)
puts response.dataruby

응답

{
  "id": "68b0f2a1c3d4e5f6a7b8c9d0",
  "code": "BT_A58A7B_1A2B3C4D",
  "ksp_id": "6a718d6cdd5558fb1fff72af",
  "name": "예약 확정 안내",
  "content": "#{company_name}\n#{user_name}님, #{booking_date} 예약이 확정되었어요.",
  "msg_type": "BA",
  "emphasize_type": "NONE",
  "required_variables": ["company_name", "user_name", "booking_date", "mobile_link", "pc_link"],
  "inspection_status": "registered",
  "vendor_status": 1,
  "comments": [],
  "comment_count": 0,
  "created_at": "2026-08-27T10:00:00+09:00"
}json

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

에러 코드

변수 예문 사전

템플릿 본문의 #{user_name} 같은 자리표시자는 그대로 보면 무슨 메시지인지 알기 어려워요. 채널마다 표시용 예문​​을 모아 둔 사전이 있어서, 템플릿·공식 템플릿 응답의 variable_examples 와 미리보기가 홍길동처럼 읽혀요.

사전은 두 경로로 채워져요.

• 템플릿을 생성·수정할 때 examples 를 주면 그 채널 사전에 합쳐져요.
• 템플릿과 상관없이 예문만 바꾸려면 아래 API를 불러요.

보낸 키만 덮어쓰는 부분 갱신​​이에요. 다른 변수의 예문은 그대로 남고, 한 채널 안에서는 같은 변수에 같은 예문이 적용돼요. 빈 문자열은 무시돼서 이 API로 예문을 지울 수는 없어요. . 이 들어가거나 $ 로 시작하는 키는 오류 없이 버려져요.

curl -X PUT "https://message.bootapi.com/alimtalk/senders/6a718d6cdd5558fb1fff72af/variable_examples" \
  -H "Authorization: Basic {base64(client_key:secret_key)}" \
  -H "Content-Type: application/json" \
  -d '{ "examples": { "user_name": "홍길동", "company_name": "부트페이몰" } }'bash

갱신된 사전 전체를 돌려줘요.

{
  "ksp_id": "6a718d6cdd5558fb1fff72af",
  "variable_examples": {
    "user_name": "홍길동",
    "company_name": "부트페이몰",
    "order_number": "20260827-0001"
  }
}json

이 프로젝트에 연동된 채널이 아니면 3024(SENDER_NOT_LINKED)예요. 공식 템플릿은 조회할 때 ksp_id 를 넘기면 그 채널 사전으로 채워지고, 자체 템플릿은 소속 채널의 사전이 자동으로 적용돼요.

다음 단계

검수 요청으로 카카오 심사를 맡겨요. 승인이 나면 발송할 수 있어요.