Fetch AI reply suggestion for reviews

curl --request GET \
  --url https://api.partoo.co/v2/reviews/fetch-suggestion/{review_id}/{index} \
  --header 'x-APIKey: <api-key>'

{
  "id": 820459,
  "index": 1,
  "review_id": 34,
  "content": "Dear Client, thanks for your kind feedback.",
  "report": {
    "id": 3587,
    "user_id": "52e10f004ee65a020",
    "created_at": "2025-05-12T12:57:21.895170Z"
  }
}

Reviews

Fetch AI reply suggestion for reviews

The AI reply suggestion is a service that generates a response to a review based on the review content.

⚠️ This feature provides reply SUGGESTIONS, NOT AUTOMATIC REPLIES. It is NOT designed for fully automating conversations. Similar to the app, a human reviewer is expected to validate the suggestion before selecting it in order to use reply to a review endpoint ⚠️

How does the AI reply suggestion work?

First, call the Fetch AI reply suggestion service.
Then retrieve the values and store them on the caller’s side. It is possible to request up to 3 suggestions per reply, and after that, it’s no longer possible; the suggestions are retained once they’re made, and that they can be found at the index (0, 1, or 2) of the parameters
Finally, use the suggestion ID and pass it to reply_suggestion request body when calling the reply to a review service to link the response to the suggestion.

GET

reviews

fetch-suggestion

{review_id}

{index}

Fetch AI reply suggestion for reviews

curl --request GET \
  --url https://api.partoo.co/v2/reviews/fetch-suggestion/{review_id}/{index} \
  --header 'x-APIKey: <api-key>'

{
  "id": 820459,
  "index": 1,
  "review_id": 34,
  "content": "Dear Client, thanks for your kind feedback.",
  "report": {
    "id": 3587,
    "user_id": "52e10f004ee65a020",
    "created_at": "2025-05-12T12:57:21.895170Z"
  }
}

Authorizations

x-APIKey

string

header

required

The authentication system on Partoo API is using API Key that should be put in the header of the request (the name of the header is x-APIKey). An api_key is linked to a user. This user's role will give you different access level to the API features.

Path Parameters

review_id

integer

required

ID of the review for which we want an AI suggestion

Example:

34

index

integer

required

Index of the reply suggestion (0, 1, or 2)

Required range: 0 <= x <= 2

Response

Review's reply suggestion

integer

Reply suggestion id

Example:

820459

index

integer

Index of the reply suggestion

Example:

1

review_id

integer

Review id

Example:

34

content

string

The content of the reply suggestion

Example:

"Dear Client, thanks for your kind feedback."

report

object

Report details if the suggestion was reported (can be null)

Show child attributes

Delete a review reply template Profile metrics for your business

⌘I

Documentation Index

Authorizations

Path Parameters

Response