Web SDK とは
Web SDK はウェブサイトに埋め込む小さなコードです。訪問者が「今すぐ話す」ボタンをクリックすると、ブラウザ内でマイクを使って OneInbox エージェントとのライブ音声会話が始まります。 ライブチャットウィジェットの音声版と考えてください。 SDK が処理するもの:- ブラウザへのマイク許可のリクエスト
- リアルタイムの音声ストリーミング(双方向)
- 会話中のライブトランスクリプト表示
- ミュート、ミュート解除、ハングアップ
- OneInbox のエージェント(応答する AI)
- 通話を開始するサイト上のボタンまたはウィジェット
クイックスタート — サイトへの最も簡単な追加方法
これが最速のパスです:公開可能なキー + Web SDK、バックエンド不要。1
エージェントを作成する
通話に応答するエージェントを構築します — まだ作成していない場合は クイックスタート を参照してください。その
id(agt_…)を保存します。2
公開可能なキーを作成する
OneInbox ダッシュボード で Settings → Publishable Keys → Create key へ。このキーに許可するオリジンを入力します — 1 行に 1 つ:
キーをコピーします —
oi_pk_live_… で始まります。3
Web SDK をインストールする
4
エージェントに接続する
公開可能なキーで SDK を初期化し、
start() でエージェントの id を指定します:5
サイトにボタンを追加する
start() の呼び出しを任意のボタンに接続します — 例えば「今すぐ話す」。訪問者がクリックすると、マイクを使ってブラウザ内でその場で通話が始まります。プロダクトへの組み込み方
訪問者が「通話する」をクリックすると:- ウェブサイトがサーバーに問い合わせます:「この訪問者の通話を開始して」
- サーバーが OneInbox API 経由で通話を作成し、短命のアクセストークンを受け取ります
- Web SDK がそのトークンを使って訪問者のブラウザをエージェントに接続します
- 会話が始まります — ライブ、双方向の音声
2 つのパッケージ
どちらも同じことをします。React パッケージは React に使いやすいパターンでコアをラップしたものです。
インストール
Vanilla サンプル
リッスンできるイベント
コントロール
React サンプル
useOneInbox() は通話 UI の構築に必要なすべてを提供します: