WeChat Mini 프로그램 API 템플릿 메시지
WeChat의 알림 채널을 기반으로 개발자에게 사용자에게 효율적으로 다가갈 수 있는 템플릿 메시징 기능을 제공하여 폐쇄 루프 서비스를 달성하고 더 나은 경험을 제공합니다.
템플릿 푸시 위치: 서비스 알림
템플릿 전달 조건: 사용자가 WeChat 시스템의 페이지와 상호작용한 후 트리거됩니다. 자세한 내용은 전달 조건 설명을 참조하세요#🎜🎜 #
템플릿 점프 기능: 세부정보를 보려면 클릭하여 템플릿이 발급된 계정의 각 페이지로 이동하세요. 🎜#Gettemplateidhttps://에 로그인하세요. mp.weixin.qq.com 에서 템플릿을 받으세요. 적합한 템플릿이 없을 경우, 새로운 템플릿을 추가하여 신청하실 수 있습니다. 자세한 사항은 템플릿 검토 안내 #🎜🎜를 참고해주세요. 페이지의 #
은 템플릿 메시지를 보내는 데 사용됩니다.
<form/>组件，属性report-submit为true时，可以声明为需发模板消息，此时点击按钮提交表单可以获取formId，用于发送模板消息。或者当用户完成支付行为，可以获取prepay_id인터페이스 설명#🎜 🎜# 1. access_tokenaccess_token은 자격 증명을 호출하는 전역적으로 고유한 인터페이스입니다. 개발자는 각 인터페이스를 호출할 때 access_token을 사용해야 합니다. access_token 저장을 위해 최소 512자 이상의 공간을 확보해야 합니다. access_token의 유효 기간은 현재 2시간이며 정기적으로 새로 고쳐야 합니다. 반복적으로 획득하면 마지막 access_token이 무효화됩니다.
공개 플랫폼에서 API 호출에 필요한 access_token 사용 및 생성에 대한 지침:
- appsecret을 비밀로 유지하려면 제3자가 access_token 획득 및 새로 고침을 위한 중앙 제어 서버가 필요합니다. 다른 비즈니스 로직 서버에서 사용하는 access_token은 중앙 제어 서버에서 가져오며 개별적으로 새로 고쳐서는 안 됩니다. 그렇지 않으면 access_token이 덮어쓰기되어 비즈니스에 영향을 미칩니다.
- access_token의 현재 유효 기간은 다음을 통해 전달됩니다. 반환된 만료_in , 현재 값은 7200초 이내입니다. 중앙관제서버는 이 유효한 시간에 맞춰 미리 새로운 access_token을 갱신해야 합니다. 새로 고침 프로세스 중에 중앙 제어 서버는 여전히 이전 access_token을 출력합니다. 이때 공용 플랫폼 백엔드는 이전 및 새 access_token을 짧은 새로 고침 시간 내에 사용할 수 있도록 보장하여 제3자의 원활한 전환을 보장합니다. business; # 🎜🎜#access_token의 유효 기간은 향후 조정될 수 있으므로 중앙 관제 서버는 정기적으로 내부적으로 적극적으로 새로 고침해야 할 뿐만 아니라, access_token을 수동적으로 새로 고치기 위한 인터페이스도 제공해야 합니다. 비즈니스 서버가 API 호출을 통해 access_token이 시간 초과되었음을 알게 되면 access_token의 새로 고침 프로세스를 트리거할 수 있습니다.
인터페이스 주소:
https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET
HTTP 요청 방법:
GET# 🎜🎜#매개변수 설명:
일반적인 상황에서 WeChat은 개발자에게 다음 JSON 데이터 패킷을 반환합니다.
{"access_token":"ACCESS_TOKEN","expires_in":7200}
WeChat은 개발자에게 반환합니다. 오류 코드 및 기타 정보입니다. JSON 데이터 패킷 예는 다음과 같습니다(이 예는 잘못된 AppID 오류입니다).
{"errcode":40013,"errmsg":"invalid appid"}2 템플릿 메시지 보내기
# 🎜🎜#인터페이스 주소: (ACCESS_TOKEN 위에서 얻은 access_token으로 대체해야 함)
https://api.weixin.qq.com/cgi-bin/message/wxopen/template/send?access_token=ACCESS_TOKENHTTP 요청 방법:
POST#🎜 🎜#POST 매개변수 설명:
예: #🎜 🎜#
{
"touser": "OPENID",
"template_id": "TEMPLATE_ID",
"page": "index",
"form_id": "FORMID",
"data": {
"keyword1": {
"value": "339208499",
"color": "#173177"
},
"keyword2": {
"value": "2015年01月05日 12:30",
"color": "#173177"
},
"keyword3": {
"value": "粤海喜来登酒店",
"color": "#173177"
} ,
"keyword4": {
"value": "广州市天河区天河路208号",
"color": "#173177"
}
},
"emphasis_keyword": "keyword1.DATA"
}# 🎜🎜#반환 코드 설명: 템플릿 메시지 인터페이스를 호출한 후 JSON 데이터 패킷이 반환됩니다.
정상시 반환되는 JSON 데이터 패킷의 예: { "errcode":0, "errmsg":"ok",
}에러가 발생한 경우 오류 코드 정보를 반환하며 설명은 다음과 같습니다.
| 반환 코드 | Explanation |
|---|---|
| 40037 | template_id가 올바르지 않습니다. |
| 41028 | form_id가 올바르지 않거나 만료되었습니다. |
| 41029 | form_id가 사용되었습니다 |
| 41030 | 페이지가 잘못되었습니다 |
사용 효과:
참고: 내부 테스트 단계에서 템플릿 이후 메시지가 공개되면 "공식 계정 보안 도우미"가 발행한 간단한 알림만 클라이언트에서 볼 수 있습니다. 이 메시지가 나타나면 템플릿 메시지 기능이 성공적으로 디버깅되었음을 의미합니다. 이 기능이 공식적으로 출시되면 위 그림과 같이 표시됩니다.
문제상태 설명
결제
미니 프로그램 내에서 사용자가 결제를 완료한 경우 개발자가 7일 이내에 제한된 수의 템플릿 메시지를 사용자에게 푸시할 수 있도록 하는 동작(1회 결제에 대해 하나의 메시지가 발행될 수 있으며, 여러 결제에 대해 발행되는 메시지 수는 독립적이며 서로 영향을 미치지 않습니다)
# 🎜🎜## 🎜🎜# Submit form미니 프로그램 내에서 사용자가 양식을 제출하고 해당 양식이 템플릿 메시지를 전송하도록 선언되어 있으며, 개발자가 해당 양식에 서비스를 제공해야 하는 경우 사용자, 이는 허용될 수 있습니다. 개발자는 7일 이내에 제한된 수의 템플릿 메시지를 사용자에게 푸시합니다(양식이 제출되면 하나의 메시지가 전송될 수 있으며 메시지 수는 여러 제출에 대해 독립적이며 서로 영향을 미치지 않습니다) #🎜 🎜#
검토 지침
1. 제목
1.1 제목은 동일할 수 없습니다
# 🎜🎜#1.2 제목 의미가 지나치게 유사할 수 없음# 🎜🎜#
1.3 제목은 "알림" 또는 "알림"으로 끝나야 합니다.1.4 제목에는 특수 기호, 맞춤 단어 및 업계 전반에 적용되지 않는 기타 콘텐츠# 🎜🎜#1.5 제목은 특정 서비스 시나리오를 반영해야 합니다
1.6 제목에는 다음을 포함하되 이에 국한되지 않는 마케팅 관련 콘텐츠가 포함될 수 없습니다. # 🎜🎜#
소비자 할인, 쇼핑 리베이트, 제품 업데이트, 쿠폰, 상품권, 빨간 봉투, 멤버십 카드, 포인트, 활동 및 기타 마케팅 동향 알림 2. 키워드# 🎜🎜#2.1 동일한 제목에 키워드가 동일할 수 없음
2.2 동일한 제목에 키워드가 지나치게 유사할 수 없음
2.3 키워드에 특수 기호, 맞춤 단어를 포함할 수 없음 등 업계 전반에 적용되지 않는 콘텐츠
2.4 키워드 콘텐츠 예는 키워드
2.5와 일치해야 합니다. 키워드는 너무 광범위할 수 없으며 제한적이어야 합니다. 예: "콘텐츠"가 너무 광범위하여 승인할 수 없습니다
위반 설명
운영 사양을 위반하지 않는 것 외에도 다음 규칙을 위반할 수 없습니다.#🎜 🎜#
사용자에게 템플릿을 발급하는 목적을 달성하기 위해 사용자가 트리거 작업을 수행하도록 악의적으로 유도하는 것은 허용되지 않습니다다음에 국한되지 않습니다. 악의적으로 괴롭히고 사용자를 괴롭히는 템플릿을 발급하는 것은 허용# 🎜🎜#악의적인 마케팅은 허용되지 않으며, 마케팅 목적의 템플릿은 발급이 불가능합니다
서비스 계정을 통한 템플릿 발급은 허용되지 않습니다 미니 프로그램에서 발생하는 서비스 관련 콘텐츠를 사용자에게 알리기 위해# 🎜🎜#페널티 설명
- 해당 페널티 등급은 해당 등급에 따라 부여됩니다. 위반 시 일반적인 처벌 규칙은 다음과 같습니다.
- 첫 번째 위반 시 경고 템플릿이 삭제됩니다.
두 번째 위반 시 발생합니다. 7일 인터페이스 금지
처벌 결과 및 사유는 현장 메시지로 안내해 드립니다
