템플릿 메시지 인터페이스

템플릿 메시지는 공식 계정에서만 사용자에게 중요한 서비스 알림을 보내는 데 사용되며, 신용카드 스와이프 알림, 제품 구매 성공 알림 등 요구 사항을 충족하는 서비스 시나리오에서만 사용할 수 있습니다. . 광고 등의 마케팅 메시지와 사용자를 괴롭히는 기타 모든 메시지는 지원되지 않습니다.

사용 규칙 관련 사항:

1、所有服务号都可以在功能->添加功能插件处看到申请模板消息功能的入口，但只有认证后的服务号才可以申请模板消息的使用权限并获得该权限；
2、需要选择公众账号服务所处的2个行业，每月可更改1次所选行业；
3、在所选择行业的模板库中选用已有的模板进行调用；
4、每个账号可以同时使用25个模板。
5、当前每个账号的模板消息的日调用上限为10万次，单个模板没有特殊限制。【2014年11月18日将接口调用频率从默认的日1万次提升为日10万次，可在MP登录后的开发者中心查看】。当账号粉丝数超过10W/100W/1000W时，模板消息的日调用上限会相应提升，以公众号MP后台开发者中心页面中标明的数字为准。

인터페이스 문서 관련 사항:

1、模板消息调用时主要需要模板ID和模板中各参数的赋值内容；
2、模板中参数内容必须以".DATA"结尾，否则视为保留字；
3、模板保留符号"{{ }}"。

업계 설정

설정 산업은 MP로 완료할 수 있습니다. , 업종은 월 1회 수정이 가능하며, 계정은 자신이 속한 업종과 관련된 템플릿만 사용할 수 있으며, 타사 개발자의 편의를 위해 인터페이스 호출을 통해 계정이 속한 업종을 수정하는 방법을 제공하며, 다음과 같습니다:

인터페이스 호출 요청 설명

http请求方式: POST
https://api.weixin.qq.com/cgi-bin/template/api_set_industry?access_token=ACCESS_TOKEN

POST 데이터 설명

POST 데이터 예시는 다음과 같습니다. :# 🎜🎜#

      {
          "industry_id1":"1",
          "industry_id2":"4"
       }

매개변수 설명

매개변수 필요합니까access_tokenindustry_id1#🎜🎜입니다. #은 공개 계정 템플릿 메시지의 업계 번호입니다.

업종 코드 문의

	#🎜 🎜#Description
은	인터페이스 호출 자격 증명	#입니다. 🎜🎜## 🎜🎜#
은	공개 계정 템플릿 메시지의 업계 번호
industry_id2

# 🎜 🎜#10#### ## ## ## ####호텔 여행#🎜🎜 ####호텔####11#🎜🎜 ###### 🎜 #여행# 🎜 🎜##Express######13#### ## ## #####운송 및 창고#🎜🎜 ###물류#🎜🎜 ## 🎜🎜#14# 🎜🎜## 🎜 🎜#educationtraining16educationacademy# 🎜 🎜 #정부 및 공공 시설 # 🎜🎜#정부 및 공공 시설교통경찰19의료252627#🎜🎜 ## 🎜🎜#건축29부동산property비즈니스 서비스#🎜 🎜#33# 🎜🎜#중개 서비스35#🎜 🎜# 감사# 🎜🎜#体育娱乐体育娱乐#🎜 🎜#娱乐娱乐39printprint#🎜 🎜## ㅋㅋㅋ 🎜 ## 🎜🎜#

업계 정보 설정# 🎜 🎜#

계정 설정에 대한 업계 정보를 얻으세요. 업계 정보는 MP 공식 웹사이트에서 확인할 수 있습니다. 계정에서 설정한 업계 정보는 인터페이스 호출을 통해 가져옵니다.

#🎜🎜 #인터페이스 호출 요청 지침

http请求方式：GET
https://api.weixin.qq.com/cgi-bin/template/get_industry?access_token=ACCESS_TOKEN

매개변수 설명

