Sunucusuz sesli oturum: kendi uygulamanıza gömün

API anahtarıyla kendi ön yüzünüzden asistanla sesli oturum açın — widget gerekmez, numara gerekmez. Tek istek, tek bağlantı.

Güncellendi: 17 Ağustos 2026

Sesli asistanı doğrudan kendi uygulamanıza gömün — widget yok, telefon numarası yok. Bir oturum token’ı istersiniz, kendi LiveKit istemcinizle bağlanırsınız. Asistan odaya kendiliğinden katılır ve yapılandırdığınız sesle, yapılandırdığınız talimatla konuşur.

Widget’tan farkı: arayüzün tamamı sizde. Widget hazır bir sohbet balonu verir; sesli oturum yalnızca ses kanalını verir, görünen her şeyi siz kurarsınız.

1. Oturum açma

curl -X POST https://api.call2me.app/v1/voice/sessions \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"agent_id": "agent_abc123"}'

{
  "token": "<livekit-jwt>",
  "url": "wss://livekit.call2me.app",
  "room_name": "agent_abc123_9f2c1a0b",
  "session_limit_sec": 3600
}

session_limit_sec, oturumun üst sınırıdır — bu süre dolduğunda oturum kapanır. Oturum durumunu sorgulamak için GET /v1/voice/sessions/{room_name} ucunu kullanabilirsiniz.

2. Tarayıcıdan bağlanma

import { Room } from 'livekit-client'

// Yukarıdaki isteği KENDİ sunucunuzdan geçirin — API anahtarı sunucuda kalsın.
const { token, url } = await (await fetch('/api/sesli-oturum')).json()

const room = new Room()
await room.connect(url, token)
await room.localParticipant.setMicrophoneEnabled(true)
// Asistan odaya kendiliğinden katılır ve konuşmaya başlar.

API anahtarını sunucu tarafında tutun. /v1/voice/sessions çağrısını kendi arka ucunuzdan yapın; sk_ ile başlayan anahtarı asla tarayıcıya göndermeyin. Anahtar hesabınızın tamamına erişir.

Mobil uygulamalar için doğru desen

Mobil uygulamada API anahtarını gömmek daha da risklidir — uygulama paketi tersine mühendislikle açılabilir. İki katmanlı desen kullanın:

1Uygulama, sizin sunucunuza kimliğini doğrulayarak istek atar.
2Sunucunuz kendi API anahtarıyla /v1/voice/sessions çağırır.
3Sunucunuz uygulamaya yalnızca url ve token döner.
4Uygulama LiveKit istemcisiyle bağlanır.

Kalıcı bir entegrasyon kuruyorsanız geçici son-kullanıcı token’ları da bir seçenek: sunucunuz kısa ömürlü, yalnızca belirlediğiniz asistanlara yetkili bir token üretir ve uygulama onunla çalışır.

Anahtar ve token yönetimi

Korumalar ve hata kodları

Kod	Anlamı	Ne yapmalı
404	Asistan bulunamadı veya size ait değil	agent_id’yi ve anahtarın hangi hesaba ait olduğunu kontrol edin
402	Asistan sahibinin bakiyesi yetersiz	Cüzdana yükleme yapın
429	Günlük oturum sınırına ulaşıldı	Sınırın artırılması için iletişime geçin
403	API anahtarı salt-okuma	Salt-okuma anahtarlar oturum açamaz — tam yetkili anahtar kullanın

Faturalama

Ücret konuşma dakikası başına asistan sahibinin cüzdanından düşer. Kimse konuşmazsa ücret oluşmaz. Telefon hattı kalemi yoktur — oturum WebRTC üzerinden çalışır, telefon şebekesine hiç çıkmaz.

Uygulamanızın son kullanıcısı ödeme yapmaz; maliyet size aittir. Kendi kullanıcılarınıza fiyatlandırma yapıyorsanız oturum sürelerini kendi tarafınızda sınırlamayı düşünün — session_limit_sec platform üst sınırıdır, iş kuralınız değil.

Ne zaman bu, ne zaman diğerleri

İhtiyaç	Doğru kanal
Pazarlama sitesine hızla sohbet/ses eklemek	Widget
Kendi tasarımınızla ürün içi sesli destek	Sesli oturum (bu sayfa)
Numarası olan herkesin erişebileceği hat	Telefon numarası + asistan
Kullanıcı kimliği ve oda adını kendiniz yönetmek	LiveKit token ucu
İki insan arasında çeviri	Tercüman

Tarayıcı arama detayları

Sık sorulanlar

Kendi web uygulamama sesli asistan ekleyebilir miyim?

Evet. POST /v1/voice/sessions ucuna agent_id ve API anahtarınızla istek atarsınız; dönen LiveKit token ve url ile herhangi bir LiveKit istemcisinden bağlanırsınız. Asistan odaya kendiliğinden katılır ve konuşur.

Sunucusuz sesli oturumun ücretini kim ödüyor?

Asistan sahibinin cüzdanı, konuşma dakikası başına. Kimse konuşmazsa ücret oluşmaz. Telefon hattı ücreti yoktur çünkü oturum telefon şebekesine hiç çıkmaz.

API anahtarımı uygulamaya gömebilir miyim?

Gömmeyin. Anahtar hesabınızın tamamına erişir ve uygulama paketleri tersine mühendislikle açılabilir. Oturum isteğini kendi sunucunuzdan geçirin ve istemciye yalnızca url ile token verin.

Bir oturum en fazla ne kadar sürer?

Yanıtta dönen session_limit_sec değeri üst sınırdır. Bu platform tarafındaki güvenlik sınırıdır; kendi iş kurallarınız için oturumu daha erken kapatmak sizin sorumluluğunuzdadır.

Salt-okuma anahtarla oturum açabilir miyim?

Hayır, 403 döner. Salt-okuma anahtarlar yalnızca GET isteklerini yapabilir; oturum açmak veri yaratan bir işlem olduğu için tam yetkili anahtar gerekir.

850santral