ページの一覧

ドキュメント

はじめかた

アカウントの作成から、エージェント・テナントを作って最初の会話をするまでの手順。

Markdown で見る

アカウントを作り、API キーでエージェントとテナントを作れば、電話か Web・アプリから AI と話せます。ここではテストの環境で、最初の会話までを進めます。

1. アカウント#

https://app.voicast.jp/signup でメールアドレスを入れると、確認のメールが届きます。メールのリンク(15 分有効)を開いて[登録を完了]を押すと、アカウントができてログインします。パスワードは要りません。Google・GitHub のアカウントでも登録できます。

次からは https://app.voicast.jp/login でメールアドレスを入れて[ログイン]を押し、届いたリンク(15 分有効・1 回だけ)からログインします。Google・GitHub でもログインできます。ログインのあと、アカウントの設定でパスキーを登録すると、次からはパスキーでもログインできます。

パスワードでのログインは 2026 年 10 月 31 日で終了します。パスワードでログインしていた方も、同じメールアドレスのログインリンク・Google・GitHub・パスキーで、同じアカウントにログインできます。

2. 組織#

最初のログインで組織を作ります。voicast の中のものは、組織 › プロジェクト › 環境の 3 段で分かれています。

段 何か ここで分かれるもの
組織 会社やチームの単位 メンバーとロール・請求(残高とチャージ)
プロジェクト 組織の中のサービスの単位。組織を作ると 1 つできます 本番環境とテスト環境の組
環境 本番環境(live)とテスト環境(test) エージェント・テナント・会話記録・API キー

管理画面の上の帯には、今いる場所が「組織 › プロジェクト › 本番環境」の順に出ます。テナントは環境の中に作る「電話を受けるお店や会社」で、組織やプロジェクトとは別のものです。

メンバーのロールは 4 つです。

ロール できること
オーナー(owner) すべて。チャージ・請求の管理・月の上限
管理者(admin) メンバーの招待、API キー、ツールの署名シークレット、請求の確認
開発者(developer) エージェント・テナント・連携の作成と変更
閲覧者(viewer) 見るだけ

3. 環境#

プロジェクトには本番環境(live)とテスト環境(test)の 2 つがあります。エージェント・テナント・会話・連携・API キーは環境ごとに分かれていて、ほかの環境からは見えません。

環境 API キー 料金
本番 vk_live_… 1 分 10 円(税抜)
テスト vk_test_… 本番と同じく数える

テストの環境も会話の秒数を本番と同じく数えます(無料の分数はありません)。開発中の試しの会話はテストの環境で行い、本番の環境の記録と混ぜないようにします。

4. チャージ#

料金は前払いのチャージ式です。残高が 0 以下のあいだは新しい会話を受けないので、最初にチャージします。管理画面の「組織の設定」→「請求」で、500〜300,000 円(税抜)をカードで入れます。チャージの期限は 6 か月です。詳しくは料金と請求。

5. API キー#

管理画面の「API キー」で、テストの環境のキーを作ります(管理者以上)。キーの値は作ったときに 1 回だけ表示されます。

bash
export VOICAST_API_KEY=vk_test_…

API キーはサービスのサーバーだけに置きます。ブラウザやアプリには渡しません(Web・アプリには、使い捨ての client_token を渡します)。

6. 最初のエージェント設定#

エージェント(agent)は、AI が何を話し、何を聞き取るかを決めるものです。

bash
curl https://api.voicast.jp/v1/agents \
  -H "Authorization: Bearer $VOICAST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "歯科医院の受付",
    "config": {
      "greeting": "お電話ありがとうございます。さくら歯科です。ご用件をお話しください。",
      "persona": "落ち着いた丁寧な受付。1 回の発話は 2 文まで",
      "fields": [
        { "key": "name", "label": "お名前", "required": true },
        { "key": "phone", "label": "折り返しの電話番号", "required": true, "type": "phone" },
        { "key": "purpose", "label": "ご用件", "required": true }
      ],
      "handoff_when": ["人と話したいと言われた", "急な痛みや腫れがある"],
      "closing": "承知しました。担当者から折り返しご連絡します。"
    }
  }'

返りの id(agt_…)を使います。項目の説明はエージェント設定。

7. テナント#

テナントは、実際に電話を受ける会社(サービスの顧客 1 社)です。external_id にはサービスの側の顧客の ID を入れます。

bash
curl https://api.voicast.jp/v1/tenants \
  -H "Authorization: Bearer $VOICAST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "external_id": "clinic-123", "name": "さくら歯科", "agent_id": "agt_…" }'

返りの secret(vts_…)は接続シークレット(会話を voicast に接続するときに渡す文字列)で、このときだけ返ります。サービスのサーバーに保存します。

8. 最初の会話#

つなぎ方は 2 つあります。

  • 電話: Twilio の番号の着信で、voicast の音声サーバーへ <Connect><Stream> する TwiML を返します。手順は電話でつなぐ。
  • Web・アプリ: サーバーで POST /v1/sessions を呼んで client_token を受け取り、ブラウザから WebRTC でつなぎます。手順はWeb・アプリでつなぐ。

MCP のツール(create_session)や SDK の voicast/web を使うと、ブラウザからすぐに試せます。

つなぐ前に話し方を確かめるなら、管理画面のエージェント設定の画面の[ブラウザーで試す]で、選んだテナントとして AI と話せます(管理画面で試す)。試す会話も料金がかかります。

9. 結果の確認#

会話が終わると、結果・聞き取った項目・要約が残ります。

bash
curl "https://api.voicast.jp/v1/calls?limit=5" \
  -H "Authorization: Bearer $VOICAST_API_KEY"
json
{
  "data": [
    {
      "id": "call_…",
      "tenant_id": "ten_…",
      "channel": "phone",
      "outcome": "completed",
      "fields": { "name": "山田太郎", "phone": "09012345678", "purpose": "予約の変更" },
      "summary": "予約の変更の依頼。来週火曜の午前を希望。",
      "category": "予約の変更",
      "duration_ms": 84210
    }
  ],
  "has_more": false
}

会話のたびに知らせを受けるには、Webhook の送り先を登録します。結果の受け取りを見てください。

次に読むもの#

  • エージェント設定: よくある質問・声・話す速さ
  • 会話中のツール: 予約の空きを自社の API で調べる・ほかの会社の API を API キーで呼ぶ
  • 連携: Google カレンダー・Google スプレッドシート・kintone との連携と、LINE WORKS・Teams への通知
  • MCP: Claude Code などから、ここまでの手順を会話で進める