"메시지가 템플릿과 일치하지 않음" 사유로 전송에 실패 되었습니다.

2023.07.11

API 알림톡 전송 시 입력 된 1.버튼 정보, 2.강조표기 타이틀, 3.버튼내 링크, 4.개행/띄어쓰기, 5.본문이 승인 된 
템플릿과 상이하거나 일부 정보가 누락 된 경우 해당 사유로 실패 될 수 있습니다.(버튼 형식 에러도 동일)

#{변수}를 제외한 모든 데이터는 승인 된 템플릿과 일치해야 전송이 가능하며 해당 사유로 실패 된 경우 승인 된 
템플릿과의 차이점, 누락 내용을 확인 하신 뒤 아래 내용을 참고해 주시기 바랍니다.

템플릿 리스트 바로가기

※ 안내 드리는 코드 및 내용은 반드시 운용하시는 각 개발환경에 맞게 적용하여 호출해 주시기 바랍니다.



1. 버튼(button_1)


버튼은 JSON 포맷을 문자열(string)로 입력해주셔야 하며 일부 개발 언어의 경우

별도의 변환 과정이 필요할 수 있습니다.(Json.stringfy, json.dumps 등)

입력 된 버튼의 형식이 올바르지 않거나 누락 된 경우에도 실패 처리 될 수 있으니 버튼이 포함 된 템플릿을 
전송하시는 경우 아래 내용을 확인해 주시기 바랍니다, 

버튼의 JSON 형식은 아래와 같습니다.

button_1: {
“button”: [{
"name" : 버튼명
"linkType" : DS, WL, AL, BK, MD, AC 중에서 1개
"linkTypeName" : 배송조회, 웹링크, 앱링크, 봇키워드, 메시지전달, 채널 추가 중에서 1개
"linkMo" : 설정한 모바일 링크
"linkPc" : 설정한 PC 링크
또는
"linkIos" : 설정한 IOS Scheme
"linkAnd" : 설정한 Android Scheme
}]
}


알리고 홈페이지라는 웹링크(WL) 버튼 추가를 했을 때의 예시는 아래와 같습니다. 

button_1: {
"button": [{
"name": “알리고 홈페이지”,
"linkType": "WL",
"linkTypeName": "웹링크",
"linkPc": "https://smartsms.aligo.in/",
"linkMo" : “https://smartsms.aligo.in/”
}]
}


"채널 추가(AC)" 버튼 또는 2개 이상의 버튼이 삽입 된 템플릿은 아래와 같이 입력해 주셔야 합니다.

button_1: {
"button": [{
"name": "채널 추가",
"linkType": "AC",
"linkTypeName": "채널 추가"
}, 
{"name": "알리고 홈페이지",
"linkType": "WL",
"linkTypeName": "웹링크",
"linkPc": "https://smartsms.aligo.in/",
"linkMo" : “https://smartsms.aligo.in/"
}]
}


URL이 없는 “채널 추가(AC)” 또는 “배송조회(DS)” 버튼만 단독으로 삽입 된 템플릿은 아래와 같이 입력 바랍니다. 

 button_1: {
"button": [{
"name": "채널 추가",
"linkType": "AC",
"linkTypeName": "채널 추가"
}]
}
 button_1: {
"button": [{
"name": "배송조회",
"linkType": "DS",
"linkTypeName": "배송조회"
}]
}

※ 반드시 운용중인 개발언어에 맞게 적용하시어 호출해주시기 바랍니다.

 

 

2. 강조표기형 타이틀(emtitle_1)


강조표기형 템플릿을 전송하시는 경우 emtitle_1 파라미터를 추가하시어 
타이틀을 입력해 주셔야 합니다.



승인 된 템플릿에 강조표기 타이틀이 삽입 되어 있다면 발송환경 내에 emtitle_1 파라미터를 추가하신 뒤 
템플릿 내 타이틀을 입력해 주시기 바랍니다.(위 이미지의 경우 “알리고스마트 문자 서비스”가 타이틀)

※ 템플릿 내 이미지, 서브타이틀, 부가정보 항목은 자동으로 입력되는 관계로 입력하지 않으셔도 무관합니다.

 

 

3. 버튼 내 링크


버튼 내 링크 URL이 템플릿과 상이한 경우에도 “메시지가 템플릿과 일치하지 
않음” 사유로 실패 될 수 있습니다.

호출 시 입력한 링크가 템플릿과 일치하는지 확인해 주시기 바랍니다.

승인 받은 도메인이 https:// 또는 http://인지 확인해주시기 바라며 알림톡 전송 시 고객에 따라 링크 내 일부
값을 유동적으로 전송하셔야 하는 경우 https://#{URL} 또는 http://#{URL} 와 같은 형식으로 템플릿을 신규로
생성해 주시기 바랍니다.

템플릿 생성 바로가기 

※ 버튼 내 URL은 템플릿 생성 시 일부 값을 변수로 설정하실 수 있습니다.
   - ex).  http://nplus.doortodoor.co.kr/web/detail.jsp?slipno=#{운송장번호}

 

 

4. 개행 처리


개행(줄바꿈) 및 띄어쓰기가 승인 된 템플릿과 일치하는지 확인해주시기 
바랍니다.

보편적으로 개행은 /n 문자열로 처리 할 수 있으나 PHP의 경우 PHP_EOL로 처리 할 수 있으며 운용하시는
개발언어 별 설치 되어 있는 패키지에 따라서도 개행 방법은 상이할 수 있습니다.

운용하시는 개발환경에 맞는 개행 처리 방법으로 입력해 주시기 바라며 띄어쓰기 또한 확인해 주시기 바랍니다.

 

 

5. 본문 내 변수


변수는 message_1 파라미터 내 고정 문구와 함께 입력해주시면 됩니다.

안녕하세요. #{고객명}님!
주문이 완료 되었습니다.

■ 아이디 : #{아이디}
■ 주문번호 : #{주문번호}
■ 상품명 : #{상품명}

알리고 문자를 이용해 주셔서 진심으로 감사 드립니다.

템플릿의 경우

안녕하세요. 홍길동님!
주문이 완료 되었습니다.

■ 아이디 : ALIGO
■ 주문번호 : 1234567890
■ 상품명 : 알림톡 API

알리고 문자를 이용해 주셔서 진심으로 감사 드립니다.

와 같이 message_1 파라미터에 함께 입력하여 발송해 주시면 됩니다.