WeChat ミニ プログラム API テンプレート メッセージ


WeChat の通知チャネルに基づいて、クローズドループ サービスを実現し、より良いエクスペリエンスを提供するために、ユーザーに効率的に連絡できるテンプレート メッセージング機能を開発者に提供します。

テンプレートのプッシュ場所: サービス通知

テンプレートの配信条件: ユーザーが WeChat システムでページを操作した後にトリガーされます。詳細については、配信条件の説明を参照してください。

テンプレートのジャンプ機能: クリックして詳細を表示します。テンプレートが送信されるアカウントの各ページに移動します

使用手順

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

https://mp.weixin.qq.comにログインしてテンプレートを取得します適切なテンプレートがない場合は、新しいテンプレートの追加を申請して、合格後に使用できます。詳細については、

201609261354219112.png

ページの
    を使用して送信します。テンプレートメッセージ。

  1. <form/>组件，属性report-submit为true时，可以声明为需发模板消息，此时点击按钮提交表单可以获取formId，用于发送模板消息。或者当用户完成支付行为，可以获取prepay_id

    インターフェイスを呼び出してテンプレート メッセージを配信します (詳細についてはインターフェイスの説明を参照してください)

  2. 1. access_token を取得します

    3. access_token は、それぞれを呼び出すときに、access_token を使用する必要があります。インターフェースを正しく保管してください。 access_token ストレージ用に少なくとも 512 文字のスペースを予約する必要があります。 access_token の有効期間は現在 2 時間であり、定期的に取得を繰り返すと最後の access_token が無効になります。

パブリックプラットフォームでのAPI呼び出しに必要なaccess_tokenの使用と生成に関する手順:

  1. appsecret の機密性を保つために、サードパーティは access_token を取得して更新するための中央制御サーバーを必要とします。他のビジネス ロジック サーバーで使用される access_token は中央制御サーバーから取得されるため、個別に更新しないでください。更新しないと、access_token が上書きされ、ビジネスに影響を及ぼします。現在の値は 7200 秒以内です。中央制御サーバーは、この有効時間に従って、新しい access_token を事前に更新する必要があります。更新プロセス中、中央制御サーバーは依然として古い access_token を出力します。このとき、パブリック プラットフォームのバックエンドは、更新の短時間内に古い access_token と新しい access_token の両方が利用可能になることを保証し、これによりサードパーティのスムーズな移行が保証されます。ビジネス;
  2. access_token は有効です 時刻は将来調整される可能性があるため、中央制御サーバーは定期的に内部でアクティブに更新する必要があるだけでなく、ビジネス サーバーがアクセス トークンを受動的に更新するためのインターフェイスも提供する必要があります。 API 呼び出しが access_token がタイムアウトしたことを認識したときに、access_token の更新プロセスをトリガーできます。
  3. 開発者は、AppID と AppSecret を使用してこのインターフェイスを呼び出し、access_token を取得できます。 AppIDとAppSecretは、WeChat公式サイト→設定→開発設定にログインすることで取得できます（開発者であることが条件であり、アカウントに異常がないことが必要です）。 AppSecret が生成され、パブリック プラットフォームで表示されるたびに、AppSecret はリセットされるため、生成後は自分で保存してください。すべての WeChat インターフェイスを呼び出すときは、https プロトコルを使用する必要があることに注意してください。サードパーティが中央制御サーバーを使用せず、各ビジネス ロジック ポイントを選択して access_token を個別に更新すると、競合が発生してサービスが不安定になる可能性があります。

インターフェースアドレス:

https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET

HTTPリクエストメソッド:

GET

パラメータの説明:

QQ截图20170208152001.png

通常、WeChatは次の JSON データ パッケージを返します開発者: 

{"access_token":"ACCESS_TOKEN","expires_in":7200}

エラーが発生すると、WeChat はエラー コードとその他の情報を返します。JSON データ パッケージの例は次のとおりです (この例は AppID が無効なエラーです): 

{"errcode":40013,"errmsg":"invalid appid"}

