API Endpoint

POST Review Reply API

/api/v1/ai/review-reply

Generate a context-aware draft response to a customer review matching your tone and instructions.

Request Body Parameters

Field	Type	Required	Description
`review`	string	Required	The raw customer review text (Max: 20,000 characters).
`rating`	integer	Optional	Optional review rating (1 to 5) to align response empathy.
`business_name`	string	Optional	Optional business name to include in signature.
`customer_name`	string	Optional	Optional customer name for greeting.
`tone`	string	Optional	Desired response tone. Allowed: "professional", "friendly", "empathetic", "concise". Default is "professional".
`language`	string	Optional	Optional draft response language.
`instructions`	string	Optional	Optional custom instructions (e.g. "Ask them to contact support at help@company.com").
`model`	string	Optional	Optional AI model to use.

Example Request

This example demonstrates how to draft an empathetic reply for a negative review, providing custom directions.

JSON Request

{
  "review": "I bought this product yesterday and it broke within 2 hours. Extremely disappointed.",
  "rating": 1,
  "business_name": "TechGadgets Inc.",
  "customer_name": "Sarah Connor",
  "tone": "empathetic",
  "instructions": "Tell them support will reach out within 2 hours to ship a free replacement."
}

cURL

curl -X POST https://rsflowhub.com/api/v1/ai/review-reply \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "review": "I bought this product yesterday and it broke within 2 hours. Extremely disappointed.",
    "rating": 1,
    "business_name": "TechGadgets Inc.",
    "customer_name": "Sarah Connor",
    "tone": "empathetic",
    "instructions": "Tell them support will reach out within 2 hours to ship a free replacement."
  }'

Example Response

The response provides the drafted content, tone, and language.

JSON Response

{
  "success": true,
  "data": {
    "result": {
      "reply_text": "Hi Sarah, we are incredibly sorry to hear that your product broke so quickly. That is definitely not the standard we strive for at TechGadgets Inc. Our support team will reach out to you within the next 2 hours to coordinate shipping a free replacement. Thank you for your patience.",
      "language": "en",
      "tone": "empathetic"
    }
  },
  "meta": {
    "credits_used": 3,
    "credits_remaining": 984
  }
}

API Request Example

Use the cURL snippet below to test the endpoint.