주요 산업	하위 산업	코드
IT 기술	인터넷/전자상거래	1
IT 기술	IT 소프트웨어 및 서비스	2
IT 기술	IT 하드웨어 및 장비	3
IT 기술	전자 기술	4
IT 기술	통신 및 운영자	5
IT 기술	온라인 게임	6
금융 산업	은행	7
금융 산업	펀드\|금융 관리\|신탁	8
금융 산업	보험	9
식사	식사	호텔여행
12		운송 및 창고업
운송 및 창고	창고	15

	17
학술 연구	18

정부 및 공공 시설	Museum	20
정부 및 공공 시설 ######공개 유틸리티 \| 비영리 기관#######21### ## #####제약 치료#🎜🎜 ## 🎜🎜# 의학 의료	22
간호 및 미용	23# 🎜🎜 ## ## ## #####의료 서비스#######건강 및 위생#######24### ###### 🎜🎜 # 차량	자동차 관련
	차량	오토바이 관련
	교통	기차 관련
교통	항공기 관련	28
부동산# 🎜🎜#
	# 🎜 🎜#30
소비재	소비재	31
비즈니스 서비스#🎜🎜 ## 🎜🎜#법	32
컨벤션 및 전시회		비즈니스 서비스
34	#🎜 🎜##🎜 🎜#비즈니스서비스	인증
	비즈니스서비스	36
体育娱乐	미디어	37# 🎜🎜# # 🎜 🎜#
体育	38

매개변수	가 필수인가요?	설명
access_token	은	인터페이스 호출 자격 증명

입니다.

반환 설명

올바른 호출 후 반환 예시:

{
"primary_industry":{"first_class":"运输与仓储","second_class":"快递"},
"secondary_industry":{"first_class":"IT科技","second_class":"互联网|电子商务"}
}

반환 매개변수 설명

# 🎜 🎜#Parameter필수인가요?Descriptionaccess_token# 🎜🎜 ## 🎜🎜##is#####인터페이스 호출 자격 증명#🎜🎜 ## 🎜🎜 ## ####primary_industry########### 🎜🎜#계정설정의 주요 산업secondary_industry은 의 2차 산업입니다. 🎜🎜## 🎜🎜#

템플릿 ID 얻기

업계 템플릿 라이브러리에서 계정 백엔드까지 템플릿을 선택합니다. 템플릿 ID를 얻는 과정은 MP에서 완료할 수 있습니다. 타사 개발자의 편의를 위해 다음과 같이 인터페이스 호출을 통해 템플릿 ID를 얻는 방법을 제공합니다.

인터페이스 호출 요청 설명

http请求方式: POST
https://api.weixin.qq.com/cgi-bin/template/api_add_template?access_token=ACCESS_TOKEN

POST 데이터 설명

POST 데이터 예는 다음과 같습니다.

      {
           "template_id_short":"TM00015"
       }

매개변수 설명

입니다.

매개변수	가 필수인가요?	설명
access_token	은	인터페이스 호출 자격 증명
template_id_short	은	템플릿 라이브러리에 "TM을 포함한 템플릿 번호 " 및 " OPENTMTM" 및 기타 형식

반환 코드 설명

템플릿 메시지 인터페이스를 호출한 후 JSON 데이터 패킷이 반환됩니다. 정상적인 조건에서 JSON 데이터 패킷을 반환하는 예:

    {
           "errcode":0,
           "errmsg":"ok",
           "template_id":"Doclyl5uP7Aciu-qZ7mJNPtWkbkYnWBWVja26EGbNyk"
       }

템플릿 목록 가져오기

계정에 추가된 모든 템플릿 목록 가져오기 템플릿 목록을 볼 수 있습니다. 편의를 위해 타사 개발자는 다음과 같이 인터페이스 호출을 통해 계정의 모든 템플릿 정보를 얻을 수 있는 방법을 제공합니다.

인터페이스 호출 요청 지침

http请求方式：GET
https://api.weixin.qq.com/cgi-bin/template/get_all_private_template?access_token=ACCESS_TOKEN

