Sohbet: aynı asistanla yazılı görüşme

Sohbet, sesli asistanlarınızdan biriyle yapılan yazılı görüşmedir. Asistan tanımı ortaktır: aynı talimat, aynı bilgi tabanı, aynı fonksiyonlar. Değişen tek şey kanal katmanı — beyin aynı kalır.

İki kullanım yolu

Sohbet başlatma

curl -X POST https://api.call2me.app/v1/chats \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agent_abc123",
    "title": "Destek talebi",
    "external_user_id": "musteri_4521",
    "metadata": { "kaynak": "destek-sayfasi" }
  }'

Dönen session_id’yi saklayın — sonraki mesajları bu kimlikle gönderirsiniz. external_user_id alanı kendi kullanıcı kimliğinizi taşımak için vardır; sohbetleri kendi sisteminizdeki kullanıcıyla eşleştirmenizi sağlar.

Mesaj gönderme

curl -X POST https://api.call2me.app/v1/chats/chat_xyz789/messages \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "content": "4521 numaralı siparişim nerede?" }'

Cevap, kullanıcı mesajı ve asistan mesajını birlikte döner. content alanı en fazla 4000 karakter olabilir. Model alanı gönderirseniz yok sayılır — model her zaman asistan yapılandırmasından okunur.

{
  "user_message": { "message_id": "msg_abc123", "role": "user", "content": "..." },
  "assistant_message": {
    "message_id": "msg_def456",
    "role": "assistant",
    "content": "Siparişiniz dün kargoya verildi, perşembe günü teslim edilecek.",
    "tokens_input": 412,
    "tokens_output": 38
  }
}

Akış halinde cevap (SSE)

"Yazıyor..." deneyimi için aynı uca stream: true ekleyin. Cevap text/event-stream olarak gelir; her satır bir data: olayıdır.

curl -N -X POST https://api.call2me.app/v1/chats/chat_xyz789/messages \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "content": "Siparişim nerede?", "stream": true }'

data: {"delta": "Siparişiniz dün "}

data: {"delta": "kargoya verildi."}

data: {"done": true, "message_id": "msg_def456", "cost_usd": 0.012}

data: [DONE]

delta değerlerini birleştirerek tam cevabı kurarsınız; son olayda mesaj kimliği ve maliyet gelir. Hem sk_ anahtarlarıyla hem geçici son-kullanıcı token’larıyla çalışır.

Geçmişi okumak

# Sohbet listesi
curl https://api.call2me.app/v1/chats \
  -H "Authorization: Bearer sk_live_..."

# Tek sohbetin mesajları
curl https://api.call2me.app/v1/chats/chat_xyz789/messages \
  -H "Authorization: Bearer sk_live_..."

Fiyatlandırma

Sohbet mesaj başına ücretlendirilir: $0.01. Hem kullanıcı hem asistan mesajları sayılır. Fonksiyon çağrıları ayrı ücretlendirilmez; onları tetikleyen mesajın parçasıdır.

Bilgi tabanı ve fonksiyonlar

İkisi de seste olduğu gibi çalışır: bilgi tabanından ilgili parçalar getirilir, fonksiyon çağrısına model karar verir, platform ucunuzu çağırır ve sonuç bir sonraki mesaja girer.

Ses ve yazının asimetrisi

• Sohbet bağlantı, buton ve biçimlendirilmiş metin gösterebilir; ses gösteremez.
• Ses tonu duyar; sohbet duymaz.
• Sesli cevaplar tek cümle olmalıdır (telefonda uzun monolog kötüdür); sohbette daha uzun yazılabilir.

Talimata küçük bir koşul eklemek yeterlidir:

Kullanıcı telefonda ise cevapları kısa tut (1-2 cümle).
Kullanıcı yazıyorsa biraz daha ayrıntılı olabilir ve
gerektiğinde madde işaretleri kullanabilirsin.

Widget mı API mı