# Giriş

Sayfa: https://docs.sonecentral.com/
Markdown: https://docs.sonecentral.com/index.md

> Sonecentral metin asistanınızı kendi uygulamanızdan ve sitenizden, sektörün bildiği OpenAI ve Vercel AI SDK biçimleriyle çağırın.

> **Dokümanı ajanınıza verin.** Dokümanın tamamı tek bir Markdown dosyasında: https://docs.sonecentral.com/llms-full.txt . Kodlama ajanınıza bu adresi yapıştırın. Tek bir sayfa için o sayfanın .md adresini verin, örneğin https://docs.sonecentral.com/hizli-baslangic.md . Sayfaların listesi: https://docs.sonecentral.com/llms.txt

## Bu API ne yapar

Sonecentral'da kurduğunuz metin asistanı WhatsApp'ta, Instagram'da ve Messenger'da müşterilerinize yanıt veriyor. Bu API aynı asistanı sizin uygulamanıza, sitenize ya da arka uç kodunuza açar.

Yanıtı bir dil modeli değil, **sizin asistanınız** verir. Panelde yazdığınız talimat ve çalışma alanınızda tanımlı her şey burada WhatsApp, Instagram ve Messenger'daki gibi aynen geçerlidir: hizmetleriniz, ürünleriniz ve stokunuz, katalog öğeleriniz, ekibiniz, bölümleriniz, çalışma saatleriniz, işletme bilgileriniz, kampanyalarınız, kargo kurallarınız, fiyat listeniz ve iskonto yetkiniz, Bilgi Bankası'ndaki belgeler ve onlardan çıkarılan işletme verileri, sipariş ve randevu talepleri, ekibe devir. Çünkü ortada ikinci bir asistan yok: istek, WhatsApp mesajını yanıtlayan aynı çalışma zamanından geçer.

Tek fark ziyaretçinin anonim olmasıdır. Asistan kişinin kendi kayıtlarına bakmaz, randevuyu kendisi kesinleştirmez; her sipariş ve randevu ekibinizin onayını bekleyen bir taleptir.

## Adres ve biçimler

Bütün istekler tek adrese gider:

```txt
https://pb.sonecentral.com/api/v1
```

Üç biçimden birini seçin. Üçü de aynı asistanla, aynı sohbet kaydıyla çalışır.

| Uç nokta | Biçim ve ne zaman |
| --- | --- |
| `POST /chat/completions` | OpenAI Chat Completions. OpenAI SDK'sı ya da onunla uyumlu bir istemci zaten elinizdeyse. |
| `POST /responses` | OpenAI Responses. Sohbeti `previous_response_id` ile sürdürmek istiyorsanız. |
| `POST /chat` | Vercel AI SDK. React ya da Next.js'te `useChat` ile sohbet penceresi yapıyorsanız. |

`model` alanına asistanınızın kimliğini yazarsınız. Kimlikleri [Asistanlar ve modeller](https://docs.sonecentral.com/asistanlar-ve-modeller.md) sayfasındaki `GET /models` listeler. Anahtarınız tek bir asistana açıksa `"default"` yazmanız yeterli.

## Bilinmesi gerekenler

- **Ziyaretçiler anonimdir.** API'den gelen kişinin kimliği doğrulanmaz. Asistan ona ürün, fiyat, stok ve randevu uygunluğu gibi herkese açık konularda yardım eder; geçmiş siparişler ya da mevcut randevular gibi kişisel kayıtları paylaşmaz. Ayrıntılar: [Siparişler, randevular ve gizlilik](https://docs.sonecentral.com/siparis-randevu-gizlilik.md).
- **Yanıt balon balon gelir.** İşletmenin güvenlik kontrolleri yanıtın tamamına bakar, metin bu kontrollerden sonra yola çıkar. Akışta harf harf değil, mesaj mesaj ilerlersiniz. Ayrıntılar: [Akış](https://docs.sonecentral.com/akis.md).
- **Zengin mesajlar düz metinle birlikte gelir.** Ürün kartları, düğmeler ve dosyalar yapılandırılmış veri olarak gelir; her birinin düz metin karşılığı da vardır. Ayrıntılar: [Zengin mesajlar](https://docs.sonecentral.com/zengin-mesajlar.md).
- **Sohbetler Mesajlar ekranında görünür.** API'den açılan her sohbet Sonecentral'daki Mesajlar ekranında **API** kaynağıyla, ziyaretçi **API ziyaretçisi** adıyla görünür. Asistan gerektiğinde sohbeti ekibinize devreder; ekip oradan yazar, ziyaretçi bu yanıtları API'den okur. Ayrıntılar: [İnsan devri ve ekip yanıtları](https://docs.sonecentral.com/insan-devri.md).

## Uç noktalar

| Uç nokta | Açıklama |
| --- | --- |
| `GET /models` | Anahtarın kullanabildiği asistanlar. [Asistanlar ve modeller](https://docs.sonecentral.com/asistanlar-ve-modeller.md) |
| `GET /models/{id}` | Tek bir asistan. |
| `POST /chat/completions` | OpenAI Chat Completions, akışlı ya da akışsız. [Chat Completions](https://docs.sonecentral.com/chat-completions.md) |
| `POST /responses` | OpenAI Responses, akışlı ya da akışsız. [Responses API](https://docs.sonecentral.com/responses.md) |
| `GET /responses/{id}` | Saklanan bir yanıt. |
| `DELETE /responses/{id}` | Saklanan bir yanıtı siler. |
| `GET /responses/{id}/input_items` | Bir yanıtın girdi öğeleri. |
| `POST /responses/{id}/cancel` | Yanıt varsa her zaman `400 not_cancellable` döner, yoksa `404 response_not_found`; yanıtlar istek içinde tamamlanır. |
| `POST /chat` | Vercel AI SDK UI mesaj akışı, yani `useChat`. [Vercel AI SDK](https://docs.sonecentral.com/vercel-ai-sdk.md) |
| `GET /chat/{id}/stream` | `useChat({ resume: true })` için. Her zaman `204` döner. [Bağlantı koparsa](https://docs.sonecentral.com/vercel-ai-sdk.md#baglanti-koparsa) |
| `GET /conversations/{id}` | Sohbetin kimde olduğu: asistanda ya da ekipte. [Sohbetin durumu](https://docs.sonecentral.com/insan-devri.md#sohbetin-durumu) |
| `GET /conversations/{id}/messages` | Bir sohbetin mesajları; ekip yanıtlarını okumak için. [İnsan devri](https://docs.sonecentral.com/insan-devri.md) |
| `GET /files/{id}` | Asistanın paylaştığı bir dosyanın imzalı indirme adresi. Anahtar istemez. [Dosyayı indirmek](https://docs.sonecentral.com/zengin-mesajlar.md#dosya-indirme) |
| `GET /key` | Kullandığınız anahtarın özeti. [Kimlik doğrulama](https://docs.sonecentral.com/kimlik-dogrulama.md#anahtari-denetlemek) |

Hepsi `OPTIONS` ön isteğine yanıt verir, bu yüzden tarayıcıdan tarayıcı anahtarıyla çağrılabilir. `GET /files/{id}` dışındaki her uç nokta anahtar ister ve anahtarın [sınırlarına](https://docs.sonecentral.com/limitler.md) sayılır.

## Sonraki adım

[Hızlı başlangıç](https://docs.sonecentral.com/hizli-baslangic.md) ile anahtarınızı oluşturup ilk isteği gönderin.