Your AI Connector Docs

SMSプロバイダー（Twilioの持ち込み）

このページでは、WhatsApp Business APIで使用するTwilioアカウントを管理します。デフォルトでは、WhatsApp Business APIはプラットフォームが管理するTwilioアカウントで実行されるため、Twilioを意識したり、自分でTwilioに登録したりする必要はありません。独自のAnthropicキー（BYOK）を接続している場合、管理対象のTwilio経由のWhatsAppメッセージは、送受信ともに1通あたり0.05クレジットかかります。その他のすべてのアカウントでは、これらの配信コストはAIクレジット料金に含まれているため、メッセージごとの別途料金は発生しません。（WhatsApp独自のメッセージ料金は2026年10月1日に変更されます。詳細はWhatsAppのコストと2026年10月の変更を参照してください。）これは、WhatsApp Business APIを独自のTwilioアカウントで実行したい場合にのみ関連する設定です。

SMSは常に「Bring Your Own Twilio（独自のTwilioアカウントを使用）」となります。 SMSの規制（A2P 10DLC、ブランド登録、送信者IDの承認）は貴社名義で申請する必要があるため、プラットフォームでは管理型のSMS番号を提供していません。SMSの設定は、「設定」→「チャネル」にある「SMS via Twilio」カードを使用して個別に行ってください（Android電話のSMSゲートウェイオプションもあります）。このページ（「Twilioアカウント」カード）はWhatsApp Business APIアカウントを制御するものであり、SMS番号には影響しません。

WhatsApp Business APIを独自のTwilioに切り替える理由

ほとんどのユーザーには必要ありません。管理されたアカウントの方がシンプルです：

  • WhatsApp番号のレンタル、テンプレートの提出、送信者の登録、番号の健全性管理はすべて自動的に行われます。ここでレンタルする番号は月額最低50クレジットで、その料金にはWhatsApp接続費用が含まれています。電話番号を参照してください。
  • Twilioからの別途請求書はありません。独自のAnthropicキー（BYOK）を接続している場合、管理対象のTwilio経由のWhatsAppメッセージは、送受信ともに1通あたり0.05クレジットかかります。その他のすべてのアカウントでは、これらの配信コストはAIクレジット料金に含まれているため、メッセージごとの別途料金は発生しません。2026年10月1日に予定されているWhatsAppの料金変更については、WhatsAppのコストと2026年10月の変更を参照してください。
  • 配信の問題については、サポートが直接デバッグを支援します。

以下のような場合は、独自のTwilioアカウントを持ち込むことを検討してください：

  • 承認済みのWhatsAppテンプレートや、継続して使用したい「ウォームアップ済み」の番号を持つ既存のTwilioアカウントをすでにお持ちの場合。
  • 貴社の調達またはコンプライアンス上の理由により、Twilioに直接支払う必要がある場合。
  • キャリアレベルの利用状況や価格設定を完全に把握したい場合。

ウォームアップ済みの番号を維持するには、2つのステップが必要です。 アカウントの切り替え（下記参照）は、送信に使用するTwilioアカウントを変更するだけです。既存のWhatsApp番号は、接続するまでチャネルとして表示されません。詳しくはすでに所有しているWhatsApp番号を接続するを参照してください。必ずこの順序で実行してください。

切り替え方法

アクセス方法: 「設定」→「チャネル」グループ→「チャネル」の順に進み、「Twilioアカウント」カードを探します。

表示される内容は、現在の設定状況によって異なります：

管理アカウント（デフォルト）を使用している場合

Twilioアカウントカードには、簡単な説明と管理ボタンが表示されます。これをクリックすると、独自のTwilioアカウントに切り替えるフォームが開き、TwilioのAccount SIDとAuth Tokenの入力を求められます。その際、破壊的アクションに関する警告がダイアログ内に直接表示されます。

確定する前に、警告をよくお読みください。この切り替えは破壊的な操作です：

  • プラットフォームを通じて購入したすべての番号は永久に解放されます。 番号を継続して使用したい場合は、管理アカウントのままにする（切り替えない）か、事前に独自のTwilioアカウントで購入または移行してください。
  • 承認済みのWhatsAppテンプレートは移行されません。 テンプレートは送信者を所有するWhatsApp Businessアカウントに紐付いているため、独自のアカウントで再提出し、再承認を待つ必要があります。
  • 既存のチャットやメッセージ履歴は引き続き表示されますが、解放された番号への新しい返信は失敗します（番号が存在しなくなるため）。
  • 後で元に戻すことは可能ですが、その際は番号もテンプレートもない新しい管理アカウントが作成されます。以前のデータは復元されません。

Account SIDとAuth Tokenの確認方法：Twilioコンソール（console.twilio.com）にログインしてください。どちらもメインダッシュボードの「Account Info」パネルに表示されています。Account SIDは AC で始まり、34文字の長さです。

両方の値を入力して確定すると、システムは以下の処理を行います。

  1. 認証情報が有効であることを確認します。
  2. 管理下の各電話番号をTwilioから解放します。
  3. 管理用サブアカウントを閉じます。
  4. 認証情報を保存し、今後のすべてのWhatsApp送信で貴社のアカウントが使用されるようにします。個別に接続されている「SMS via Twilio」番号は独立して保存されており、この切り替えによって解放や変更が行われることはありません。

複数の番号がある場合、これには数秒から数分かかることがあります。

すでに独自のTwilioアカウントを使用している場合

