テンプレートメッセージインターフェース



1474854871571022.jpg


テンプレートメッセージインターフェース

テンプレート メッセージは、重要なサービス通知をユーザーに送信するために公式アカウントによってのみ使用され、クレジット カードのスワイプ通知、製品購入の成功通知など、要件を満たすサービス シナリオでのみ使用できます。 。広告などのマーケティング メッセージや、ユーザーに嫌がらせを引き起こす可能性のあるその他のメッセージはサポートされていません。

使用規則についてはご注意ください: 

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

インターフェースドキュメントについてはご注意ください:


業界を設定します

設定産業はMPで完了できます、業界は月に 1 回変更でき、アカウントはそのアカウントが属する業界に関連するテンプレートのみを使用できます。サードパーティ開発者を容易にするために、アカウントが属する業界を変更する方法がインターフェイス呼び出しを通じて提供されます。次のように:

インターフェース呼び出しリクエストの説明

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

POSTデータの説明

POSTデータの例は次のとおりです: 

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

パラメータの説明

業界コードのクエリ

パラメータは必須ですか?説明
アクセストークン はインターフェース呼び出し資格情報

industry_id1

です		は、公式アカウントテンプレートメッセージが属する業界番号です
industry_id2は、公式アカウントテンプレートメッセージが属する業界番号です
ITテクノロジーITソフトウェアとサービス2 ITテクノロジーITハードウェアおよび機器3ITテクノロジー電子テクノロジー4ITテクノロジー通信およびオペレーター5ITテクノロジーオンラインゲーム6 金融業界銀行7
主要産業サブ産業コード
ITテクノロジーインターネット/電子商取引1
金融業界ファンド|財務管理|信託8
金融業界保険9
ケータリングケータリング10
ホテル旅行ホテル11
ホテル旅行旅行12
輸送と倉庫エクスプレス13
輸送と倉庫物流 14
輸送と倉庫倉庫 15
教育トレーニング16
教育学校17
政府と公共事業学術研究 18
政府および公共事業交通警察 19
政府と公共事業博物館20
政府と公共事業公共事業|非営利機関21
医薬品と看護医薬品とヘルスケア22
医療ケアと美容23
医療健康と衛生24
交通自動車関連25
交通 バイク関連26
交通鉄道関連27
交通航空機関連28
不動産建設29
不動産不動産30
消費財消費財31
ビジネスサービス法務32
ビジネスサービス展示会33
ビジネスサービス仲介サービス34
ビジネスサービス認証35
ビジネスサービス監査36
スポーツとエンターテイメントメディア37
スポーツとエンターテイメント スポーツ38
スポーツとエンターテイメントエンターテイメントとレジャー39
印刷印刷40
その他その他41

アカウントで設定した業界情報を取得します

アカウントで設定した業界情報を取得します。業界情報は MP 公式 Web サイトで参照できます。サードパーティ開発者の便宜を図るため、アカウントによって設定された業界情報は次のとおりです:

インターフェース呼び出しリクエストの手順

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

。 パラメータの説明

パラメータは必須ですか? 説明
access_tokenは、インターフェース呼び出し資格情報です

戻り値の説明

正しい呼び出し後の戻り値の例: 

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

戻りパラメータの説明

パラメータは必須ですか?説明
access_tokenはい インターフェイス呼び出し認証情報
primary_industryは、アカウントによって設定された主な産業です
Secondary_industryは、アカウントによって設定された第二次産業です

テンプレート ID を取得します

業界テンプレート ライブラリからアカウント バックエンドへのテンプレートを選択します。テンプレート ID を取得するプロセスは MP で完了できます。サードパーティ開発者の便宜を図るため、インターフェイス呼び出しを通じてテンプレート ID を取得するメソッドが次のように提供されています:

インターフェイス呼び出しリクエストの説明

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

POST データの説明

POST データの例は次のとおりです。 

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

パラメータの説明

