canonical: https://jentic.com/apis/callchatsyn.com/callchatsyn

# CallChatSyn API

The CallChatSyn API lets a website, app, or AI agent answer customer questions and book appointments through a business's own answering bot. You send a customer message to the answer operation and get the bot's reply, list the open appointment times the business offers, create a booking for an open slot, and cancel a booking by id. Requests count toward the business's own plan usage, and a public demo key is available to try the flow without signing up.

## For AI agents

Answer a customer's question with a business's bot, list open appointment slots, and book or cancel appointments. Authenticates with a bearer API key.

## Scope

Does not handle live agent handoff, payment collection, or outbound marketing messages. Use for answering customer questions and booking appointments through the business bot only.

## Capabilities

- Answer a customer's message with the business's bot
- List the open appointment times a business offers
- Book an open appointment slot for a customer
- Cancel an existing booking by id

## Use cases

### Agent Answering and Booking

An AI agent connected through Jentic passes a customer's question to the answer operation and, when the visitor wants to meet, lists open times and books a slot, so a site assistant can both respond and schedule in one conversation. Because answering and booking are separate operations, the agent only books when the customer confirms a time.

Example prompt: Answer the visitor's question about pricing, then list open times and book the slot they choose

### Website Answer Widget

A website sends each visitor message to the answer operation and shows the bot's reply, so a site answers common questions with the business's own knowledge without a live agent. The reply comes back in the same call, ready to render in a chat widget.

Example prompt: Send the visitor's message to the answer operation and return the bot's reply for the chat widget

### Self-Serve Appointment Booking

An app lists the business's open slots, books the one a customer picks with their name and contact details, and can cancel it later by id, so appointment scheduling runs end to end through the API. The slots operation reflects the times the business currently offers.

Example prompt: List open slots for a haircut, book the 2pm time for the named customer, and confirm the booking

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | `/api/v1/answer` | Answer a customer's message |
| GET | `/api/v1/slots` | List open appointment times |
| POST | `/api/v1/bookings` | Book an open time |
| DELETE | `/api/v1/bookings/{id}` | Cancel a booking |

## Key resources

- **Answer** — Send a customer message and get the business bot's reply
- **Slots** — List the open appointment times a business offers
- **Bookings** — Book an open slot for a customer and cancel it by id

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 50 / 100
- **Maturity:** Foundational
- **Dimensions:**
  - Foundational Compliance: 74 / 100
  - Developer Experience & Jentic Compatibility: 61 / 100
  - AI-Readiness & Agent Experience: 25 / 100
  - Agent Usability: 94 / 100
  - Security: 60 / 100
  - AI Discoverability: 81 / 100
- **View full report:** https://jentic.com/apis/callchatsyn.com/callchatsyn/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring the CallChatSyn API by hand means handling its bearer key auth, sequencing the answer, slots, and booking operations, and tracking which bookings count toward the plan. Through Jentic you install once, import CallChatSyn from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** You choose which operations your agent may call, so you can allow answering questions and listing slots while leaving booking and cancellation out. The message and booking details travel in the request body, so rules bound which operations run rather than which customer is involved.
- **Credential handling:** Your CallChatSyn key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'answer a customer question' or 'book an appointment', and Jentic returns the matching CallChatSyn operation with its input schema so the agent calls the right endpoint without reading the reference docs.

## Related APIs

- **Intercom API** — Customer messaging platform with bots and a help desk
- **Crisp API** — Website chat and chatbot platform for customer conversations
- **Retell AI API** — Voice AI for phone-based customer conversations

## FAQ

### Is there a CallChatSyn MCP server?

You don't need an MCP server to give your agent the CallChatSyn API. Jentic connects it directly from the API Directory: import it, store your key once, and your agent can answer questions and book appointments straight away, with no extra server to run and no tool definitions loaded into the agent's context.

### Can I limit what my agent is allowed to do with the CallChatSyn API?

Yes. You choose which operations your agent may call, so you can allow answering questions and listing open slots while leaving booking and cancellation out, and every call it makes is logged. That lets a read-only assistant respond to visitors without ever scheduling or cancelling.

### What authentication does the CallChatSyn API use?

The CallChatSyn API authenticates with a bearer API key per its OpenAPI spec, created in the dashboard under Developers, and a public demo key lets you try the flow before signing up. Through Jentic the key is stored encrypted by your own instance and added to each request at call time.

### Can I book an appointment through the CallChatSyn API?

Yes. You list the open times the business offers, then create a booking for a chosen slot with the customer's name and contact details, and you can cancel that booking later by its id. Booking requires a start time and a service.

### What are the rate limits for the CallChatSyn API?

The OpenAPI spec does not publish a fixed rate limit; requests count toward the business's own plan usage, as described in the spec. For the limits on your plan, see the CallChatSyn dashboard under Developers.

### How do I answer a customer question with the CallChatSyn API through Jentic?

Import the CallChatSyn API from the Jentic API Directory, then have your agent issue a request such as 'answer this customer message'. Jentic matches the intent to the answer operation and returns its input schema so the agent builds a valid request, with your stored key injected at call time. To run it on your own infrastructure, install Jentic One from its GitHub repo.