톡 스튜디오 · 알림톡 단건 발송

알림톡 단건 발송

승인된 알림톡 템플릿으로 알림톡 1건을 발송하는 API입니다. 실패 시 대체문자(SMS/LMS) 발송을 함께 지정할 수 있습니다.

인증이 필요한 요청에는 Accesskey · Secretkey 헤더를 첨부합니다. 공통 응답 형식과 에러 코드는 빠른 시작을 참고하세요.

POST /talk/v1/at

승인된 알림톡 템플릿으로 알림톡 1건을 발송하는 API입니다. 실패 시 대체문자(SMS/LMS) 발송을 함께 지정할 수 있습니다.

이름	타입	필수	기본값	조건	설명
`to`	string	필수	-	-	수신번호입니다.
`template_key`	string	필수	-	-	발송할 알림톡 템플릿 key입니다. 승인(APR) 상태의 템플릿만 발송할 수 있습니다.
`profile_key`	string	선택		-	발신프로필 키(sender key)입니다. 그룹 프로필 템플릿은 실제 발송할 일반프로필 키가 필요합니다. 단일 프로필 템플릿은 비워도 됩니다.
`variables`	object	선택		-	템플릿 치환 변수입니다. #{} 없이 변수명만 키로 전달합니다(예: {"고객명": "홍길동"}). 템플릿에 쓰인 변수는 모두 채워야 합니다.
`fallback`	boolean	선택	`false`	-	알림톡 실패 시 대체문자(SMS/LMS) 발송 여부입니다.
`fallback_text`	string	선택		-	대체문자 내용입니다. fallback이 true면 필수이며, 길이에 따라 SMS/LMS가 자동 결정됩니다.
`fallback_subject`	string	선택	`제목없음`	-	대체문자가 LMS로 전환될 때 사용할 제목입니다.
`fallback_from`	string	선택		-	대체문자 발신번호입니다. fallback이 true면 필수이며, 워크스페이스에 승인 등록된 번호만 사용할 수 있습니다.
`reserve_dttm`	string	선택		YYYY-MM-DD HH:mm:ss	예약 발송 시각입니다. 미래 시각이면 예약, 과거이거나 비우면 즉시 발송됩니다.
`idem_key`	string	선택		-	멱등키입니다. 같은 키로 다시 접수하면 중복 발송·중복 차감 없이 기존 접수를 그대로 반환합니다.

예시 생성 중…

{
  "traceId": "9f2c1a7b-4e0d-4b1a-8c2e-1f3a5d7b9c0e",
  "code": "000000",
  "message": "성공",
  "send_key": "a1b2c3d4e5f6a7b8c9d0",
  "count": 1
}