Bland AI 開発ガイド：API、料金、チュートリアル（2026年）

Bland AI は実際の電話を発信・受信する AI エージェントの開発基盤です。電話回線、音声認識、音声合成、会話制御、ツール、転送、試験、分析をマネージドサービスにまとめています。

試作では番号と自然言語のタスクを1つの API に送れます。本番では可視化された Conversational Pathway に API やナレッジをつなぎ、一部を人へ転送し、webhook で結果をアプリへ返せます。

API の使い方、最初の通話、料金、モジュール型の音声基盤との違いを見ていきます。

Bland AI とは

開発者は目標、会話を制御する程度、業務との接続を定め、プラットフォームが電話会話の基盤を担います。用途には次があります。

• 見込み客の選別と追跡。
• 予約、確認、日程変更。
• 通常の問い合わせ対応。
• 電話による構造化情報の収集。
• 通話中の注文、口座、空き状況照会。
• 適切な担当部署への転送。
• アンケート、通知、発信キャンペーン。

会話だけでなく、ナレッジ検索、API、CRM 更新、予約、転送を実行できます。終了後に書き起こし、要約、変数、処理結果、長さなどを返します。

API 早見表

最初の通話

1. アカウントと API キー

開発画面で取得したキーは、本番の秘密情報と同様にサーバー側の環境変数に保存します。ブラウザーやモバイルコードには入れません。以下では BLAND_API_KEY を使います。

2. cURL で発信

Send Call APIは E.164 形式の番号とタスクを受けます。認証値はキーそのものです。

curl --request POST \
  --url https://us.api.bland.ai/v1/calls \
  --header "Authorization: $BLAND_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "phone_number": "+15551234567",
    "task": "Call the customer to confirm tomorrow’s appointment. If the time no longer works, collect two preferred alternatives. Never invent availability."
  }'

成功応答の例：

{
  "status": "success",
  "call_id": "9d404c1b-6a23-4426-953a-a52c392ff8f1"
}

要求は通話をキューへ入れるだけで、終了を待ちません。

3. TypeScript から発信

Node.js の標準 fetch でも同じ要求を送れます。

const response = await fetch("https://us.api.bland.ai/v1/calls", {
  method: "POST",
  headers: {
    Authorization: process.env.BLAND_API_KEY!,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    phone_number: "+15551234567",
    task: [
      "Confirm tomorrow's appointment.",
      "If the time does not work, collect two preferred alternatives.",
      "Do not claim a new time is booked until the scheduling tool confirms it.",
    ].join(" "),
  }),
});
 
if (!response.ok) {
  throw new Error(`Bland API request failed: ${response.status}`);
}
 
const call = (await response.json()) as {
  status: "success" | "error";
  call_id?: string;
  message?: string;
};
 
console.log(call.call_id);

信頼するサーバーでのみ実行してください。画面から送ると全訪問者へキーが公開されます。

4. 結果の取得

ID を通話詳細 APIへ渡すか、終了 webhook を使ってポーリングを避けます。

curl --request GET \
  --url https://us.api.bland.ai/v1/calls/CALL_ID \
  --header "Authorization: $BLAND_API_KEY"

状態、書き起こし、要約、長さ、録音、変数などが含まれます。必要な項目だけ保存し、本番データの収集前に保持期間を決めてください。

Task、Pathway、Persona の選択

最初は Task

通知、1項目の確認、短い質問一覧など、狭い成果に適します。人格描写より観測できる成果を中心に、相手と目的、利用情報、成功条件、推測・変更禁止事項、転送・再予約・終了条件、留守電と拒否への対応を明記します。if が増えたら Pathway へ移します。

制御するなら Pathways

Conversational Pathwaysはノード型エディターです。会話生成、固定文、変数収集、ナレッジ、webhook、転送、終了をノード化し、ラベル付き分岐で次の操作を限定します。