このカードには接続中のアカウントが表示され、管理設定に戻すことも可能です。

管理セットアップに戻すと、新しい管理サブアカウントがプロビジョニングされます。上記のとおり、以前使用していた番号やテンプレートは復元されず、ゼロからのスタートとなります。

すでに所有しているWhatsApp番号を接続する

アカウントを独自のTwilioに切り替えると、WhatsApp Business APIカードのConnect WhatsAppボタンの機能が変わります。管理オプションがThrough your Twilio account（あなたのTwilioアカウント経由）となり、接続したTwilioアカウント内のWhatsApp送信者が紐付けられます。また、管理番号の購入は提供されなくなります。これは意図的な仕様です。番号を購入したりMetaの登録を実行したりすると、あなたのアカウントとは別にプラットフォーム管理のTwilioアカウントが作成されてしまい、メッセージの送信元アカウントと番号の管理アカウントが分かれてしまうためです。

開始する前に

番号は、お客様自身のTwilioアカウント内で、すでにWhatsApp送信者として機能している必要があります。

  • TwilioでWhatsApp送信者として登録され、お客様自身のWhatsApp Businessアカウントに紐付いていること。
  • Twilio上でその送信者がオンラインと表示されていること。

この画面では何も登録されません。送信者の作成、Metaとの通信、番号の承認申請などは行われず、すでに機能している送信者を接続するだけです。まだお持ちでない場合は、先にTwilioでWhatsApp送信者のセットアップを行ってください。

手順

  1. 設定 → チャネルグループ → チャネルに移動します。
  2. WhatsApp Business APIカードで、送信者を接続をクリックします。
  3. Twilioの送信者プロファイルに表示されている通りに、国際形式（例: +31612345678）でWhatsApp番号を入力します。
  4. 必要に応じてラベル（アプリ内で使用する番号の名前）を付けます。空欄のままにすると、Twilioの送信者プロファイルの名前が使用されます。
  5. 送信者を接続をクリックします。

アカウントSIDや認証トークンを再入力する必要はありません。アカウント切り替え時にすでに取得済みです。

内部で行われる処理

  1. お客様のTwilioアカウントでその番号の送信者を検索し、Twilioでオンラインになっているかを確認します。
  2. アカウントにメッセージングサービスが存在することを確認し、そのインバウンドWebhookを当社に向けます（まだお持ちでない場合は、アプリ名で作成します）。これはテンプレート送信を機能させるためにも必要です。
  3. 送信者をそのメッセージングサービスにリンクします。
  4. 送信者自身のWebhookを当社に向け、受信メッセージがこちらに届くようにします。
  5. 番号が番号リストに Your Twilio (BYO) と表示され、キャンペーンやエージェントに割り当て可能な状態になります。

承認済みのテンプレートは、お客様のアカウント内の元の場所にそのまま残ります。再申請やリリースは一切行われません。

料金

この方法で接続した番号に月額の維持費はかかりません。番号料金とメッセージごとの料金は、Twilioに直接お支払いいただきます。AI返信には通常通りクレジットが消費されます。

うまくいかない場合

  • 「No WhatsApp sender for … exists in your Twilio account」 — その番号がTwilioアカウントでWhatsApp送信者として登録されていないか、入力形式が異なります。Twilioコンソールで正確な送信者IDを確認し、国際形式で再入力してください。
  • 「The WhatsApp sender … is not online in Twilio」 — Twilio側からの理由がメッセージに含まれています。まずTwilio側で修正してください。Twilioでオフラインになっている送信者を接続しても、後でエラーが発生し、通知されません。
  • 「… is already connected to another account」 — その番号はすでに別の当方アカウントに接続されています。まずそちらのアカウントから切断してください。
  • 「This account is still on the managed Twilio account」 — 上記の切り替えを先に行ってください。
  • 「we could not update its webhook in Twilio」 — 番号は接続されており送信は可能ですが、送信者は以前設定されていたWebhookを指したままになっています。Twilioコンソールでその送信者のWebhookをクリアし、受信メッセージが当方に届くようにしてください。

制限事項

  • プロバイダーの切り替えは、最大で24時間に1回までです。これは、繰り返しの切り替えによってTwilio APIのコストやレート制限が発生するのを防ぐためです。
  • SMS送信はこの設定の影響を一切受けません。すでに「SMS via Twilio」カード経由で独自のTwilioを接続している場合、それは別の接続であり、ここでの操作に関係なくそのまま維持されます。

問題が発生した場合は？

  • “Could not authenticate with the provided Twilio credentials” — SID（ACで始まり、34文字）と認証トークンを再確認してください。どちらも大文字と小文字を区別します。
  • “Account is not active” — 使用しようとしているTwilioアカウントが停止または閉鎖されています。有効なアカウントを使用してください。
  • “Please wait Xh before switching again” — 24時間のクールダウン期間中です。時間が経過するまでお待ちください。
  • Partial migration (some numbers released, some not) — 切り替えを再実行してください。システムは冪等（べきとう）であるため、中断した箇所から再開し、管理対象サブアカウントに残っている番号の解放を完了します。

切り替え後に問題が発生した場合（送信メッセージが送れない、テンプレートが表示されないなど）は、Account SID（Auth Tokenは絶対に含めないでください）を添えてサポートまでお問い合わせください。

ヘルプが必要ですか？

If you’re not sure whether switching is right for you, or run into trouble, contact support and we can help you decide.