톡 스튜디오 · SMS 단건 발송

SMS 단건 발송

승인된 발신번호로 SMS 1건을 발송하는 API입니다. 발송 접수 후 통신사 전송은 순차적으로 처리됩니다.

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

POST /talk/v1/sms

승인된 발신번호로 SMS 1건을 발송하는 API입니다. 발송 접수 후 통신사 전송은 순차적으로 처리됩니다.

이름	타입	필수	기본값	조건	설명
`from`	string	필수	-	-	발신번호입니다. 워크스페이스에 승인 등록된 번호만 사용할 수 있습니다.
`to`	string	필수	-	-	수신번호입니다.
`text`	string	필수	-	-	SMS 본문입니다. EUC-KR 기준 90바이트 이하만 가능합니다.
`is_ad`	boolean	선택	`false`	-	광고 문자 여부입니다. true면 (광고)·무료수신거부 문구가 자동으로 부착되고 08~20시에만 발송됩니다.
`optout_number`	string	선택		-	무료수신거부 080 번호입니다. 광고 문자에서만 사용하며, 미지정 시 워크스페이스 등록 번호 또는 공용 번호가 적용됩니다.
`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
}