パラメータは必須ですか? 説明
access_tokenはインターフェース呼び出し資格情報です
template_id_short はテンプレートライブラリ内の「TM」を含むテンプレートの番号**」と「OPENTMTM**」およびその他の形式

リターンコードの説明

テンプレートメッセージインターフェースを呼び出した後、JSONデータパケットが返されます。通常の条件で JSON データ パケットを返す例: 

      {
           "template_id_short":"TM00015"
       }

テンプレート リストを取得する

アカウントに追加されているすべてのテンプレートのリストを取得する テンプレート リストを表示できます。サードパーティの開発者は、便宜上、インターフェイス呼び出しを通じてアカウントのすべてのテンプレート情報を取得する方法を提供しています。

パラメータは必須ですか? 説明
access_tokenは、インターフェース呼び出し資格情報です

戻り値の説明

正しい呼び出し後の戻り値の例: 

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

戻り値パラメータの説明

ですコンテンツexample

テンプレートの削除

サードパーティ開発者を容易にするために、インターフェイス呼び出しを通じてテンプレートを削除する方法を提供しています。詳細は次のとおりです。 :

インターフェース呼び出しリクエストの説明

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

POSTデータの説明は次のとおりです: 

{	
 "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は テンプレートID
タイトルは テンプレートのタイトル
primary_industry は、 テンプレートが属する業界の第一次産業です
副産業 は、テンプレートが属する業界の第二次産業
はテンプレートコンテンツ
はテンプレートサンプル
パラメータは必須ですか? 説明
access_tokenはインターフェース呼び出し資格情報です
template_idは 公開アカウントのテンプレートメッセージID

返信手順

インターフェイスを呼び出した後、JSON データ パケットが返されます。正常な場合に返される JSON データ パケットの例: 

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

テンプレート メッセージの送信

インターフェース呼び出しリクエストの説明

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

POST データの説明

P OSTデータの例は以下のとおりです: 

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

パラメータの説明

パラメータは必須ですか? IDテンプレートジャンプリダイレクトリンクテンプレートデータ
urlno
データは
です


リターンコードの説明

テンプレートメッセージインターフェースを呼び出した後、JSONデータパケットが返されます。通常の戻り JSON データ パケットの例: 

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

イベントプッシュ

テンプレートメッセージ送信タスクが完了すると、WeChat サーバーは配信が成功したかどうかを通知し、送信します。開発者 サーバー構成のアドレスを中央に記入します。

1. 配信が成功すると、プッシュされた XML は次のようになります: 

      {
           "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"
                   }
           }
       }

パラメータの説明

パラメータ説明
ToUserName公式アカウントWeChat ID
FromUserNameテンプレートメッセージを受信するユーザーのopenid
CreateTime 作成時間
MsgType メッセージ タイプはイベント
イベントイベントはテンプレートメッセージ送信終了
MsgIDメッセージID
ステータス送信ステータスは成功です

2. ユーザーの拒否（ユーザー設定が公式アカウントのメッセージの受信を拒否している）により配信が失敗した場合、プッシュされる XML は次のとおりです: 

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

パラメータの説明

ToUserNamePublicアカウントWechat ID
FromUserNameテンプレートメッセージを受信するユーザーのopenid
CreateTime作成時間
MsgTypeメッセージタイプはイベント
イベントイベントテンプレートメッセージの送信は終了です
MsgIDメッセージID
ステータス 送信ステータスはユーザーが受信を拒否しました

3. 他の理由で配信が失敗した場合、プッシュされる 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>

パラメータの説明

パラメータの説明
ToUserName公式アカウントWeChat ID
FromUser名前 テンプレートの受信 メッセージのユーザーのopenid
CreateTime作成時刻
MsgTypeメッセージタイプはevent
Eventイベントはテンプレートメッセージ送信の終了です
MsgID メッセージID
ステータス送信ステータスは送信失敗(非ユーザー拒否)


←
→

PHP中国語ウェブサイト

ホームページホームページコースコース記事記事に質問に質問辞書辞書マニュアルマニュアルダウンロードダウンロード検索検索APPダウンロード APPダウンロード