Web・アプリでつなぐ

サービスのサーバー ── API キーで POST /v1/sessions ──→ voicast
        │ client_token・webrtc_url・ice_servers だけを渡す
ブラウザ・アプリ ── client_token 付きの WebRTC の offer ──→ voicast の音声サーバー

curl https://api.voicast.jp/v1/sessions \
  -H "Authorization: Bearer $VOICAST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "tenant_id": "ten_…", "output": "audio" }'

{
  "id": "sess_…",
  "tenant_id": "ten_…",
  "agent_id": "agt_…",
  "output": "audio",
  "client_token": "vct_…",
  "expires_at": 1790000120000,
  "webrtc_url": "https://voice.voicast.jp/v1/webrtc/offer",
  "ice_servers": [{ "urls": "stun:stun.cloudflare.com:3478" }]
}

import { VoiceSession } from 'voicast/web';

// client_token・webrtc_url・ice_servers は、自社のサーバーから受け取る
const session = new VoiceSession({ clientToken, webrtcUrl, iceServers });
session.on('user-transcript', ({ text, final }) => showUser(text, final));
session.on('bot-output', ({ text }) => showBot(text));
session.on('closed', ({ reason }) => console.log('closed', reason));
await session.start(); // マイクの許可を求めてからつなぐ

hangupButton.onclick = () => session.stop();

const pc = new RTCPeerConnection({ iceServers }); // セッションの ice_servers
const mic = await navigator.mediaDevices.getUserMedia({ audio: { echoCancellation: true, noiseSuppression: true } });
pc.addTransceiver(mic.getAudioTracks()[0], { direction: 'sendrecv' });
pc.ontrack = (e) => { audioEl.srcObject = e.streams[0]; audioEl.play(); };

const dc = pc.createDataChannel('chat', { ordered: true });
dc.onopen = () => {
  dc.send(JSON.stringify({ label: 'rtvi-ai', type: 'client-ready', id: crypto.randomUUID(), data: { version: '1.0.0' } }));
  setInterval(() => dc.readyState === 'open' && dc.send(`ping: ${Date.now()}`), 1000);
};
dc.onmessage = (e) => {
  const msg = JSON.parse(e.data);
  if (msg.label === 'rtvi-ai') onRtvi(msg); // 下の「届くもの」
};

await pc.setLocalDescription(await pc.createOffer());
await iceGatheringComplete(pc);
const r = await fetch(webrtcUrl, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ sdp: pc.localDescription.sdp, type: pc.localDescription.type, token: clientToken }),
});
if (!r.ok) throw new Error(`つなげません（${r.status}）`); // 403: トークンの期限切れ・使用済み
const answer = await r.json();
await pc.setRemoteDescription({ type: answer.type, sdp: answer.sdp });

type VoicastMessage =
  | { type: 'voicast.reply'; text: string }    // 返事の 1 文（あいさつ・締めの言葉も同じ形）
  | { type: 'voicast.interrupted' }            // 相手が話し始めた。話している途中の返事を止める
  | { type: 'voicast.end'; outcome: string };  // 会話を終える（このあと接続が閉じる）

import { VoiceSession } from 'voicast/web';
import { AvacastSession } from 'https://avacast.jp/sdk/v1.js';

// どちらのトークンも自社のサーバーで作る（voicast は output: 'text' のセッション）
const { voicast, avacast } = await fetch('/api/start-reception', { method: 'POST' }).then((r) => r.json());

const avatar = new AvacastSession(avacast.client_token, {
  signalingUrl: avacast.webrtc.signaling_url,
  iceServers: avacast.webrtc.ice_servers,
});
avatar.attach(document.getElementById('avatar'));
await avatar.start();

const talk = new VoiceSession({
  clientToken: voicast.client_token,
  webrtcUrl: voicast.webrtc_url,
  iceServers: voicast.ice_servers,
});
talk.on('reply', ({ text }) => avatar.speak(text));     // voicast の返事を avacast に話させる
talk.on('interrupted', () => avatar.interrupt());       // 相手が話し始めたら止める
talk.on('end', ({ outcome }) => showResult(outcome));
await talk.start();

curl https://api.voicast.jp/v1/calls/by-provider/sess_… \
  -H "Authorization: Bearer $VOICAST_API_KEY"