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

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

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

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

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

詳細はブラウザのコンソールを確認してください。

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

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

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

確認してください：

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

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

このエラーについてはFinカスタマーサポートにお問い合わせください。

インストールページでWhatsApp番号が接続されていることを確認してください。

電話番号がMetaで完全に承認されていることを確認してください。

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

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

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

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

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

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

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

WhatsApp番号を接続中に「(#1) パラメータエラー」のようなエラーメッセージが表示された場合：エラーメッセージのスクリーンショットを撮ってください。多くの場合、解決にはMetaサポートが必要です。MetaとIntercomの設定が正しく構成されていることを確認してからお問い合わせください。

例：

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

スクリーンショットを撮り、設定を確認してください。ほとんどのパラメータエラーはMeta側に起因し、Metaサポートを通じて解決する必要があります。

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

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

注意：このエラーを回避するには、適切なタイミングでポップアップを閉じることが重要です。閉じるべきウィンドウは以下の通りです👇

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

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

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

その場合は、Metaの設定に移動して次に必要な手順を確認してください。

確認してください：

Intercomでは、{{sf_full_name}}のような説明的なプレースホルダーではなく、数値プレースホルダー（例：{{1}}）を使用する必要があります。例：こんにちは{{1}}、ご注文{{2}}は発送されました。

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

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

WhatsAppは、受信者のWhatsAppアカウントが現在メッセージを受信できないため、このメッセージを配信できませんでした。これは電話番号がWhatsAppに登録されていない場合、受信者が最新のWhatsApp利用規約またはプライバシーポリシーに同意していない場合、またはWhatsAppアプリのバージョンが古い場合（必要最低バージョンはAndroid/SMBA 2.21.15.15、iOS/SMBI 2.21.170.4、KaiOS 2.2130.10、Web 2.2132.6）に発生します。その他、Metaによるアカウントのフラグ付けやメッセージ頻度制限超過も配信阻害要因です。

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

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

このメッセージは、WhatsAppが健全なエコシステムの維持のためにブロックしたため配信されませんでした。通常、受信者が一定期間内に受け取れるマーケティングテンプレートメッセージの上限に達したことを意味します。

これが原因と思われる場合、テンプレートメッセージの再送信は少なくとも24時間待つのが最善です。早く再送すると同じエラーが発生する可能性が高く、頻度制限の解除時間は変動します。詳細はWhatsAppのドキュメントでリセットタイムラインを確認してください。

このメッセージは実験の一環として送信されませんでした。実験の詳細はWhatsAppのマーケティングメッセージ実験ドキュメントを参照してください。

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

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

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

メッセージを続けるには、WhatsApp承認済みテンプレートメッセージを送信してください。受信者が返信すると24時間ウィンドウが再開し、通常の自由形式メッセージが再び送信可能になります。

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

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