매개변수 지침

매개변수	가 필수인가요?	설명
access_token	은	인터페이스 호출 자격 증명

입니다.

반환 설명

올바른 호출 후 반환 예시:

{	
 "template_list": [{
      "template_id": "iPk5sOIt5X_flOVKn5GrTFpncEYTojx6ddbt8WYoV5s",
      "title": "领取奖金提醒",
      "primary_industry": "IT科技",
      "deputy_industry": "互联网|电子商务",
      "content": "{ {result.DATA} }\n\n领奖金额:{ {withdrawMoney.DATA} }\n领奖  时间:{ {withdrawTime.DATA} }\n银行信息:{ {cardInfo.DATA} }\n到账时间:  { {arrivedTime.DATA} }\n{ {remark.DATA} }",
      "example": "您已提交领奖申请\n\n领奖金额：xxxx元\n领奖时间：2013-10-10 12:22:22\n银行信息：xx银行(尾号xxxx)\n到账时间：预计xxxxxxx\n\n预计将于xxxx到达您的银行卡"
   }]
}

반환 매개변수 설명

# 🎜🎜#access_token은 인터페이스 호출 자격 증명입니다. template_ id# 🎜🎜#title은 #🎜이 적용되는 산업의 1차 산업입니다. 🎜# 템플릿 속함이 속한 산업의 2차 산업입니다. #🎜 🎜#contentis템플릿 콘텐츠example# 🎜🎜#템플릿 예

템플릿 삭제#🎜🎜 #

템플릿 삭제는 MP에서 수행할 수 있습니다. 타사 개발자를 용이하게 하기 위해 다음과 같이 인터페이스 호출을 통해 계정에서 템플릿을 삭제하는 방법을 제공합니다.

#🎜 🎜#인터페이스 호출 요청 설명

http请求方式：POST
https://api.weixin.qq.com/cgi-bin/template/del_private_template?access_token=ACCESS_TOKEN

POST 데이터 설명은 다음과 같습니다.

 {
     "template_id" : "Dyvp3-Ff0cnail_CDSzk1fIc6-9lOkxsQE7exTJbwUE"
 }

매개변수 설명

Parameter	필수인가요?	설명

is	템플릿 ID
is #🎜🎜 ##🎜 🎜#템플릿 제목		primary_industry
# 🎜🎜#	deputy_industry	은

	is#🎜 🎜#

# 🎜 🎜#access_tokenis인터페이스 호출 자격 증명template_id 이다 # 🎜🎜#

반환 지침

인터페이스 호출 후 JSON 데이터 패킷이 반환됩니다. 정상 시 반환된 JSON 데이터 패킷의 예:

{
   "errcode" : 0,
   "errmsg" : "ok"
}

템플릿 메시지 보내기

인터페이스 호출 요청 설명

http请求方式: POST
https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=ACCESS_TOKEN

POST 데이터 설명

POST 데이터 예시는 다음과 같습니다.

      {
           "touser":"OPENID",
           "template_id":"ngqIpbwh8bUfcSsECmogfXcV14J0tQlEpBO27izEYtY",
           "url":"http://weixin.qq.com/download",            
           "data":{
                   "first": {
                       "value":"恭喜你购买成功！",
                       "color":"#173177"
                   },
                   "keynote1":{
                       "value":"巧克力",
                       "color":"#173177"
                   },
                   "keynote2": {
                       "value":"39.8元",
                       "color":"#173177"
                   },
                   "keynote3": {
                       "value":"2014年9月22日",
                       "color":"#173177"
                   },
                   "remark":{
                       "value":"欢迎再次购买！",
                       "color":"#173177"
                   }
           }
       }

매개변수 설명

Parameter	필수인가요	설명

	공개 계정의 템플릿 메시지 ID

# 🎜🎜##touser######is#####수신자 OpenID##########template_id#🎜🎜 ## 🎜🎜#is#is# 🎜🎜#nodata은 템플릿 데이터입니다.

반환 코드 설명

