Playbook: E-commerce Support

curl --silent --show-error \
  --request POST \
  --url "$UPPZY_BASE_URL/m2m/sites/$UPPZY_SITE_ID/documents/qa" \
  --header "X-API-Key: $UPPZY_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "title": "Return Window FAQ",
    "question": "How long do customers have to return an item?",
    "answer": "Customers can start a return within the return window published in the store policy.",
    "category": "returns"
  }'

import { uppzy } from "./uppzy-client.js";

const SITE_ID = process.env.UPPZY_SITE_ID;

export async function answerCommerceQuestion(req, res) {
  const { shopperId, message, locale } = req.body;

  if (!shopperId || !message) {
    return res.status(400).json({ error: "shopperId and message are required" });
  }

  const sessionId = `shopper_${shopperId}`;

  const answer = await uppzy(`/m2m/sites/${SITE_ID}/chat`, {
    method: "POST",
    body: {
      session_id: sessionId,
      message,
      ui_locale: locale || "en",
      response_language: locale || "en",
    },
  });

  return res.json({
    session_id: answer.session_id,
    request_id: answer.request_id,
    answer: answer.answer,
    confidence_level: answer.confidence_level,
  });
}

import { uppzy } from "./uppzy-client.js";

const SITE_ID = process.env.UPPZY_SITE_ID;

export async function rateCommerceAnswer(req, res) {
  const { sessionId, requestId, rating } = req.body;

  if (!["good", "bad"].includes(rating)) {
    return res.status(400).json({ error: "rating must be good or bad" });
  }

  await uppzy(`/m2m/sites/${SITE_ID}/chat/feedback`, {
    method: "POST",
    body: {
      session_id: sessionId,
      request_id: requestId,
      feedback: rating,
    },
  });

  return res.status(204).end();
}