알림톡 설정

변수 예문 사전

미리보기에서 #{user_name} 대신 홍길동으로 읽히게 하는 표시용 값이에요.

템플릿 미리보기를 사람이 읽을 수 있게 만드는 예문을 등록해요.

템플릿 본문에는 #{user_name} 같은 자리표시자가 들어가요. 그대로 보면 무슨 메시지인지 알기 어려워서, 채널마다 표시용 예문​​을 등록해 두면 미리보기가 홍길동처럼 읽혀요.

발송값이 아니에요

여기 등록한 값은 화면 표시 전용​​이에요. 카카오로 전송되지 않고 검수 상태에도 영향을 주지 않아요. 실제로 나가는 값은 발송의 variables예요.

PUThttps://message.bootapi.com/alimtalk/senders/{ksp_id}/variable_examplesBasic Auth

요청 파라미터

파라미터 타입 필수 설명
ksp_id String 필수 채널 id (경로 파라미터)
examples Object 선택 변수명 → 예문 매핑. 비우면 아무것도 바꾸지 않고 현재 사전을 돌려줘요. 키에 . 이나 선행 $ 는 쓸 수 없어요

보낸 키만 덮어쓰는 부분 갱신​​이에요. 기존에 있던 다른 변수의 예문은 그대로 남아요. 한 채널 안에서는 같은 변수에 같은 예문이 적용돼요. 값을 빈 문자열로 보내면 무시돼서, 이 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

에러 코드

코드 error_code 메시지 대처 방법
3024 SENDER_NOT_LINKED 발신프로필 미연결 이 프로젝트에 연동된 채널인지 채널 목록에서 확인해요
템플릿 응답에도 함께 나와요

공식 템플릿과 자체 템플릿 응답의 variable_examples가 이 사전을 반영한 값이에요. 공식 템플릿은 조회할 때 ksp_id를 함께 넘기면 그 채널 기준으로 채워지고, 자체 템플릿은 소속 채널의 사전이 자동으로 적용돼요.