2. テンプレート メッセージを送信します。 QQ截图20170208152013.pngインターフェースアドレス: ( ACCESS_TOKEN は上記で取得した access_token に置き換える必要があります)

https://api.weixin.qq.com/cgi-bin/message/wxopen/template/send?access_token=ACCESS_TOKEN

HTTP リクエストメソッド: 

POST
POST パラメーターの説明:

例:

りーQQ截图20170208152030.png 戻りコードの説明:

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

正常時に返されるJSONデータパケットの例: 

{
  "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" 
}
エラー発生時にエラーコード情報が返されます。説明は次のとおりです:
リターンコード説明
40037template_idが間違っています
41028form_idが間違っているか期限切れです
41029form_id が使用されました
41030 ページが間違っています

使用効果:

201609261355055576.png

注: 内部テスト段階では、テンプレート メッセージが発行された後、「公式アカウント セキュリティ アシスタント」によって発行された単純な通知のみがクライアントで表示されます。このプロンプトが表示された場合は、テンプレート メッセージ関数が正常にデバッグされたことを意味します。この機能が正式にリリースされると、上の図のように表示されます。

発行条件の説明

  1. 支払い

    ユーザーがミニプログラムで支払い動作を完了すると、開発者は7日以内に限られた数のテンプレートメッセージをユーザーにプッシュすることができます（1回の支払いにつき1回の支払いを発行できます）時間、複数の支払いにおけるトランザクションの数は独立しており、相互に影響しません)

  2. フォームを送信

    ユーザーがミニ プログラム内でフォームを送信し、そのフォームがテンプレート メッセージを送信するように宣言されている場合、開発者は次のことを行う必要があります。提供する際、開発者は 7 日以内に限られた数のテンプレート メッセージをユーザーにプッシュすることができます (フォームが送信されると 1 つのメッセージを送信できますが、複数の送信後に送信されるメッセージの数は独立しており、相互に影響します)

監査手順

1. タイトル

1.1 タイトルは同じであってはなりません

1.2 タイトルの意味が過度に類似していてはなりません

1.3 タイトルは「リマインダー」または「」で終わる必要があります通知」

1.4 タイトルには、特殊な記号、個人化された単語などを含めることはできません。 なし 業界一般的なコンテンツ

1.5 タイトルは、特定のサービス シナリオを反映する必要があります

1.6 タイトルには、以下を含むがこれに限定されない、マーケティング関連のコンテンツを含めることはできません:

消費者割引、ショッピングリベート、製品アップデート、クーポン、バウチャー、赤い封筒、会員カード、ポイント、アクティビティ、その他のマーケティングトレンド通知

2. キーワード

2.1 同じタイトルの下で、キーワードを同じにすることはできません。

2.2 同じタイトルで、キーワードが過度に類似していることはできません

2.3 キーワードには、特殊な記号、個人化された単語、および業界全体ではないその他のコンテンツを含めることはできません

2.4 キーワードの内容の例はキーワードと一致する必要があります

2.5 キーワードは使用できません。広すぎるため、次のように制限する必要があります。「 「コンテンツ」は広すぎるため承認できません

違反の説明

動作仕様に違反しないことに加えて、以下のルールに違反することはできません。

  1. 許容可能な結果を​​達成するためにユーザーにトリガー操作を実行させることは許可されません
  2. ユーザーに嫌がらせを引き起こすテンプレートは許可されません。テンプレートはマーケティング目的で発行されません
  3. ミニ プログラムでトリガーされたサービス関連コンテンツをユーザーに通知するために、サービス アカウントを通じてテンプレートを発行することは許可されていません

    4. ペナルティの説明

違反に従って、対応する勾配ペナルティが適用されます。一般的なペナルティ ルールは次のとおりです:


最初の違反の場合、違反テンプレートは警告として削除されます。

2 回目の違反の場合、インターフェースに対して 7 日間の禁止が課されます

。 3 回目の違反は 30 日間のインターフェース禁止となります

4 回目の違反は永久的なインターフェース禁止となります

ペナルティの結果と理由はサイト内メッセージの形で通知されます