Quickchat AI Agent を WhatsApp Business に接続します。本ガイドでは前提条件、セットアップ手順、WhatsApp メッセージングの本番運用までを解説します。
このガイドでは、Quickchat AI Agent を WhatsApp に連携する方法を紹介します。手順は 2 つのシンプルなステップ で構成されています。
- ステップ 0 – 事前準備
- ステップ 1 – WhatsAppを接続
連携で問題が発生した場合は、トラブルシューティング & FAQ を参照するか、お問い合わせ ください。
任意の設定ツール
Section titled “任意の設定ツール”-
WhatsApp設定の前提条件を確認する. 申告された電話番号とプロバイダーの情報を、文書化された要件と照合します。WhatsAppアカウントへのアクセスや接続は行いません。
-
WhatsAppのサービス時間枠を確認する. タイムゾーンのオフセットを含む受信時刻と返信時刻から24時間の枠を確認します。テンプレート、同意、アカウント権限の検証やメッセージ送信は行いません。
-
使用コストを見積もる. Quickchat AIモデルのクレジットと、提供された料金項目の合計を別々に計算します。プロバイダー料金の取得、クレジットと金額の合算、アカウント確認は行いません。
フォームは英語です。
ビデオを見る
Section titled “ビデオを見る”ステップ 0 – 事前準備
Section titled “ステップ 0 – 事前準備”A. ビジネス用電話番号
Section titled “A. ビジネス用電話番号”WhatsApp で使用する 電話番号 を決めます。詳細は WhatsApp ドキュメント または以下の FAQ を参照してください。
WhatsApp Cloud API で使用できる番号は?
- SMS または音声通話で認証できる 専用のビジネス番号 が必要です。
- 有効な番号で、あなたが所有し、国番号と市外局番を持つ必要があります。
WhatsApp Messenger で使用中の番号は使えますか?
- いいえ。 通話や SMS では利用できますが、WhatsApp Messenger では使用できません。
- すでに Messenger で使っている場合は、先に削除 してください。削除前にチャット履歴をバックアップすることを忘れないでください。
- 停止済みの番号は、登録前に解除しておく必要があります。
WhatsApp Business アプリで使用中の番号は?
- Quickchat AI の現在の接続フローでは、既存の WhatsApp Business アプリ の番号で Coexistence を利用できる接続方法は確認されていません。対応する連携での Coexistence の仕組みは、Meta の Business アプリのオンボーディングガイド で説明されています。
- 既存の番号、WhatsApp Business アプリのアカウント、チャット履歴を維持する必要がある場合は、先に support@quickchat.ai へメールでお問い合わせください。トラブルシューティングのために、WhatsApp Business アプリのアカウントを削除したり、接続を解除したり、番号を移行したりしないでください。
新しい番号を使えますか?
- はい。 現在の番号を使いたくない場合は、新しい番号(物理 SIM または仮想番号)を取得してください。Hushed などで購入できます。
B. 会社情報
Section titled “B. 会社情報”Meta の連携フローで入力するため、次の情報を準備してください。
- 会社名
- 会社の Web サイト
- 業種カテゴリ
- 会社の説明
一部の項目は任意に見えても、正確に入力してください。不足や誤りがあると承認が遅れたり制限される可能性があります。
ステップ 1 – WhatsAppを接続
Section titled “ステップ 1 – WhatsAppを接続”Quickchat AI App → 外部アプリ → WhatsApp を開き、WhatsAppを接続 ボタンをクリックして Meta のポップアップに従います。
ChatGPT、Claude、その他の接続済み AI アプリから始めることもできます。この Agent を WhatsApp に接続するためのリンクを依頼してください。リンクは 10 分間有効で、リンクをリクエストした Quickchat アカウントで 1 回だけ使用できます。そのアカウントにサインインしているブラウザでリンクを開き、Meta の設定手順に従って、Quickchat が再び開いた際にアカウントや電話番号の選択が表示された場合は選択を完了してください。その後、AI アプリに設定の確認を依頼し、実際に WhatsApp メッセージを送って AI の返信が届くことを確認してください。複数の番号を接続した場合は、有効な番号をそれぞれテストしてください。Meta へのアクセスはブラウザで承認し、チャットでトークンを共有する必要はありません。
- Meta(Facebook)アカウントでログインします。
- Quickchat AI と共有する権限(WhatsApp Business アカウントへのアクセスと Business ポートフォリオへのアクセス)を確認し、続行します。
- Business Portfolio、Business Name、Business Website、国など、正確なビジネス情報を入力します。
- WhatsApp Business アカウントを作成または選択します。
- WhatsApp Business の表示名とカテゴリを選択します。
- ビジネス番号 を追加し、SMS または音声で認証します。
- Confirm をクリックして Quickchat AI に必要なアクセス権を付与します。
- Meta からセットアップ完了が表示されたら Finish をクリックします。ポップアップに Quickchat AI から WhatsApp アカウント接続の確認が表示され、ウィンドウが自動で閉じます。
Meta から Quickchat AI に複数のアカウントへのアクセス権が付与された場合、すぐには接続されず、WhatsApp パネルに WhatsApp Business アカウントを選択 と表示されます。AI Agent が応答に使用するアカウントを選択し、このアカウントを使用 をクリックしてください。再接続の場合、選択を確定するまで現在の WhatsApp 設定は変更されません。
Quickchat AI App に戻ると、ご自身のビジネス番号でメッセージのやり取りが成功したことを確認できるまで、WhatsApp パネルに 設定を完了 と表示されます。約 30 秒経ってもパネルが更新されない場合は、更新アイコンをクリックしてください。
Meta への接続とメッセージの受信は、設定の一部です。パネルには、有効な番号ごとに次の手順が表示されます。
- 最初のメッセージを待っています:別の電話から表示された番号に WhatsApp メッセージを送り、更新 をクリックしてください。顧客が利用するビジネス番号に送信していることを確認してください。
- AIの返信の配信を待っています:Quickchat はメッセージを受信しましたが、WhatsApp は AI の返信の配信をまだ確認していません。別の電話に返信が届いたか確認してください。届かない場合は、AI クレジットとパネルの警告を確認し、新しいテストメッセージを送信してください。
- AIの返信が配信されました:このビジネス番号で受信したメッセージに対する AI の返信が配信されたことを、WhatsApp が確認しました。
- 検証に対応が必要です:接続に関する警告を解消し、使用する番号を有効にしたまま、新しいテストメッセージを送信してください。
- 表示名:パネル下部に表示される各番号には、Meta での表示名のステータス(承認済み、審査中、却下、期限切れ、表示名なし)が付きます。審査中の場合は対応不要で、通常は数日で完了します。却下・期限切れ・未申請の場合は、WhatsApp Manager で新しい表示名を申請してください。
- Meta のテスト番号:Meta が提供する +1 555 番号やサンドボックス番号では、ビジネス番号の稼働確認は完了しません。WhatsApp Manager でご自身の番号を追加し、Quickchat で有効にしてから、その番号をテストしてください。
有効なすべてのビジネス番号でメッセージのやり取りが確認され、接続チェックにも問題がなければ、パネルに 稼働中 と表示されます。複数のビジネス番号を有効にした場合は、それぞれをテストしてください。テスト番号でのやり取り、テンプレートの送信、メッセージ上限に達したことを知らせる通知だけでは、この確認は完了しません。
テスト中は連携を有効にしたままにしてください。別の電話から使用する各ビジネス番号にメッセージを送り、AI の返信が届くことを確認して 更新 をクリックします。会話は Quickchat AI App の受信トレイにも表示されます。既存の接続でも、配信を確認するために新しいテストのやり取りが必要になる場合があります。この手順を完了する間も、メッセージの受信と返信は継続できます。
Meta のオンボーディングで未完了の手順がある場合は、WhatsApp Manager の Setup guidance で完了してください。Meta の設定手順が未完了の場合、Quickchat AI はアカウント所有者にリマインダーメールも送信します。
Troubleshooting & FAQs
Section titled “Troubleshooting & FAQs”WhatsApp Business API の料金体系は?
- ユーザーからの問い合わせ(インバウンド)に対する返信は、WhatsApp 上で サービスメッセージ として扱われ、有人または会話型 AI によるサポートが可能です。
- ユーザーが企業へメッセージを送ると 24 時間のカスタマーサービスウィンドウ が開き、その間はサービスメッセージで 無料 返信できます。このウィンドウは ユーザーメッセージごとにリセット されます。
- 24 時間を過ぎた場合 は、承認済みテンプレート(マーケティング、ユーティリティ、認証など)を使用し、WhatsApp Business Platform メッセージ料金 に従って課金されます。
- 会話は Meta により カテゴリ分けと課金 が行われます。テンプレート/企業発信メッセージ用に、WhatsApp Business アカウントに 有効な支払い方法 を設定してください。
「WhatsAppを接続」ボタンが機能しない、Meta ポップアップが表示されない。
- ブラウザがポップアップをブロックした場合は、Quickchat AI App のポップアップを許可して 再試行 をクリックしてください。このタブで Meta に進む をクリックすると、ポップアップを使わずに同じセットアップを完了することもできます。
Quickchat は WhatsApp の接続を確認できませんでした
Quickchat は、Meta のウィンドウから結果が返らず、接続を引き続き確認できない場合に、このリカバリーメッセージを表示します。Meta 側で変更が行われていないことを保証するものではありません。
- WhatsApp Business アカウントを所有する Meta Business の管理者であることを確認してください。管理者でない場合は、管理者に Facebook ログインから接続してもらってください。
- 再試行 をクリックしてください。ブロッカーが Meta のウィンドウを妨げる場合は、拡張機能を一時停止したプライベートウィンドウを使用するか、このタブで Meta に進む をクリックしてください。
- 番号が WhatsApp Messenger で有効な場合は、先に Messenger から削除するか、別の番号を使用してください。WhatsApp Business アプリで有効な場合は、ここで操作を中断し、先に support@quickchat.ai へメールでお問い合わせください。Quickchat AI の現在の接続フローでは、Coexistence を利用できる接続方法は確認されていません。このメッセージを解消するために、WhatsApp Business アプリのアカウントを削除したり、接続を解除したり、番号を移行したりしないでください。
- WhatsApp Business アカウントが Aircall、Twilio、360dialog、MessageBird、または別のプロバイダーを使用している場合は、Meta Business 設定で Quickchat AI をパートナーとして追加してください。
- Meta Business 設定を開き、アカウント → WhatsApp アカウント に移動します。
- WhatsApp Business アカウントを選択して パートナー を開き、パートナーを追加 をクリックします。
- Quickchat AI の Business ID
270696274483463を入力します。 - WhatsApp アカウントを管理 を許可し、Quickchat AI に戻ってステータスを更新します。
Meta が同じアカウントで両方のパートナーを許可しない場合にのみ、他のプロバイダーとの接続を解除してください。判断に迷う場合は、現在利用中のメッセージプロバイダーとの接続を解除する前にサポートへお問い合わせください。
番号の認証に失敗する。
- 番号が SMS または音声通話を受信できることを確認してください。
- 一般的な Ineligible メッセージや This number can’t be shared with this app というツールチップだけでは、原因や Meta の Coexistence の要件を満たしているかどうかは判断できません。表示されたメッセージの正確な内容と、どの手順で表示されたかを添えて、support@quickchat.ai へメールでお問い合わせください。
- 番号を WhatsApp Business アプリ で使用しており、そのアカウントと履歴を維持する必要がある場合は、先にサポートへお問い合わせください。エラーを解消するために、アカウントを削除したり、接続を解除したり、番号を移行したりしないでください。
間違ったアカウントを接続してしまった。
- 再接続 では、すでに接続されているアカウントがそのまま維持されます。AI Agent を別の WhatsApp Business アカウントに切り替えるには、WhatsApp パネルで 切断 をクリックし、もう一度 WhatsAppを接続 をクリックして、Meta のウィンドウで正しい Meta Business アカウントと WhatsApp アカウントを選択してください。
接続する WhatsApp Business アカウントを特定できませんでした
- Meta のログインに電話番号付きの WhatsApp Business アカウントが複数あり、Quickchat はどれを接続すべきか特定できませんでした。接続したい番号を添えて support@quickchat.ai までご連絡ください。設定はこちらで完了します。
Quickchat AI の受信トレイにメッセージが表示されない。
- ポップアップで最終確認メッセージ “WhatsApp account connected!” が表示されたか確認してください。
- 正しい WhatsApp アカウント をリンクし、適切な AI Agent を選択しているか確認します。
- 最初のメッセージを待っています カードには、AI Agent が応答する番号が表示されています。その番号に送信したこと、そしてその番号がパネルで有効になっていることを確認してから、更新 をクリックしてください。
- ユーザーからの最後のメッセージから 24 時間以上 経過して送信する場合は、承認済みテンプレート を使用し、WhatsApp Manager に 支払い方法 が登録されているか確認してください。
AI の WhatsApp 返信が送信できない。
AI の返信を配信できない場合、Quickchat AI は 外部アプリ の WhatsApp パネルに “WhatsApp の返信が送信できません” アラートを表示し、ダッシュボードにも通知を表示します。よくある原因と対処は次のとおりです。
- Meta のテスト番号の表示名が未承認: Meta から割り当てられた +1 555 番号は、表示名が承認されるまで Meta が返信を保留します。パネルの表示名アラートが赤くなり、対象の番号が示されます。審査の完了(通常は数日)を待つか、却下された場合は WhatsApp Manager で新しい表示名を申請してから、テストメッセージを送信してください。ご自身の番号で審査中の表示名だけでは返信はブロックされません。パネルには参考情報として表示されます。
- 接続の期限切れまたは取り消し: WhatsApp 接続が有効ではなくなっています。WhatsApp パネルを開き、再接続 をクリックして返信の送信を再開してください。
- 番号の制限: Meta があなたの WhatsApp 番号を制限しました(品質またはポリシー)。送信を復旧するには、WhatsApp Manager でステータスを確認してください。
- ビジネスアカウントのロック(エラー 131031): Meta が WhatsApp Business アカウントからの返信をブロックしています。受信トレイの配信エラーと WhatsApp パネルに制限の説明が表示されます。Business Support Home を開き、WhatsApp アカウントと該当する違反を選択して審査をリクエストしてください。Meta はアカウントのロックをこの審査を通じてのみ解除します。Quickchat を再接続しても、この制限は解除されません。
その他のアラートは、返信が再び正常に送信されると自動的に解除されます。Meta は返信を受け付けた後に配信を失敗させることがあるため、アカウントのロックに関するアラートは、実際の訪問者から届いた新しいメッセージに対する AI の返信が完全に配信されるまで表示されたままになります。有効な番号が Meta のテスト番号(+1 555)だけの場合は、次の AI の返信が正常に送信されると解除されます。Support AI は、記録されている最近のアカウントロックによる配信失敗について説明することもできます。ただし、過去の記録だけでは、アカウントが現在もロックされているとは判断できません。
テンプレート/企業発信メッセージが失敗する。
- Message Template が 承認済み で、WhatsApp Manager に有効な 支払い方法 が設定されているか確認してください。
- 新規送信者には メッセージ上限 があり、品質と検証状況によって拡張されます。上限に達した場合は、Meta の Messaging Limits ガイドを参照してください。
- 配信が制限されている場合は、WhatsApp Manager で メッセージ上限 と 品質レーティング を確認してください。
自分専用の WhatsApp リンクや「WhatsApp でチャット」ボタンを作成するには?
- この WhatsApp のチュートリアル をご覧ください。
- または、WhatsApp ブランドボタンデザイン をダウンロードし、下記いずれかのインラインスクリプトを使用してください。
<!-- WhatsApp インラインボタン --><!-- 必要に応じて WHATSAPP_PHONE_NUMBER やファイル名/パスを書き換えてください --><a aria-label="WhatsApp でチャット" href="https://wa.me/WHATSAPP_PHONE_NUMBER" target="_blank" rel="noopener noreferrer"> <img alt="WhatsApp でチャット" src="WhatsAppButtonGreenLarge.svg" style=" width: 200px; height: auto; cursor: pointer; border-radius: 12px; " /></a>または
<!-- WhatsApp フローティングボタン --><!-- 必要に応じて WHATSAPP_PHONE_NUMBER やファイル名/パスを書き換えてください --><a aria-label="WhatsApp でチャット" href="https://wa.me/WHATSAPP_PHONE_NUMBER" target="_blank" rel="noopener noreferrer" style="position: fixed; right: 20px; bottom: 20px; z-index: 9999"> <img alt="WhatsApp でチャット" src="WhatsAppButtonGreenLarge.svg" style=" width: 200px; height: auto; cursor: pointer; border-radius: 12px; box-shadow: rgba(0, 0, 0, 0.5) 0px 5px 15px 0px; transition: all 0.3s ease; " onmouseover="this.style.transform = 'scale(1.05)'" onmouseout="this.style.transform = 'scale(1)'" /></a>自分専用の WhatsApp QR コードを作成するには?
- WhatsApp Manager にアクセス → 電話番号 → ビジネス用電話番号を選択 → メッセージリンク → メッセージリンクを作成。
- または、WhatsApp Business のモバイルアプリでも作成できます。この WhatsApp のチュートリアル をご参照ください。
設定の問題を解決するために、WhatsApp Business アプリのアカウントの接続を解除すべきですか?
- いいえ。 トラブルシューティングのために、WhatsApp Business アプリのアカウントを削除したり、接続を解除したり、番号を移行したりしないでください。Quickchat AI の現在の接続フローでは、既存のアプリの設定や履歴を維持できることが確認された Coexistence の接続方法は提供されていません。
- 運用中の WhatsApp Business アプリのアカウントを変更する前に、support@quickchat.ai へメールでお問い合わせください。Meta の Business アプリのオンボーディングガイド は、対応する連携での Coexistence を説明していますが、ご自身の Quickchat AI の設定で利用できることを確認するものではありません。
Quickchat AI は WhatsApp Business アカウントにどのようなアクセス権を持ちますか?
- アカウントの所有権ではなく、範囲が限定された API アクセスです。 WhatsApp Business アカウント(WABA)は、お客様自身の Meta Business Manager に保持されます。Meta の WABA 共有モデルでは、お客様がアセットを所有し、Quickchat AI はパートナーとして追加されます。Quickchat AI のアクセスは Business Manager からいつでも取り消せます。
- 連携中は、Cloud API を通じてメッセージを送受信し、Webhook でメッセージイベントを受信できます。
- アカウントの閉鎖、移管、ブランド変更、請求情報の変更、管理者の削除はできません。
サポートが必要ですか?
Section titled “サポートが必要ですか?”Quickchat のサポート AI と WhatsApp でチャット:
📱 +1 302-405-9992 — チャットを開始
または QR コードをスキャンしてください。
