CallChatSyn

Answer a customer's message for one small business using only that business's own FAQs and order records. Rule-based, not generated, so it never invents prices or opening hours; English and Chinese are detected automatically. Read-only: it never books or changes anything. Use it first for any customer message. If it returns intent 'appointment', call list_open_times next; if matched is false or intent is 'human_handoff', tell the customer a person will follow up. Authenticates with the connection's API key (Authorization: Bearer ccs_live_…); without a key it answers as a public demo business. Returns JSON { intent, lang, matched, reply, next? }.

{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "description": "The customer's message exactly as they wrote it (1-2,000 characters, English or Chinese). Don't rephrase or translate it."
    }
  },
  "required": [
    "message"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List the business's next open appointment times: up to 5, soonest first, within the next 7 days, labelled in the business's time zone, plus its services and locations. Read-only. Call it before book_appointment and whenever a customer asks when they can come in. Times come from the business's CallChatSyn hours or from its connected Cal.com calendar. Returns JSON { slots: [{ start, label }], services, locations }; pass a slot's 'start' to book_appointment unchanged. An empty slots list means nothing is open this week.

{
  "type": "object",
  "properties": {
    "lang": {
      "description": "Language of the human-readable labels: 'en' (default) or 'zh'. Times themselves are always ISO 8601 UTC.",
      "type": "string",
      "enum": [
        "en",
        "zh"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Book one appointment for a customer. This creates a real booking: the business is notified, and if it has connected Cal.com the booking is created there too. With the demo key it's a dry run that books nothing. Not idempotent: booking the same time twice fails the second time. Only call it after the customer has confirmed the time and service; needs a 'start' from list_open_times and the customer's email or phone. Errors: 404 the time is no longer offered (call list_open_times again), 409 it was just taken, 400 missing start, service, or both email and phone, or the business's connected calendar needs a detail the customer didn't give (the message says which, e.g. an email). Returns JSON { booked, id, start, label }; keep 'id' if the customer may want to cancel.

{
  "type": "object",
  "properties": {
    "start": {
      "type": "string",
      "description": "The exact 'start' value returned by list_open_times (ISO 8601 UTC), unchanged."
    },
    "service": {
      "type": "string",
      "minLength": 1,
      "description": "What the customer is booking; use one of the 'services' returned by list_open_times."
    },
    "name": {
      "description": "The customer's name as they gave it; shown to the business.",
      "type": "string"
    },
    "email": {
      "description": "The customer's email. Give email or phone (at least one is required).",
      "type": "string"
    },
    "phone": {
      "description": "The customer's phone in international format, e.g. +6591234567. Give email or phone (at least one is required).",
      "type": "string"
    },
    "remarks": {
      "description": "Optional note for the business, up to 500 characters (e.g. 'first visit').",
      "type": "string",
      "maxLength": 500
    }
  },
  "required": [
    "start",
    "service"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Cancel one of the business's bookings by the 'id' that book_appointment returned. This changes data: the time becomes free again, and if the business has connected Cal.com the booking is cancelled there too (Cal.com emails the customer). Only call it after the customer has clearly asked to cancel that specific booking. To reschedule, cancel and then book a new time from list_open_times. With the demo key it's a dry run. Errors: 404 no such booking for this business, 409 already cancelled, 400 not a booking id. Returns JSON { cancelled, id, start }.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The booking 'id' returned by book_appointment (a UUID)."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}