予約では既存日時の確認、新日時の希望、医院の質問、不明な発信者、担当者への引き継ぎ、連絡拒否を別経路にできます。長大なプロンプトよりレビューと試験が容易です。

実際の操作と知識

組み込み連携や HTTP ツールで空き照会、注文取得、CRM 更新、内部 API を実行できます。ナレッジは回答の資料、動的データは氏名、予約日時、口座状態、キャンペーン ID などの通話別文脈を供給します。

読み取りと書き込みは分離します。同じ予約でも照会と取り消しは権限が異なります。入力を検証し、書き込みを冪等にし、取り消せない操作には確認を求めます。

Webhook と電話運用

終了後・通話中のイベント

webhook で完了データを受け、webhook_events でキュー、通話、遅延、ツール、転送のイベントを購読します。

{
  "phone_number": "+15551234567",
  "pathway_id": "YOUR_PATHWAY_ID",
  "request_data": {
    "customer_name": "Jordan",
    "appointment_date": "September 20, 2026"
  },
  "metadata": {
    "customer_id": "cus_123",
    "campaign": "appointment-confirmation"
  },
  "webhook": "https://example.com/webhooks/bland"
}

終了 webhook ガイドは画面・通話単位の設定を説明しています。本番は署名検証、迅速な成功応答、重い処理の非同期化、再試行と重複への対応が必要です。

人への転送

単一番号、意図別部署、Pathway の転送ノードを使えます。通常の状態として理由と収集済み事実を渡し、担当者不在時も定義します。文脈のない転送は相手に最初から説明させ、失敗を指標から隠します。

着信と電話回線

画面で番号を取得・有効化し、エージェントを割り当てます。番号別に設定と webhook を変えられ、既存 Twilio や企業向け SIP も接続できます。番号供給、費用、地域、転送、規制は異なるため、市場ごとに全経路を検証します。

一括発信

Batch Callsは CSV または API で開始し、相手別の氏名、予約、状態を同じ Pathway に渡します。少人数から始め、応答、完了、拒否、転送、費用を測って並列数を増やします。量の増加は既存の品質や法令対応をそのまま拡大します。

試験と監視

実際の相手は遮る、黙る、情報を一部だけ伝える、綴りを読む、留守電になる、話題を変える、人を要求するなど、台本通りには動きません。

• Testbed： 実通話データでノードを改善。
• Scenarios： 相手の人物像や状況を模擬。
• Standards： 既知のやり取りを回帰試験化。
• Evals： 設定した品質基準で採点。
• Guard Rails： 実時間の条件違反で操作を発動。
• Alerts： 指標や独自条件のしきい値で通知。

モデルは確率的なので重要な試験は繰り返します。正常系に加え、無音、割り込み、雑音、アクセント、数値、固有名詞、ツール遅延、担当者不在、明示的拒否を含めます。Guard Rails だけで権限管理、同意、代表的監視、法的確認は代替できません。

CLI と MCP

CLIは通話、Pathway、番号、ログ、ローカル webhook 転送、検証、試験、昇格に対応し、画面だけの編集より変更をレビュー・再現しやすくします。

MCPで Codex、Cursor、Claude Code、VS Code などを接続し、構造化ツールでリソースを操作できます。これは開発・運用の窓口で、電話の相手と話すリアルタイムモデルではありません。

2026年の料金

2026年9月19日の確認価格です。

Start は初期クレジット2つと着信番号を含みますが、無制限無料ではありません。接続は秒単位で、LLM・認識・合成を含み、回線と番号は別です。

monthly cost ≈ platform fee
             + connected minutes × talk-time rate
             + transfer minutes × transfer rate
             + carrier, phone-number, and optional feature charges

分単価の差だけなら Build の基本料を相殺するのは月約14,950接続分です。並列数や日次制限のため早く必要になる場合もあります。応答率、平均長、転送率、失敗試行を含めて予測してください。

内蔵回線は実費、顧客 Twilio や企業 SIP も使えます。回線持ち込みでは Bland の転送料はありませんが、回線料と AI 利用料は残ります。企業版には専用基盤、オンプレミス・VPC、SSO、データ所在、BAA、高い上限、専任エンジニアの選択肢があります。公式価格を確認してください。

別商品の Agent Phone Plan

月 $29.99、米国番号1つで米国・カナダの音声と SMS を使う自律エージェント1体向けプランもあります。公正利用制限があり、同時通話は1件です。助手専用回線向けで、大量コンタクトセンターの価格ではありません。

Vapi、Retell、自社構築との比較

本番化の速度、予測しやすい AI 費用、統一操作面を重視するなら Bland、可搬性や細部の制御が中心ならモジュール型が候補です。

長所と制限

長所

• 同じ API で発着信でき、試作が速い。
• Pathways で長いプロンプトより制御しやすい。
• ツール、知識、転送、一括発信、webhook を統合。
• 試験、評価、Guard Rails、通知が運用を支援。
• コード中心の CLI と MCP。
• 複雑な回線向け Twilio、SIP、企業配置。
• LLM、音声認識、合成を接続時間に一括計上。

制限

• 固有の Pathways・プロンプトで移行作業が増える。
• 各モデル・音声会社の交換自由度は低い。
• 表示単価に回線、番号、転送、追加機能すべては含まれない。
• 一部統制や高度な経路は企業版限定。
• 実際の相手、言語、道具、回線で品質と遅延を試す必要がある。

適した場面

電話が中心で、発着信、実時間データ、操作、分岐、人への引き継ぎが必要なら候補です。運用担当の視覚的編集と開発者の API・CLI を両立できます。少量の単純通知には過剰な場合があり、モデル・音声・オープンソース実行環境を完全に制御したい構成にも合わない場合があります。

本番前の確認

1. 測れる目的： 確認、選別、予約、収集、振り分け、解決を具体化。
2. 権限： 必要なデータと操作だけを付与。
3. 引き継ぎ： 文脈、時間外対応、転送失敗を定義・計測。
4. 同意と拒否： 開示、録音、時間帯、発信禁止を地域ごとに専門家へ確認。
5. 安全な連携： サーバーの秘密管理、署名、認証、冪等性。
6. 難しい会話： 無音、遮り、アクセント、留守電、雑音、道具の故障、想定外要求。
7. 全体指標： 応答、完了、移管、拒否、遅延、再試行、成功1件の総費用。
8. 段階導入： 内部、小さな代表集団、データを確認して拡張。

よくある質問

API はあるか

はい。通話、Pathways、番号、ツール、知識、一括処理、試験、ログを REST で操作します。発信は POST /v1/calls です。

キーはどこか

開発者画面から取得し、サーバーに保存して Authorization に直接設定します。Bearer は不要です。

着信できるか

はい。番号を有効化・取り込み、エージェントと Pathway、プロンプト、webhook を設定します。発信も同じ基盤から行います。

費用は

Start は基本料なしで接続1分 $0.14、Build は月 $299 と1分 $0.12。転送、回線、番号、オプションが加算され、企業版は個別です。

無料か

開始は無料でクレジットがありますが、継続的な接続通話は従量制です。

HIPAA 対応か

Bland は BAA 締結の企業版で対応可能としています。製品だけで適法にはならず、データ、アクセス、保持、録音、運用を法務・安全担当と検討します。

Codex に接続できるか

はい。Codex、Cursor、Claude Code、VS Code などの MCP 手順があり、開発エージェントはリソースを、音声エージェントは実通話を担当します。

まとめ

会話を定義し、業務操作と番号を接続して API を呼ぶことで、複雑な音声基盤を扱えます。Task は試作、Pathways、ツール、webhook、試験、転送は本番の制御を支援します。

速度、統合ツール、単純な AI 課金を得る代わりに、Bland の方式、価格、重要経路への依存を受け入れます。その条件が合えば、音声基盤をすべて自社所有せず本番の電話エージェントを作れます。