API

네이버 스마트 알림톡

작성일 2026.03.01 | 수정일 2026.03.01

엔드포인트, 요청 본문, 응답 구조 등 자세한 정보는 메시지 발송 공통 문서에서 확인해주세요

네이버 톡톡을 통해 사전 등록된 템플릿 기반의 알림 메시지를 발송합니다.

NameDescription
길이제한템플릿 기준
필수 필드to, naverOptions.talkId, naverOptions.templateId
대체 발송지원 (disableSms: false + from 필수)

필수 파라미터

NameTypeDescription
messages[].toString수신번호
messages[].naverOptions.talkIdString네이버 톡톡 ID
messages[].naverOptions.templateIdString네이버 알림톡 템플릿 ID

선택 파라미터

NameTypeDescription
messages[].fromString발신번호
대체발송을 원하면 필수
messages[].naverOptions.disableSmsBoolean대체발송 비활성화(기본값: false)
messages[].naverOptions.variablesObject템플릿 변수
{"#{변수명}": "값"} 형태

요청 예시

{
  "messages": [
    {
      "to": "01012345678",
      "from": "029302266",
      "naverOptions": {
        "talkId": "NTxxxxxxxxxxxxxxxx",
        "templateId": "NSAxxxxxxxxxxxxxxxx",
        "variables": {
          "#{고객명}": "홍길동",
          "#{주문번호}": "ORD-12345"
        }
      }
    }
  ]
}

대체발송

네이버 스마톡 알림톡 발송에 실패하면 자동으로 문자(SMS/LMS)로 대체 발송됩니다.

  • naverOptions.disableSms: false (기본값)

  • from: 사전 등록된 발신번호 명시

from 필드가 비어있거나 등록되지 않은 번호이면, 알림톡 실패 시 대체발송 없이 그대로 실패합니다.

자세한 내용은 TODO 대체발송 문서를 확인해주세요.