# Sonecentral text assistant API

> Call your Sonecentral text assistant from your own app or website. Supports OpenAI Chat Completions, OpenAI Responses and Vercel AI SDK formats, with the same assistant that replies on WhatsApp.

API base URL: https://pb.sonecentral.com/api/v1. Full documentation in one file: https://docs.sonecentral.com/en/llms-full.txt. Each link below is the Markdown version of a page.

## Getting started

- [Introduction](https://docs.sonecentral.com/en/index.md): Call your Sonecentral text assistant from your own app or website using familiar OpenAI and Vercel AI SDK formats.
- [Quickstart](https://docs.sonecentral.com/en/hizli-baslangic.md): Create a key, find your assistant's ID and send your first message.
- [Authentication and keys](https://docs.sonecentral.com/en/kimlik-dogrulama.md): Server and publishable keys, authentication headers, allowed origins and revocation.

## Endpoints

- [Assistants and models](https://docs.sonecentral.com/en/asistanlar-ve-modeller.md): What to put in model, how to list assistants and what "default" means.
- [Chat Completions](https://docs.sonecentral.com/en/chat-completions.md): Send messages using OpenAI Chat Completions. The sone fields carry conversation state and rich messages.
- [Responses API](https://docs.sonecentral.com/en/responses.md): Use OpenAI Responses, continue with previous_response_id or conversation, and read or delete stored responses.
- [Vercel AI SDK](https://docs.sonecentral.com/en/vercel-ai-sdk.md): Connect useChat directly to /chat with typed rich message parts, or use generateText and streamText through an OpenAI provider on your server.

## Chat

- [Streaming](https://docs.sonecentral.com/en/akis.md): How streamed replies arrive, how connections stay alive and why text progresses message by message.
- [Channels and message types](https://docs.sonecentral.com/en/kanallar.md): Official TikTok support and how native messaging differs from the developer API.
- [Rich messages](https://docs.sonecentral.com/en/zengin-mesajlar.md): Product and service cards, buttons, quick replies and files arrive as SoneMessage objects, each with a plain text fallback.
- [Conversation continuity](https://docs.sonecentral.com/en/sohbet-surekliligi.md): Keep anonymous chats across refreshes, understand conversation lookup and retry messages safely.
- [Embedded chat widget](https://docs.sonecentral.com/en/sohbet-penceresi.md): A website chat connected to your assistant, with complete HTML/JavaScript and React/Next.js examples.
- [Human handoff and team replies](https://docs.sonecentral.com/en/insan-devri.md): How conversations move to your team and how staff replies reach the visitor.

## Guidelines

- [Orders, appointments and privacy](https://docs.sonecentral.com/en/siparis-randevu-gizlilik.md): What anonymous API visitors can do, what stays private and why requests need your team's approval.
- [Errors](https://docs.sonecentral.com/en/hatalar.md): Error response formats, every error code, retry rules and recovery steps.
- [Limits](https://docs.sonecentral.com/en/limitler.md): Request limits, automatic replies, conversations, messages, stored responses, files and keys.
- [Frequently asked questions](https://docs.sonecentral.com/en/sss.md): Streaming, model settings, handoff, lost keys, retries, privacy and API usage.
- [Changelog](https://docs.sonecentral.com/en/surum-notlari.md): API changes, newest first.