このエラーは、電話番号が以前に別のWhatsApp Business APIプロバイダーまたはWhatsAppモバイル/ビジネスアプリで使用されていた場合に表示されます。番号が標準のWhatsAppアプリで使用されていた場合、Intercomに接続する前に切断する必要があります。

別のAPIプロバイダーで使用されている場合：
既存のWhatsApp電話番号を移行するオンボーディングフローに従い、ステップ2の後に埋め込みオンボーディングを終了してください。

モバイルWhatsAppアプリで使用されている場合：
エラーに表示される詳細リンクの手順に従い、そのWhatsAppアカウントから番号を切断してください。その後、オンボーディングプロセスを再試行できます。

どちらにも該当しない場合は、以下の情報を添えてサポートに連絡してください：

手動接続を試みることができます。

ブラウザの開発者ツールを開きます（F12キーを押すか、ページを右クリックして検証を選択）、次にコンソールタブに移動して完全なエラーメッセージを確認してください。

移行中に発生した場合：
移行はすでに成功している可能性があります。「初めてWhatsAppを統合する」フローを使用して、新しく作成されたアカウントを選択してください。

ビジネスプロフィール設定を保存できず、ブラウザのコンソールに500エラーが表示される場合、更新しようとしているプロフィール設定に対してWhatsAppから返された検証エラーの可能性があります。文字数制限などの詳細はこちらをご覧ください。

完全なエラー：「電話番号を移行できません。この番号が登録されているWhatsAppアカウントの設定が正しくありません」。

確認してください：

両方のチェックが失敗した場合：Business Managerの認証済み番号のスクリーンショットをサポートに送ると解決が早まります。

サポートに以下を提供してください：

これは、Metaの埋め込みサインアップ中にWhatsApp Business Account（WABA）がIntercomと共有されなかった場合に発生し、Intercomがアクセスできません。接続フローを再実行し、求められたらWABAへのアクセスをIntercomに許可してください。エラーが続く場合は、WABA IDを添えてIntercomサポートに連絡してください。

インストールページでWhatsApp番号が接続されていることを確認してください。接続されていない場合は、まずWhatsAppセットアップフローを完了してください。接続後、WhatsAppで二要素認証を無効にし（以下の注意を参照）、証明書作成を再試行してください。

Meta Business Managerで電話番号が完全に承認されていることを確認してください。番号に保留中の審査や承認がある場合は、Intercomで再試行する前にそれらを完了してください。

これは通常、タイトルや説明フィールドに制限または禁止された単語が含まれているために発生します。

これは多くの場合、サードパーティプロバイダーによって提供された番号で発生します。移行のオンボーディング手順を再度試してください。うまくいかない場合はIntercomサポートに連絡してください。

このエラーはMeta Supportによって解決する必要があり、Intercom内で修正できません。

完全なエラー：「サポートされていないGETリクエスト。ID XXXXXXXXXXXXのオブジェクトは存在しないか、権限が不足しているため読み込めないか、この操作をサポートしていません。」

番号を接続しようとする際、表示されるコードがWhatsAppアカウントIDであることを確認してください。

これは通常、電話移行エラーのためにMetaによってフラグが立てられます。詳細はMetaのドキュメントを確認してください。

さらに、次のエラーが発生した場合：タイプ: OAuthException コード: 1 エラーサブコード: 23881 メッセージ: 無効なパラメーター エラーユーザータイトル: 証明書を作成できません エラーユーザーメッセージ: あなたのビジネスはWhatsAppのポリシー要件を満たしていません。ビジネスが条件を満たしていると思われる場合は、Meta Business Suite Supportにお問い合わせください。公式ドキュメントはこちら：こちら。

番号を接続中に（#1）パラメーターエラーが発生した場合は、以下の専用セクションを参照してください。

例：

これらのエラーは、ビジネスがWhatsAppのポリシースタンダードを満たしていない可能性を示します。ビジネスが条件を満たしていると思われる場合は、Meta Business Suite Supportにお問い合わせください。公式ドキュメントはこちら：こちら。

このエラーをトラブルシューティングするには：

このエラーメッセージは、WhatsAppメッセージリクエストに含まれる変数パラメーターの数が、WhatsAppテンプレートで定義された変数パラメーターの数と一致しないことを意味します。テンプレートを編集し、すべての変数に値を追加する必要があります。

以下の手順に従ってください：

注意：このエラーを回避するには、正しいタイミングでポップアップを閉じることが重要です。アカウント作成後、電話番号を追加する前にWhatsApp Business Account作成ポップアップを閉じてください。

次のエラーが表示された場合：

「あなたのビジネスアカウントには保留中のアクションがあります。送信前に完了する必要があります」

これは、Meta（WhatsApp Business Manager）がメッセージ送信をブロックしていることを意味します。つまり、WhatsApp Business Account（WABA）または電話番号の設定がMeta側で完全に完了または検証されていません。

