Cet article explique comment créer des modèles via API et comment envoyer des demandes d'avis à vos clients.

Création d'un modèle de demande d'avis

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

Étape 1 – Création du modèle

Requête

POST /api/customer-engagement/review-template

Charge utile

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

Réponse

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

Étape 2 – Vérification de votre identité e-mail (si non vérifiée précédemment)

Requête

POST /api/customer-engagement/identities

Charge utile

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

Réponse

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

Remarques :

• Après une demande d'identité, vous recevrez un e-mail d'AWS pour vérifier la propriété de l'adresse e-mail demandée.

Envoi de demandes d'avis à vos clients

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

Étape 1 – Téléchargement d'une liste de clients à qui envoyer la demande

Requête

POST /api/customer-management/customers

Charge utile

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

Réponse

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

Étape 2 – Envoi d'une demande à vos clients

Requête

POST /api/review-template/job

Charge utile attendue

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

Réponse

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

Remarques :

• Toutes les requêtes nécessitent une authentification. Veuillez consulter votre clé API privée.
• Lors de l'envoi d'une demande d'avis, vous devez inclure à la fois le locationId associé à chaque client et le reviewTemplateId souhaité.