メインコンテンツまでスキップ

7.リマインド通知＜契約・申請期限のリマインド＞通知

指定したユーザーに「7.リマインド通知＜契約・申請期限のリマインド＞通知」の送信を行います。

POST /v2/notifications/templates/:template_identifier/contract_deadline_reminders

メッセージ送信は非同期で行われるため、この API ではメッセージ送信リクエストが正常に受け付けられたかどうかを返します。正常に受け付けた場合はメッセージ毎に一意のメッセージ ID を採番して返します。

メッセージ送信が完了しているかどうかは、そのメッセージ ID を用いて 通知メッセージ送信結果の取得 API で確認する必要があります。そのための URL をレスポンスに含めて返します。

認証 Provider / 通知メッセージ利用申請

通知メッセージを利用するためには、認証 Provider になったうえで LINE 社への申請が必要となります。

リクエストパラメータ​

Path Parameters​

パラメータ名型必須説明
template_identifierstring○通知メッセージのテンプレートを一意に表す識別子

Body Parameters​

パラメータ名型必須説明
providerstring○プロバイダ名。現在は line のみ対応
recipientobject○Recipient オブジェクトを指定
contentsobject○Contents オブジェクトを指定

Recipient オブジェクト​

パラメータ名型必須説明
typestring○value のタイプを指定する。phone_number 固定
valuestring○E.164 形式に則ったハイフン無しの電話番号（e.g. +819012345678）

Contents オブジェクト​

パラメータ名型必須説明
company_namestring企業名／サービス名
contract_detailsstring○契約内容（契約名／商品名／プラン名）
contract_expiration_datestring○契約期限／満期⽇／有効期限／申請期限 (e.g. 2020-01-01)
update_button_urlstring「更新⽅法を確認する」ボタンの URL
detail_button_urlstring「詳細を確認する」ボタンの URL

エラーコード​

エラー定義 参照。

レスポンス​

成功時はステータスコード 202 Accepted とともに、作成した Notification リソースの JSON を返します。

パラメータ名型Nullable説明
identifierstring通知メッセージを一意に表す識別子
status_urlstring通知メッセージの配信状況を確認する URL
レスポンス例
{
  "identifier": "6fb75cc14b7ba0e58b9ee97926433ed7b90d1f2b",
  "status_url": "https://msgapi.socialplus.jp/v2/notifications/6fb75cc14b7ba0e58b9ee97926433ed7b90d1f2b"
}

実行サンプル​

curl -L -X POST 'https://msgapi.socialplus.jp/v2/notifications/templates/{Template identifier}/contract_deadline_reminders' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'X-API-Key: {API Key}' \
  --data-raw '{
    "provider": "line",
    "recipient": {
      "type": "phone_number",
      "value": "{E.164 Phone Number}"
    },
    "contents": {
      "company_name": "株式会社ソーシャルPLUS",
      "contract_details": "スタンダードプラン",
      "contract_expiration_date": "2020-01-01",
      "update_button_url": "https://example.com",
      "detail_button_url": "https://example.com"
    }
  }'
タグ:
に最終更新