Meta Business Managerアカウントにログインし、WhatsAppアカウントに移動して、WhatsApp Businessアカウント（WABA）または電話番号に保留中のアクションがないか確認してください。保留中の認証手順を完了し、メッセージの送信を再試行してください。

サポートに連絡する前に、以下を確認してください。Intercomにテンプレートが表示されない場合、通常は以下のいずれかのチェックに失敗しています。

WhatsAppでは、テンプレートに説明的なプレースホルダー（例：{{sf_full_name}}）ではなく、数値プレースホルダー（例：{{1}}）を使用する必要があります。例：こんにちは{{1}}、ご注文番号{{2}}は発送されました。Intercomはこれらを位置で属性にマッピングします。

{{sf_full_name}}のような変数を使ったテンプレートが失敗する場合は、Metaで説明的なプレースホルダーを数値プレースホルダーに置き換え、Intercomでマッピングしてください。これにより、WhatsAppとIntercom間の互換性が保たれ、変数が直接Intercom属性にマッピングされます。

テンプレートを非マーケティングのままにするには：

WhatsAppは、受信者のWhatsAppアカウントが現在メッセージを受信できないため、このメッセージを配信できませんでした。これは、電話番号がWhatsAppに登録されていない場合、受信者が最新のWhatsApp利用規約またはプライバシーポリシーに同意していない場合、または古いバージョンのWhatsAppを使用している場合に発生します（最低バージョン要件は以下の表に記載）。その他、Metaによる保留中のアクションのためにアカウントがフラグ付けされている場合や、メッセージ送信頻度制限を超えた場合も配信がブロックされる可能性があります。Intercomはこれをエラーコード131026としてマッピングし、「メッセージ配信不能」または「受信者が受信不能」として表示します。

問題を解決するには、別の通信チャネル（SMS、メール、電話など）で受信者に連絡し、WhatsApp Business番号にメッセージを送信できるか確認し、設定>ヘルプまたは設定>アプリ情報で保留中の利用規約のプロンプトを承認し、WhatsAppクライアントを最新バージョンに更新するよう依頼してください。

これらの手順を完了すると、WhatsAppはメッセージを正常に配信できるようになります。

このメッセージは、WhatsAppが健全なエコシステムの維持のためにブロックしたため配信されませんでした。通常、受信者が一定期間内に受け取れるマーケティングテンプレートメッセージの上限に達したことを意味します。Intercomはこれをエラーコード131049（エコシステムエンゲージメント）として識別します。トラブルシューティング手順とリセットのタイムラインについては、WhatsAppメッセージ失敗トラブルシューティングガイドをご覧ください。

これが原因だと思われる場合、テンプレートメッセージの再送信を試みる前に少なくとも24時間待つのが最善の対応です。早く再送信すると同じエラーが発生する可能性が高く、制限は時間によって異なる期間有効な場合があります。頻度制限の解除期間は変動するため、具体的なリセットタイムラインについてはWhatsAppのドキュメントを参照してください。

このメッセージはexperimentの一部として送信されていません。実験の詳細については、WhatsAppのマーケティングメッセージ実験のドキュメントをご覧ください。

このメッセージは、WhatsAppが含まれているメディアのアップロードに失敗したため配信できませんでした。これは通常、ファイルがサポートされていない形式であるか、WhatsAppのメディア要件を満たしていない場合に発生します。

これを解決するには、送信しようとしているメディアファイルを確認し、その形式とサイズがWhatsAppでサポートされていることを確認してください。メディアがWhatsAppの要件を満たせば、メッセージを正常に再送信できるはずです。

このメッセージは、受信者が最後にあなたのWhatsApp番号に返信してから24時間以上経過しているため配信できませんでした。WhatsAppはその24時間の会話ウィンドウ内でのみ自由形式のメッセージを許可しています。このエラーは、会話中に受信者の電話番号が変更された場合にも発生し、セッションが実質的にリセットされます。

メッセージのやり取りを続けるには、WhatsApp承認のテンプレートメッセージを送信する必要があります。受信者が返信すると24時間のウィンドウが再開し、通常の自由形式メッセージを再び送信できるようになります。

このメッセージは、あなたのアプリに接続されているWhatsAppビジネスアカウントが制限または無効化されているため配信できませんでした。これは通常、WhatsAppがプラットフォームポリシー違反を検出した場合や、リクエストの詳細がアカウントの設定と照合できない場合（例：誤った二段階認証PIN）に発生します。

これを解決するには、WhatsAppのポリシー執行ガイドラインを確認し、違反の種類とアカウントを復旧するための手順を理解してください。また、WhatsApp Health Status APIでアカウントがロックまたは制限された理由の詳細を確認できます。根本的な問題が解決されれば、メッセージ配信は通常通り再開されます。