How to Build Automated Review-Response Workflows

curl -X POST https://ai.synup.com/api/v1/reviews/reply \
  -H "Authorization: Bearer $SYNUP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "reviewId": "REVIEW_ID", "text": "Thanks so much for the kind words. We will pass this on to the team." }'

const API = "https://ai.synup.com/api/v1";
const headers = {
  Authorization: `Bearer ${process.env.SYNUP_API_KEY}`,
  "Content-Type": "application/json",
};

const templates = {
  five: ["Thank you for the kind words.", "We really appreciate you taking the time."],
};

function route(review) {
  if (!review.respondable) return { action: "skip" };
  if (review.rating >= 5 && review.sentiment === "positive") return { action: "auto" };
  if (review.rating <= 2 || review.sentiment === "negative") return { action: "approve" };
  return { action: "draft" };
}

async function handle(review) {
  const decision = route(review);
  if (decision.action === "auto") {
    const text = templates.five[Math.floor(Math.random() * templates.five.length)];
    return reply(review.id, text);
  }
  // draft or approve: park it for a person instead of sending
  return addNote(review.id, `Routed to ${decision.action}: ${review.rating} star, ${review.sentiment}`);
}

async function reply(reviewId, text) {
  const res = await fetch(`${API}/reviews/reply`, { method: "POST", headers, body: JSON.stringify({ reviewId, text }) });
  if (res.status === 422) return { status: "not_respondable" };
  if (!res.ok) throw new Error(`${res.status}: ${(await res.json()).error}`);
  return (await res.json()).data;
}

async function addNote(reviewId, body) {
  const res = await fetch(`${API}/reviews/notes`, { method: "POST", headers, body: JSON.stringify({ reviewId, body }) });
  if (!res.ok) throw new Error(`${res.status}: ${(await res.json()).error}`);
  return (await res.json()).data;
}

import os, random, requests

API = "https://ai.synup.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['SYNUP_API_KEY']}", "Content-Type": "application/json"}
TEMPLATES = {"five": ["Thank you for the kind words.", "We really appreciate you taking the time."]}

def route(review):
    if not review.get("respondable"):
        return "skip"
    if review["rating"] >= 5 and review["sentiment"] == "positive":
        return "auto"
    if review["rating"] <= 2 or review["sentiment"] == "negative":
        return "approve"
    return "draft"

def handle(review):
    action = route(review)
    if action == "auto":
        return reply(review["id"], random.choice(TEMPLATES["five"]))
    return add_note(review["id"], f"Routed to {action}: {review['rating']} star, {review['sentiment']}")

def reply(review_id, text):
    r = requests.post(f"{API}/reviews/reply", headers=HEADERS, timeout=30,
                      json={"reviewId": review_id, "text": text})
    if r.status_code == 422:
        return {"status": "not_respondable"}
    r.raise_for_status()
    return r.json()["data"]

def add_note(review_id, body):
    r = requests.post(f"{API}/reviews/notes", headers=HEADERS, timeout=30,
                      json={"reviewId": review_id, "body": body})
    r.raise_for_status()
    return r.json()["data"]