Vapi コール作成

Vapi の API を使用して、アウトバウンド通話、ウェブ通話、バッチ通話を開始します。音声アシスタントを実際の電話番号に接続し、プログラムによってテストできます。

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

クイックスタート — アウトバウンド通話

cURL

curl -X POST https://api.vapi.ai/call \
  -H "Authorization: Bearer $VAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "assistantId": "your-assistant-id",
    "phoneNumberId": "your-phone-number-id",
    "customer": {
      "number": "+11234567890"
    }
  }'

TypeScript (Server SDK)

import { VapiClient } from "@vapi-ai/server-sdk";

const vapi = new VapiClient({ token: process.env.VAPI_API_KEY! });

const call = await vapi.calls.create({
  assistantId: "your-assistant-id",
  phoneNumberId: "your-phone-number-id",
  customer: {
    number: "+11234567890",
  },
});

console.log("Call created:", call.id);

Python

import requests
import os

response = requests.post(
    "https://api.vapi.ai/call",
    headers={
        "Authorization": f"Bearer {os.environ['VAPI_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "assistantId": "your-assistant-id",
        "phoneNumberId": "your-phone-number-id",
        "customer": {"number": "+11234567890"},
    },
)

call = response.json()
print(f"Call initiated: {call['id']}")

通話タイプ

アウトバウンド通話

アシスタント、Vapi 電話番号、顧客番号が必要です。

{
  "assistantId": "assistant-id",
  "phoneNumberId": "phone-number-id",
  "customer": {
    "number": "+11234567890",
    "name": "John Doe",
    "numberE164CheckEnabled": true
  }
}

ウェブ通話

ブラウザベースの通話 — 電話番号は不要です。クライアント側で Vapi Web SDK を使用します。

{
  "assistantId": "assistant-id"
}

クライアント側 (JavaScript):

import Vapi from "@vapi-ai/web";

const vapi = new Vapi("your-public-key");
vapi.start("your-assistant-id");

一時的なアシスタント通話

保存済みのアシスタントを参照する代わりに、アシスタントをインラインで定義します:

{
  "assistant": {
    "name": "Quick Test",
    "firstMessage": "Hello! This is a test call.",
    "model": {
      "provider": "openai",
      "model": "gpt-4.1",
      "messages": [
        {
          "role": "system",
          "content": "You are a test assistant. Confirm the call is working and end politely."
        }
      ]
    },
    "voice": { "provider": "vapi", "voiceId": "Elliot" },
    "transcriber": { "provider": "deepgram", "model": "nova-3", "language": "en" }
  },
  "phoneNumberId": "phone-number-id",
  "customer": {
    "number": "+11234567890"
  }
}

スケジュール済み通話

将来の時間に通話をスケジュールします:

{
  "assistantId": "assistant-id",
  "phoneNumberId": "phone-number-id",
  "customer": {
    "number": "+11234567890"
  },
  "schedulePlan": {
    "earliestAt": "2025-06-15T14:00:00Z",
    "latestAt": "2025-06-15T15:00:00Z"
  }
}

• earliestAt — 通話を試みる最も早い時刻 (ISO 8601)
• latestAt — 通話を試みる最新の時刻 (オプション)
• assistantId を使用する場合、通話時にアシスタントの最新バージョンが使用されます
• 固定されたアシスタント設定の場合は、代わりに assistant (一時的) を使用してください

バッチ通話

1 つのリクエストで複数の番号に通話します:

{
  "assistantId": "assistant-id",
  "phoneNumberId": "phone-number-id",
  "customers": [
    { "number": "+11234567890", "name": "Alice" },
    { "number": "+10987654321", "name": "Bob" },
    { "number": "+15551234567", "name": "Carol" }
  ]
}

スケジュール済みバッチ通話の場合は schedulePlan と組み合わせてください。

メタデータ付き通話

通話中にアクセス可能なカスタムデータを渡します:

{
  "assistantId": "assistant-id",
  "phoneNumberId": "phone-number-id",
  "customer": {
    "number": "+11234567890"
  },
  "metadata": {
    "orderId": "ORD-12345",
    "department": "billing"
  }
}

通話の管理

# 通話をリスト表示
curl "https://api.vapi.ai/call?limit=10" \
  -H "Authorization: Bearer $VAPI_API_KEY"

# 特定の通話を取得
curl https://api.vapi.ai/call/{id} \
  -H "Authorization: Bearer $VAPI_API_KEY"

# トランスクリプトと録音付きで通話を取得
curl https://api.vapi.ai/call/{id} \
  -H "Authorization: Bearer $VAPI_API_KEY"
# レスポンスに含まれるもの: transcript、recordingUrl、summary、costBreakdown

# 通話を削除
curl -X DELETE https://api.vapi.ai/call/{id} \
  -H "Authorization: Bearer $VAPI_API_KEY"

通話レスポンス

通話作成が成功すると、以下が返されます:

{
  "id": "call-uuid",
  "orgId": "org-uuid",
  "type": "outboundPhoneCall",
  "status": "queued",
  "assistantId": "assistant-id",
  "phoneNumberId": "phone-number-id",
  "customer": {
    "number": "+11234567890"
  },
  "createdAt": "2025-01-15T10:00:00Z"
}

通話ステータス: queued → ringing → in-progress → ended

コンプライアンスに関する警告

同意なしに自動化された方法で電話番号にダイアルすることは、FCC 法違反です。自動通話キャンペーンを開始する前に、TCPA 同意要件を確認してください。

リファレンス

• Vapi Outbound Calls Docs
• Call Features
• Voicemail Detection

追加リソース

このスキルリポジトリには、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 を参照してください。