Tarayıcıdan arama (WebRTC)

Tarayıcı sesi, telefon ve yazının ardından gelen üçüncü kanaldır. Kullanıcı sitenizde bir düğmeye basar, tarayıcısı asistanla gerçek zamanlı konuşur — numara yok, telefon hattı ücreti yok.

Nasıl çalışır

1. 1Sunucunuz platformdan bir oturum token’ı ister — tek kullanıcıya ve tek asistana kapsanmış.
2. 2Ön yüzünüz LiveKit JS SDK’sı ile odaya katılır.
3. 3Asistan aynı odaya katılır.
4. 4İki taraf konuşur; tanıma, model ve sentez aradaki katmanda çalışır.

Token kimin katılabileceğini ve hangi odaya düşeceğini belirler. Odalar izole edilmiştir; token olmadan katılım mümkün değildir.

Token alma

curl -X POST https://api.call2me.app/v1/livekit/token \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agent_abc123",
    "user_identity": "musteri_4521",
    "metadata": { "email": "[email protected]" }
  }'

{
  "url": "wss://livekit.call2me.app",
  "token": "eyJ...",
  "room_name": "agent_abc123_musteri_4521_session_xyz"
}

Ön yüz kodu

<script type="module">
import { Room, RoomEvent } from 'https://esm.sh/livekit-client@latest';

// Token'ı KENDİ sunucunuzdan alın — API anahtarı sunucuda kalsın.
const r = await fetch('/api/sesli-oturum', { method: 'POST' });
const { url, token } = await r.json();

const room = new Room();
room.on(RoomEvent.TrackSubscribed, (track) => {
  if (track.kind === 'audio') track.attach(document.getElementById('asistan-ses'));
});

await room.connect(url, token);
await room.localParticipant.setMicrophoneEnabled(true);
</script>

<audio id="asistan-ses" autoplay></audio>
<button onclick="room.disconnect()">Görüşmeyi bitir</button>

İstemci tarafı bu kadar. SDK mikrofon iznini, WebRTC el sıkışmasını ve ses yönlendirmesini kendisi yapar.

Token ömrü

Token’lar kısa ömürlüdür — tipik olarak üretildikten sonra 60 dakika geçerlidir. Uzun oturumlar için sunucunuz süre dolmaya yaklaşırken yeni token üretmeli. SDK, disconnected olayını token-expired sebebiyle tetikler; kodunuz yeni token alıp yeniden bağlanır.

Canlı dökümü almak

Döküm aynı oda üzerinden veri mesajı olarak yayınlanır. Panelin canlı döküm görünümü de bu yolla çalışır; kendi arayüzünüzde aynı deseni kullanabilirsiniz.

room.on(RoomEvent.DataReceived, (payload) => {
  const msg = JSON.parse(new TextDecoder().decode(payload));
  if (msg.type === 'transcript') {
    console.log(msg.speaker + ': ' + msg.text);
  }
});

Kanalların karşılaştırması

Tarayıcı daha hızlıdır çünkü telefon şebekesi atlaması yoktur. Telefon evrenseldir — numarası olan herkes erişir. Yazılı sohbet en ucuzdur. Üçü aynı asistanla yan yana çalışabilir.

Türkiye’de pratik kullanım

• Kayıtlı kullanıcıya panel içinden destek — kullanıcı zaten giriş yapmış, numara sormaya gerek yok.
• Numara satın alma öncesi ürün denemesi — asistanı gerçek sesle test etmenin en ucuz yolu.
• Yurt dışındaki kullanıcıyla görüşme — uluslararası dakika ücreti oluşmaz.
• Mobil uygulama içi destek — telefon açtırmadan uygulamadan konuşma.