WhatsApp

このガイドでは、Quickchat AI Agent を WhatsApp に連携する方法を紹介します。手順は 2 つのシンプルなステップ で構成されています。

• ステップ 0 – 事前準備
• ステップ 1 – WhatsAppを接続

連携で問題が発生した場合は、トラブルシューティング & FAQ を参照するか、お問い合わせ ください。

ビデオを見る

Play

ステップ 0 – 事前準備

A. ビジネス用電話番号

WhatsApp で使用する 電話番号 を決めます。詳細は WhatsApp ドキュメント または以下の FAQ を参照してください。

WhatsApp Cloud API で使用できる番号は？

• SMS または音声通話で認証できる 専用のビジネス番号 が必要です。
• 有効な番号で、あなたが所有し、国番号と市外局番を持つ必要があります。

WhatsApp Messenger で使用中の番号は使えますか？

• いいえ。 通話や SMS では利用できますが、WhatsApp Messenger では使用できません。
• すでに Messenger で使っている場合は、先に削除 してください。削除前にチャット履歴をバックアップすることを忘れないでください。
• 停止済みの番号は、登録前に解除しておく必要があります。

WhatsApp Business アプリで使用中の番号は？

• はい。 現在 WhatsApp Business アプリで使用している番号でも、アプリのアカウントを削除せずに Cloud API へオンボードできる場合があります。Meta の Coexistence オンボーディング を参照してください。

新しい番号を使えますか？

• はい。 現在の番号を使いたくない場合は、新しい番号（物理 SIM または仮想番号）を取得してください。Hushed などで購入できます。

B. 会社情報

Meta の連携フローで入力するため、次の情報を準備してください。

• 会社名
• 会社の Web サイト
• 業種カテゴリ
• 会社の説明

注意

一部の項目は任意に見えても、正確に入力してください。不足や誤りがあると承認が遅れたり制限される可能性があります。

ステップ 1 – WhatsAppを接続

Quickchat AI App → External Apps → WhatsApp を開き、WhatsAppを接続 ボタンをクリックして Meta のポップアップに従います。

1. Meta（Facebook）アカウントでログインします。
2. Quickchat AI と共有する権限（WhatsApp Business アカウントへのアクセスと Business ポートフォリオへのアクセス）を確認し、続行します。
3. Business Portfolio、Business Name、Business Website、国など、正確なビジネス情報を入力します。
4. WhatsApp Business アカウントを作成または選択します。
5. WhatsApp Business の表示名とカテゴリを選択します。
6. ビジネス番号 を追加し、SMS または音声で認証します。
7. Confirm をクリックして Quickchat AI に必要なアクセス権を付与します。
8. 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

WhatsApp Business API の料金体系は？

• ユーザーからの問い合わせ（インバウンド）に対する返信は、WhatsApp 上で サービスメッセージ として扱われ、有人または会話型 AI によるサポートが可能です。
• ユーザーが企業へメッセージを送ると 24 時間のカスタマーサービスウィンドウ が開き、その間はサービスメッセージで 無料 返信できます。このウィンドウは ユーザーメッセージごとにリセット されます。
• 24 時間を過ぎた場合 は、承認済みテンプレート（マーケティング、ユーティリティ、認証など）を使用し、WhatsApp Business Platform メッセージ料金 に従って課金されます。
• 会話は Meta により カテゴリ分けと課金 が行われます。テンプレート／企業発信メッセージ用に、WhatsApp Business アカウントに 有効な支払い方法 を設定してください。

「WhatsAppを接続」ボタンが機能しない、Meta ポップアップが表示されない。

• ブラウザがポップアップをブロックした場合は、Quickchat AI App のポップアップを許可して 再試行 をクリックしてください。このタブで Meta に進む をクリックすると、ポップアップを使わずに同じセットアップを完了することもできます。

Quickchat は WhatsApp の接続を確認できませんでした

Quickchat は、Meta のウィンドウから結果が返らず、接続を引き続き確認できない場合に、このリカバリーメッセージを表示します。Meta 側で変更が行われていないことを保証するものではありません。

