クイックスタート

最初のアウトバウンドタスクを最短経路で作成する手順を、約 5 分で紹介します。

1. トークンを取得

VoiceFox コンソール — VoiceFox コンソール → オープンプラットフォーム → API トークンにログインし、トークンを発行して安全に保管してください。

2. アシスタントを作成

POST /openapi/assistants を呼び出して音声アシスタントを作成します：

bash

curl -X POST 'https://openapi.voicefox.ai/openapi/assistants' \
  -H 'Authorization: Bearer <YOUR_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "My Assistant",
    "globalConfig": {
      "welcome": "Hello, this is VoiceFox.",
      "prompt": "You are a friendly customer follow-up agent…",
      "language": "zh"
    }
  }'

3. アウトバウンドタスクを作成

assistantId を取得したら、POST /openapi/tasks で番号を送信します：

bash

curl -X POST 'https://openapi.voicefox.ai/openapi/tasks' \
  -H 'Authorization: Bearer <YOUR_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Tuesday follow-up",
    "assistantId": 1001,
    "numbers": ["1380000xxxx"]
  }'

4. コールバックを受信

コンソールで Webhook URL を設定すると、通話終了、分析完了、タスク終了時に VoiceFox がサービスへイベントを POST します。詳細は Webhook ドキュメント。