create-phone-number

Vapi 電話番号の設定

デフォルトでは、ペイロードまたは実装計画を提示してください。ユーザーが本番環境での変更を明示的に依頼した場合に限り、番号のプロビジョニング、インポート、ルーティング、解放を行ってください。プロビジョニングやその他の費用が発生する可能性のある操作の直前に、最終確認を明示的に求めてください。

セキュリティと情報源に関するルール

• チャットでキャリアのパスワード、認証トークン、API キー、API シークレット、秘密鍵を尋ねてはいけません。
• プロバイダーからインポートする際は、現在の公開スキーマで対応している場合、既存の Vapi credentialId を使用してください。必須の認証情報が存在しない場合は、処理を中止し、API の前提条件を伝えてください。
• 公開 API がキャリアのシークレットを直接要求し、認証情報を使う代替手段がない場合は、ローカル環境変数から取得してください。画面に表示したり、ペイロードファイルに書き込んだり、リクエスト本文をログに記録したりしてはいけません。
• プロバイダーのフィールドは、最新の電話番号作成 APIまたは公開 OpenAPI スキーマで確認してください。
• 電話番号、SIP レルム、認証情報、リソース ID、エリアコードの利用可否、ルーティング先を決して捏造してはいけません。

手順

1. 実行モードを判断します。

   • ユーザーが下書きを求めている場合、またはライブでの変更を明確に許可していない場合は、ペイロードまたは手順を返します。
   • ライブでのリクエストの場合は、値を表示せずに VAPI_API_KEY が設定されていることを確認します。

2. 通信経路を選択します。

   • 一般的な電話番号について技術的な説明を伴わないリクエストの場合は、文書化されている Vapi ホスト型の米国 PSTN 経路を優先します。
   • SIP は、ユーザーが明示的に要求した場合にのみ使用します。ユーザーまたは最新の公開 API ドキュメントから、サポート対象の SIP URI を正確に取得する必要があります。取得できない場合は停止し、前提条件が不足していることを伝えます。地域別のレルムを推測して作成してはいけません。
   • キャリアのインポートは、ユーザーが電話番号を所有しており、必要な安全な認証情報の経路が利用できる場合にのみ使用します。

3. 変更前にルーティング先を解決します。

   • 公開エンドポイントを通じてアシスタントとスカッドを一覧表示または取得します。指定された名前を一つのリソースに照合します。
   • 候補となるリソースが複数ある場合は、ユーザーに選択を求めます。ID を推測してはいけません。
   • ルーティング先には、単一の assistantId または単一の squadId を指定します。既存のルートを変更するときは、競合する宛先フィールドを消去します。

4. インベントリを安全に確認します。

   • 重複したプロビジョニングを避けるため、GET /phone-number で既存の電話番号を確認します。
   • 現行の公開 OpenAPI では numberDesiredAreaCode が受け付けられますが、公開されている利用可能な市外局番の一覧取得エンドポイントはありません。希望する米国の3桁の市外局番をユーザーから受け付けますが、割り当てが保証されないことを説明します。
   • 利用可能かどうかのテスト目的で電話番号を購入してはいけません。一度のプロビジョニング応答から、世界全体で利用できないと推測してはいけません。

5. 確認して実行します。

   • プロバイダー、市外局番または正確な所有電話番号、ルーティング先、キャリア料金または使用料金が発生する可能性があるかどうかを提示します。
   • POST /phone-number または料金が発生する可能性のある変更操作を行う直前に、明示的な確認を得ます。
   • 応答の id、プロバイダー、電話番号または SIP URI、存在する場合はステータス、解決されたルートを検証します。

6. 設定を壊さずに更新します。

   • まず GET /phone-number/{id} を実行します。
   • プロバイダー固有の更新 DTO を作成します。要求された書き込み可能なフィールドのみを変更し、公開スキーマで必要な場合は、省略または正確に引き継ぐことで、現在のプロバイダー、フック、サーバー、フォールバック先、プロバイダー固有の設定を保持します。
   • id、タイムスタンプ、組織のメタデータなど、応答専用フィールドを送信してはいけません。
   • 電話番号を再取得し、要求されたルートまたは設定を検証します。

7. 失敗を正確に処理します。

   • 400：拒否されたフィールドまたは受け付けられなかったリクエストを報告します。文書化された形式の誤りを修正したうえで、再試行は最大1回までとします。
   • 401／403：Vapi の認証または権限の問題として処理を停止します。
   • 404：見つからない電話番号、アシスタント、スカッド、または認証情報を報告します。
   • 5xx：Vapi サービスの障害を報告し、成功したと主張してはいけません。
   • キャリア側の所有権、認証情報、プロビジョニング、通信経路に関する障害と、Vapi のルーティング設定の問題を区別します。

Vapi の無料電話番号の制限

Vapi ホスト型の無料電話番号は米国内での使用向けで、1アカウントにつき5件までです。最初の無料電話番号は、支払い方法を登録せずにリクエストできます。追加の無料電話番号には支払い方法の登録が必要ですが、電話番号自体は無料です。

Vapi の無料電話番号で発信できるのは、米国の +1 宛てのみです。国際通話には対応していません。海外で使用する場合は、インポートしたプロバイダーの電話番号、またはサポート対象の SIP／キャリア経路を使用します。無料電話番号を、制限のない本番用電話サービスとして説明してはいけません。

ペイロードのみの例

このテンプレートでは、何もプロビジョニングされません。

{
  "provider": "vapi",
  "numberDesiredAreaCode": "<confirmed-three-digit-area-code>",
  "assistantId": "<verified-assistant-id>",
  "name": "Main Support Line"
}

Vapi ホスト型、Twilio、Vonage、Telnyx、BYO キャリア、ルーティングの例については、プロバイダー API の手順をお読みください。ユーザーが TypeScript、Python、または cURL の実装コードを求めている場合は、電話番号 API の例をお読みください。プレースホルダーをライブリクエストに含めてはいけません。

公開ソース

• 電話発信 と 電話クイックスタート
• 電話番号作成 API
• 無料の Vapi 電話番号
• Twilio の番号をインポート