1. WhatsApp Business アカウントを所有する Meta Business の管理者であることを確認してください。管理者でない場合は、管理者に Facebook ログインから接続してもらってください。
2. 再試行 をクリックしてください。ブロッカーが Meta のウィンドウを妨げる場合は、拡張機能を一時停止したプライベートウィンドウを使用するか、このタブで Meta に進む をクリックしてください。
3. 番号が WhatsApp Messenger で有効な場合は、先に Messenger から削除するか、別の番号を使用してください。WhatsApp Business アプリで有効な場合は、Meta の Coexistence オンボーディング に従ってください。
4. WhatsApp Business アカウントが Aircall、Twilio、360dialog、MessageBird、または別のプロバイダーを使用している場合は、Meta Business 設定で Quickchat AI をパートナーとして追加してください。
   1. Meta Business 設定を開き、アカウント → WhatsApp アカウント に移動します。
   2. WhatsApp Business アカウントを選択して パートナー を開き、パートナーを追加 をクリックします。
   3. Quickchat AI の Business ID 270696274483463 を入力します。
   4. WhatsApp アカウントを管理 を許可し、Quickchat AI に戻ってステータスを更新します。

Meta が同じアカウントで両方のパートナーを許可しない場合にのみ、他のプロバイダーとの接続を解除してください。判断に迷う場合は、現在利用中のメッセージプロバイダーとの接続を解除する前にサポートへお問い合わせください。

番号の認証に失敗する。

• 番号が SMS／通話を受信できること、Meta が共存を許可しない登録経路で使用されていないことを確認してください。番号が Business アプリで使われている場合は、Coexistence でのオンボーディングを検討してください。

間違ったアカウントを接続してしまった。

• 再接続 では、すでに接続されているアカウントがそのまま維持されます。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 は External Apps の WhatsApp パネルに “WhatsApp の返信が送信できません” アラートを表示し、ダッシュボードにも通知を表示します。よくある原因と対処は次のとおりです。

• Meta のテスト番号の表示名が未承認： Meta から割り当てられた +1 555 番号は、表示名が承認されるまで Meta が返信を保留します。パネルの表示名アラートが赤くなり、対象の番号が示されます。審査の完了（通常は数日）を待つか、却下された場合は WhatsApp Manager で新しい表示名を申請してから、テストメッセージを送信してください。ご自身の番号で審査中の表示名だけでは返信はブロックされません。パネルには参考情報として表示されます。
• 接続の期限切れまたは取り消し： WhatsApp 接続が有効ではなくなっています。WhatsApp パネルを開き、再接続 をクリックして返信の送信を再開してください。
• 番号の制限： Meta があなたの WhatsApp 番号を制限しました（品質またはポリシー）。送信を復旧するには、WhatsApp Manager でステータスを確認してください。

返信が再び正常に送信されると、アラートは自動的に解除されます。

テンプレート／企業発信メッセージが失敗する。

• 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 のチュートリアル をご参照ください。

Coexistence で接続した場合、後から接続を解除できますか？

• はい、いつでも解除できます。 WhatsApp Business アプリ内の 設定 → アカウント → ビジネスプラットフォーム → 接続解除 に進みます。
• 番号は Business アプリで引き続き利用でき、連絡先と既存のチャット履歴にも影響はありません。
• Quickchat AI の API アクセスは直ちに終了します。
• Quickchat AI からの送信メッセージを停止するだけで、接続を解除せずに連携を一時停止することもできます。

Quickchat AI は WhatsApp Business アカウントにどのようなアクセス権を持ちますか？

• アカウントの所有権ではなく、範囲が限定された API アクセスです。 WhatsApp Business アカウント（WABA）は、お客様自身の Meta Business Manager に保持されます。Meta の WABA 共有モデルでは、お客様がアセットを所有し、Quickchat AI はパートナーとして追加されます。Quickchat AI のアクセスは Business Manager からいつでも取り消せます。
• 連携中は、Cloud API を通じてメッセージを送受信し、Webhook でメッセージイベントを受信できます。
• アカウントの閉鎖、移管、ブランド変更、請求情報の変更、管理者の削除はできません。

サポートが必要ですか？

Quickchat のサポート AI と WhatsApp でチャット：
📱 +1 302-405-9992 — チャットを開始

または QR コードをスキャンしてください。