템플릿 메시지 인터페이스를 호출한 후 JSON 데이터 패킷이 반환됩니다. 정상 시 반환된 JSON 데이터 패킷의 예:

    {
           "errcode":0,
           "errmsg":"ok",
           "msgid":200228332
       }

이벤트 푸시

템플릿 메시지 전송 작업이 완료된 후 WeChat 서버는 전송 성공 여부를 알리고 에 채워진 서버로 전송합니다. 개발자 센터 구성 주소입니다.

1 전송이 성공하면 푸시된 XML은 다음과 같습니다.

           <xml>
           <ToUserName><![CDATA[gh_7f083739789a]]></ToUserName>
           <FromUserName><![CDATA[oia2TjuEGTNoeX76QEjQNrcURxG8]]></FromUserName>
           <CreateTime>1395658920</CreateTime>
           <MsgType><![CDATA[event]]></MsgType>
           <Event><![CDATA[TEMPLATESENDJOBFINISH]]></Event>
           <MsgID>200163836</MsgID>
           <Status><![CDATA[success]]></Status>
           </xml>

매개변수 설명

Parameter	필수인가요	설명
템플릿 ID		url
템플릿 점프 링크#🎜 🎜#

#🎜 🎜 #官网微信FromUserName템플릿 메시지를 받는 사용자의 공개 ID # 🎜🎜#CreateTimeMsgType#🎜 🎜 #Event이벤트로 템플릿 메시지 발송이 종료됩니다 MsgID# 🎜🎜#메시지 ID보내기 상태가 성공적입니다#🎜🎜 #

2. 사용자 거부(사용자 설정이 공개 계정 메시지 수신을 거부)로 인해 전송에 실패한 경우 푸시된 XML은 다음과 같습니다.

           <xml>
           <ToUserName><![CDATA[gh_7f083739789a]]></ToUserName>
           <FromUserName><![CDATA[oia2TjuEGTNoeX76QEjQNrcURxG8]]></FromUserName>
           <CreateTime>1395658984</CreateTime>
           <MsgType><![CDATA[event]]></MsgType>
           <Event><![CDATA[TEMPLATESENDJOBFINISH]]></Event>
           <MsgID>200163840</MsgID>
           <Status><![CDATA[failed:user block]]></Status>
           </xml>

매개변수 설명

Parameter	Description
ToUserName

CreateTime
메시지 유형은 이벤트입니다

	Status

# 🎜🎜#ParameterDescriptionToUserName 공식 계정 WeChat ID FromUserName템플릿 메시지를 받은 사용자의 openid#🎜 🎜#CreateTime# 🎜🎜#생성 시간MsgType메시지 유형은 이벤트입니다이벤트로 템플릿 메시지 발송이 종료됩니다#🎜 🎜#메시지 IDStatus사용자가 수신을 거부하는 상태입니다#🎜🎜 #

#🎜🎜 #

이벤트

MsgID

3. 기타 이유로 배송이 실패한 경우 푸시된 XML은 다음과 같습니다.

           <xml>
           <ToUserName><![CDATA[gh_7f083739789a]]></ToUserName>
           <FromUserName><![CDATA[oia2TjuEGTNoeX76QEjQNrcURxG8]]></FromUserName>
           <CreateTime>1395658984</CreateTime>
           <MsgType><![CDATA[event]]></MsgType>
           <Event><![CDATA[TEMPLATESENDJOBFINISH]]></Event>
           <MsgID>200163840</MsgID>
           <Status><![CDATA[failed: system failed]]></Status>
           </xml>

Parameter Description

Parameter	Description
ToUserName	공식 계정 WeChat ID
FromUserName	템플릿 수신 메시지 사용자의 openid
CreateTime	Creation time
MsgType	메시지 유형은 event
Event	이벤트가 템플릿 메시지 전송의 끝입니다
MsgID	메시지 ID
Status	발송 상태가 전송 실패(비사용자 거부)

← 고급 그룹 전송 인터페이스

템플릿 메시지 작업 사양 →

제출하다

템플릿 메시지 인터페이스