본문으로 건너뛰기
색인되지 않은 문서
이 문서는 색인되지 않습니다. 검색 엔진이 이 문서를 색인하지 않으며, 주소를 알고 있는 사용자만 접근할 수 있습니다.
메시지서비스 알림톡 API 규격서 ver. 2025.11.07

알림톡 REST API

알림톡 발송​

기본정보​

HEADERS

Content-Type  application/json;charset=UTF-8
AUTH   base64_encode ( API Key )

알림톡 발송​

알림톡의 발송 가능 문자수는 한/영 구분 없이 1,000자까지 발송 가능합니다.
반드시 변수 포함 1,000자 이내로 작성해주셔야 합니다.
발신번호는 '발신번호 관리'에서 등록된 번호여야 합니다.

URL

	POST    https://alimtalk.bizservice.iwinv.kr/api/v2/send/

BODY

{
    "templateCode": "10030",
    "reserve": "Y",
    "sendDate": "2025-07-20 05:00:00",
    "reSend": "Y",
    "resendCallback": "01000000000",
    "resendType": "Y",
    "resendTitle": "smstitle",
    "resendContent": "smscontent",
    "list":
    [
        {
            "phone": "01012341234",
            "templateParam": ["11","2","3"]
        },
        {
            "phone": "01012341235",
            "templateParam": ["1","2","3"]
        },
        {
            "phone": "01012341236",
            "templateParam": ["1","2","3"]
        }
    ]
}

값타입필수설명예시
templateCodeStringO사용 가능한 템플릿 코드10001
reserveStringX (기본 N)예약발송 여부(N:즉시발송, Y:예약발송)Y , N
sendDateStringX발송 시각(예약 발송인 경우 필수, 예약 발송은 현재 시간 15분 이후 이틀 이전까지만 가능합니다.)yyyy-MM-dd HH:mm:ss
reSendStringX (기본 N)알림톡 발송 실패 시 대체 문자 전송 기능(Y:대체 발송, N:대체 발송 없음)Y , N
resendCallbackStringO발신번호010-0000-0000 혹은 01000000000
resendTypeStringX (기본 Y)대체 발송 내용 타입 (Y:알림톡 내용, N:직접 입력)Y , N
resendTitleStringX실패 시 LMS 대체 문자 제목-
resendContentStringX실패 시 대체 문자 내용(대체 발송 내용 타입 직접 입력 시 필수)SMS(90Bytes 이하) / LMS(91~2000 Bytes)
listArrayO수신자 리스트(최대 1000명)-
- phoneArrayO수신번호010-0000-0000 혹은 01000000000
- templateParamArrayX템플릿 변수(템플릿 내용 중 치환할 항목(변수) 포함 시 필수)[["항목1","항목2","항목3"],["항목1","항목2","항목3"]]

응답

{
    "code": 200,
    "message": "메시지가 발송되었습니다",
    "success": 3,
    "fail": 1
}

값타입설명
codeInteger응답 코드
messageString응답 코드 결과 메시지
successInteger정상적으로 전송 요청된 연락처 개수
failInteger중복번호로 인해 전송 요청되지 않은 연락처 개수

알림톡 발송 결과 코드 값

코드설명
200메시지가 발송되었습니다.
501( templateCode )값을 정확히 입력해 주세요.
502( ist )값을 정확히 입력해 주세요.
503( reSend )값을 정확히 입력해 주세요.
504유효하지 않는 값(resendType)입니다.
505발신번호는 발신번호 관리에서 사전에 등록된 발신번호로만 발송이 가능합니다.
506유효하지 않는 값(sendDate)입니다.
507예약 전송은 현재 시간 15분 이후 이틀 이전까지만 가능합니다.
508templateParam은(는) 필수 입력 항목입니다.
509메시지 내용이 템플릿과 일치하지 않습니다.
510제목은 40 Bytes 까지만 입력이 가능합니다.
511제목 입력 가능 문자 : 한글, 영어, 숫자, 허용된 특수문자는 ( [ ] ( ) < > )입니다.
512수신 번호를 입력하여 주세요.
513핸드폰 번호 형식(예: 010-1234-45678 혹은 01012345678)에 맞춰 입력하여 주십시오.
514알림톡 발송은 1회 최대 10,000건까지 전송 가능합니다.
515대체 발송 메시지는 1,000자까지만 입력이 가능합니다.
516대체 발송으로 알림톡 내용 발송 시 변수가 치환되어 1,000자까지만 입력할 수 있습니다.
517알림톡 메시지 변수가 치환되어 1,000자까지만 입력할 수 있습니다.
518요금 충전 호출에 실패했습니다.
519잔액이 부족합니다.
540금칙어가 포함되어 메지시 발송이 금지 됩니다. (금칙어 : ooo )