Vapi 電話番号セットアップ

Twilio、Vonage、Telnyx から電話番号をインポートするか、Vapi の組み込み番号を使用して、音声 AI アシスタントを実際の電話通話に接続します。

セットアップ: VAPI_API_KEY が設定されていることを確認してください。必要に応じて setup-api-key スキルを参照してください。

クイックスタート — Vapi 番号を購入する

Vapi は、日々の通話制限付きのテスト用に無料の電話番号を提供しています。

curl -X POST https://api.vapi.ai/phone-number \
  -H "Authorization: Bearer $VAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "vapi",
    "assistantId": "your-assistant-id",
    "name": "Main Support Line"
  }'

Twilio からインポート

curl -X POST https://api.vapi.ai/phone-number \
  -H "Authorization: Bearer $VAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "twilio",
    "number": "+11234567890",
    "twilioAccountSid": "your-twilio-account-sid",
    "twilioAuthToken": "your-twilio-auth-token",
    "assistantId": "your-assistant-id",
    "name": "Twilio Support Line"
  }'

Vonage からインポート

curl -X POST https://api.vapi.ai/phone-number \
  -H "Authorization: Bearer $VAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "vonage",
    "number": "+11234567890",
    "credentialId": "your-vonage-credential-id",
    "assistantId": "your-assistant-id",
    "name": "Vonage Support Line"
  }'

Telnyx からインポート

curl -X POST https://api.vapi.ai/phone-number \
  -H "Authorization: Bearer $VAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "telnyx",
    "number": "+11234567890",
    "credentialId": "your-telnyx-credential-id",
    "assistantId": "your-assistant-id",
    "name": "Telnyx Support Line"
  }'

アシスタントを割り当てる

すべての電話番号はインバウンド通話用にアシスタントまたはスクワッドにリンクできます。

curl -X PATCH https://api.vapi.ai/phone-number/{id} \
  -H "Authorization: Bearer $VAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "assistantId": "your-assistant-id"
  }'

またはスクワッドを割り当てます：

curl -X PATCH https://api.vapi.ai/phone-number/{id} \
  -H "Authorization: Bearer $VAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "squadId": "your-squad-id"
  }'

電話番号フック

通話が着信したときに自動アクションを設定します：

{
  "hooks": [
    {
      "on": "call.ringing",
      "do": [
        {
          "type": "say",
          "exact": "Please hold while we connect you."
        }
      ]
    }
  ]
}

電話番号を管理する

# すべての電話番号をリストする
curl https://api.vapi.ai/phone-number \
  -H "Authorization: Bearer $VAPI_API_KEY"

# 電話番号を取得する
curl https://api.vapi.ai/phone-number/{id} \
  -H "Authorization: Bearer $VAPI_API_KEY"

# 電話番号を更新する
curl -X PATCH https://api.vapi.ai/phone-number/{id} \
  -H "Authorization: Bearer $VAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Updated Name"}'

# 電話番号を削除する
curl -X DELETE https://api.vapi.ai/phone-number/{id} \
  -H "Authorization: Bearer $VAPI_API_KEY"

インバウンドコール フロー

1. 発信者が Vapi 電話番号にダイアルする
2. Vapi が通話を割り当てられたアシスタントまたはスクワッドにルーティングする
3. アシスタントが firstMessage を話す
4. 設定されたモデル、音声、ツールで会話を進める

アウトバウンドコール フロー

1. phoneNumberId と customer.number を指定して POST /call でコールを作成する
2. Vapi が電話番号から顧客にダイアルする
3. 応答されると、アシスタントが会話を開始する

無料番号の制限

• 国際通話を利用できない
• 日々の通話制限が適用される
• 本番運用には、自身の Twilio/Vonage/Telnyx 番号をインポートしてください

参考資料

• Vapi Phone Numbers Docs
• Free Telephony
• Phone Number Hooks

追加リソース

このスキルリポジトリには、Vapi ドキュメンション MCP サーバー（vapi-docs）が含まれており、AI エージェントが完全な Vapi ナレッジベースにアクセスできるようになります。searchDocs ツールを使用して、このスキルでカバーしている以上の詳細情報を検索できます。高度な設定、トラブルシューティング、SDK の詳細などを参照できます。

自動設定: これらのスキルをクローンまたはインストールした場合、MCP サーバーは .mcp.json（Claude Code）、.cursor/mcp.json（Cursor）、または .vscode/mcp.json（VS Code Copilot）を経由して既に設定されています。

手動セットアップ: エージェントが設定を自動検出しない場合は、以下を実行してください：

claude mcp add vapi-docs -- npx -y mcp-remote https://docs.vapi.ai/_mcp/server

すべてのサポートされているエージェント間での完全なセットアップ手順については、README を参照してください。