この記事では、API 経由でテンプレートを作成する方法と、顧客にレビュー リクエストを送信する方法の両方について説明します。

レビューリクエストテンプレートの作成

https://uberall.com/api/customer-engagement/swagger/review-generation-service-1.1.yml

ステップ1 - テンプレートの作成

リクエスト

POST /api/customer-engagement/review-template

ペイロード

{
  "name": "string",
  "locationIds": [
    0
  ],
  "bodyText": "string",
  "senderName": "string",
  "email": {
    "senderEmailId": "user@example.com",
    "footerText": "string",
    "subject": "string",
    "actionButtonColor": "#A7a",
    "privacyLink": "https://?:~Ei;cIlzZKbqn||hjX@EM",
    "mediaIds": [
      0
    ]
  },
  "reviewLinks": [
    {
      "url": "http://wG:UNbW=tSZqof.wFRxZoi;P/%VmBnhlMu:_88Z0NvyCK410Q7vm9cjOKqSPzzsibs!#L+",
      "label": "string"
    }
  ]
}

応答

{
  "id": 0,
  "type": "string",
  "name": "string",
  "locationIds": [
    0
  ],
  "bodyText": "string",
  "senderName": "string",
  "email": {
    "senderEmailId": "string",
    "footerText": "string",
    "subject": "string",
    "actionButtonColor": "string",
    "privacyLink": "string",
    "media": [
      {
        "mediaId": 0,
        "message": "string",
        "uploadUrl": "string"
      }
    ]
  },
  "reviewLinks": [
    {
      "url": "string",
      "label": "string"
    }
  ],
  "createdAt": "string",
  "updatedAt": "string",
  "errors": [
    "string"
  ],
  "message": "string"
}

ステップ2 - メールIDの確認（以前に確認していない場合）

リクエスト

POST /api/customer-engagement/identities

ペイロード

{
  "emailAddress": "user@example.com"
}

応答

{
  "emailAddress": "string",
  "identityType": "string",
  "verificationStatus": "string",
  "message": "string"
}

注記:

• ID をリクエストすると、リクエストしたメール ID の所有権を確認するためのメールが AWS から届きます。

顧客へのレビューリクエストの送信

https://uberall.com/api/customer-management/swagger/review-generation-customer-service-1.0.yml

ステップ1 - リクエストを受け取りたい顧客のリストをアップロードする

リクエスト

POST /api/customer-management/customers

ペイロード

{
  "customerRequests": [
    {
      "businessId": 0,
      "email": "string",
      "locationId": 0,
      "name": "string",
      "phone": "string"
    }
  ]
}

応答

{
  "customerLocationIds": [
    0
  ],
  "message": "string"
}

ステップ2 - 顧客にリクエストを送信する

リクエスト

POST /api/review-template/job

予想されるペイロード

{
  "customerLocationIds": [
    0
  ],
  "reviewTemplateId": 0,
  "scheduledDateTimeUtc": "string"
}

応答

{
  "jobs": [
    {
      "batchId": 0,
      "reviewTemplate": {
        "name": "string",
        "bodyText": "string",
        "senderEmailId": "user@example.com",
        "senderName": "string",
        "type": "SMS",
        "createdAt": "2023-03-29T12:35:06.721Z",
        "updatedAt": "2023-03-29T12:35:06.721Z",
        "id": 0,
        "version": 0
      },
      "customerLocationId": 0,
      "status": "IN_PROGRESS",
      "createdAt": "2023-03-29T12:35:06.721Z",
      "scheduledDateTimeUtc": "2023-03-29T12:35:06.721Z",
      "id": 0,
      "version": 0
    }
  ],
  "message": "string"
}

注記:

• すべてのリクエストには認証が必要です。プライベートAPIキーをご参照ください。
• レビューのリクエストを送信する際は、各顧客に関連するlocationIdと希望するreviewTemplateIdの両方を含める必要があります。