Alexgub84/meta-whatsapp-cloud-api

meta-whatsapp-cloud-api は何をしますか？

この手順は、実際のMeta Business Suiteと開発者コンソールで2026年11月8日に最終確認されました。Metaはこれらの画面、フィールド名、ウィザードフローを頻繁かつ予告なく変更します。以下の手順が実際の表示と一致しない場合は、推測せずにこのリポジトリにIssueを開き、修正を見つけた場合はPRを送信してください。

してはいけないこと

• 拒否された認証を同じ日に再提出しないでください。実際の問題を修正し、24時間待ってから提出してください。同じ日の再試行は、さらに長い審査の対象となる傾向があります。
• ビジネス情報に入力する法的な事業者名、住所、電話番号を推測したり「クリーンアップ」したりしないでください。それらを証明するためにアップロードされる書類から一字一句コピーしてください。
• 長期にわたるpendingステータスを、実際のステータスフィールドを再確認せずに「Metaが遅いだけ」と扱わないでください（§2参照）。静かに「追加情報が必要」に変わる可能性があり、通知メールは誰も積極的に監視していない受信箱に届く傾向があります。
• 個人事業主の税金登録証明書を、法的な事業者名や住所の証明として提供しないでください。特に、該当する地域の同等の書類がMetaの許容書類リストにない場合は注意が必要です。§1の実例を参照してください。Metaは、書類が「受理可能な種類ではない」と明確に述べています。よく知られた地域の書類が公式だからといって受け入れられると思い込まず、そのメッセージを読んでください。
• 法的な事業者名がウェブサイトの実際のトップページに存在しない状態で提出しないでください。Metaは/（Aboutページや利用規約ページではない）を取得し、名前がそこにない場合、特にこの理由で認証に失敗します。
• タスクのヘルプを得るためだけに、外部の共同作業者をフルポートフォリオユーザーとして追加しないでください。これはMeta自身のリストにある明確な拒否理由です。代わりにより狭いパートナー/共同作業者のアクセスレベルを使用してください。
• 確認コード、2段階認証PIN、またはパスワードを、アカウント所有者が入力するMeta自身のコンソール以外の場所に入力しないでください。

1. ビジネス認証

認証とは何か、何でないか

Meta Business Suiteにおけるビジネス認証は、有料のMeta Verifiedサブスクリプションとは異なるものであり、認証バッジは付与されません。Metaはこれを直接次のように述べています。「Meta Business Suiteでのビジネス認証は、ビジネス向けMeta Verifiedとは異なり、認証バッジは付与されません。」（Meta Business Help Center、「Meta Business Suiteでビジネスを認証する方法」、https://www.facebook.com/business/help/2058515294227817、2026年11月9日閲覧 — 同じ文はhttps://www.facebook.com/business/help/2342133782492969でも繰り返されています、2026年11月9日閲覧）。認証バッジは特にMeta Verifiedの特典です。「ビジネス向けMeta Verifiedは、新しいオーディエンスとの信頼構築とブランド保護に役立つツールを提供する有料サブスクリプションです。このサブスクリプションには、認証バッジ、拡張サポート、なりすまし防止などの特典が含まれます。」（https://www.facebook.com/business/help/308979828303560、2026年11月9日閲覧）。Meta Verifiedは定期購読であり、このスキルがカバーする無料の認証手順とは別の購入です。

ビジネス認証が実際に何を有効にするのか、Meta自身の言葉によれば：「ビジネス認証は、特定の広告、開発者、請求、支出機能にアクセスするために必要です。」（https://www.facebook.com/business/help/2058515294227817、2026年11月9日閲覧）。さらにhttps://www.facebook.com/business/help/1095661473946872（2026年11月9日閲覧）で詳しく説明されています：1日の支出制限、対象となる開発者機能、Meta Business Partnersへのアクセス、News Pageインデックス、WhatsApp Business Platform、Page透明度、中国拠点の代理店、金融サービス広告主ステータス。特にWhatsApp Business Platformについては、同じページで次のように述べられています。「WhatsApp Business Platformを使用する企業は、特定の機能にアクセスするために認証を完了する必要がある場合があります。」開発者側では：「高度なアクセスにはビジネス認証が必要になりました... 権限の高度なアクセスを要求するアプリ、および他のビジネスが自社データにアクセスできるようにするアプリは、ビジネス認証を完了したビジネスに接続する必要があります。」（https://developers.facebook.com/docs/development/release/business-verification/、2026年11月9日閲覧）。

上記のページ、またはWhatsApp向けMetaのアカウントスケーリングページ（https://www.facebook.com/business/help/595597942906808、2026年11月9日閲覧）で確認され、見つからなかったもの：停止する前に何回再提出すべきか、または再提出するのではなく根本で書類を修正するようにアドバイスするMetaからの声明。そのアドバイスはサードパーティのエージェンシーブログでは一般的ですが、このスキルで確認された範囲ではMetaはどこにもそれを述べていないため、ここでは事実として繰り返しません。以下の「してはいけないこと」リストは、Meta自身のページがサポートしていることにのみ準拠しています：カウントではなくタイミングルールです。

適切な書類セットの選択

Meta自身の許容書類カテゴリ（実際に認証試行が実行された後にのみ表示される「詳細と次のステップ」ダイアログから直接読み取ったもの）：

証明するもの	許容される種類
法的な事業者名	設立証明書/定款、事業許可証/営業許可証、銀行取引明細書、または銀行からの書簡
住所	上記4つに加え、水道、ガス、電気、電話の公共料金請求書

登録企業の場合、通常は設立証明書が最も明確な単一書類です。会社登録のない個人事業主の場合、正確に相当する書類がないことがよくあります。たとえそれが明白な書類に思えても、管轄区域の一般的な小規模事業者向け税金登録証明書がカウントされると思い込まないでください。実例（イスラエル）： イスラエルの個人事業主のעוסק פטור/עוסק מורשה証明書は、Metaによって明示的に拒否されます（「受理可能な種類ではありません」）。これはイスラエルで法的な取引ステータスの標準的な証明であるにもかかわらずです。代わりに機能したのは、法的な事業者名を証明する銀行口座所有証明書（ほとんどの銀行がビジネス認証用に要求に応じて発行可能）と、住所を証明する公共料金請求書 — 2つの許容カテゴリからそれぞれ1つの書類で、それぞれがビジネス情報に入力されたとおりの名前または住所を印刷しているもの — でした。

管轄区域に関わらず適用される一般的なルール：

• 名前と住所の両方を完全かつ明確に記載した単一の書類は、1回のアップロードで両方の要件を満たします。
• ヘブライ語やその他の非英語の文字もそのまま受け入れられます（翻訳は不要）が、名前/住所に使用する言語を1つ選択し、ビジネス情報、ウェブサイトのトップページ、書類自体で一貫して使用してください。
• 試す価値がないとして、一目で拒否するもの：リース契約、個人（事業用ではない）請求書、ポータルページのスクリーンショット、トリミング、注釈、またはその他の編集が施されたもの、および正式な登録書類を除く約90日より古い書類。
• あるファイル形式から別のファイル形式への忠実な全ページレンダリング（PDFから高解像度PNGなど）は問題ありません。その一部をトリミングしたり再入力したりすることは問題です。

提出前のポートフォリオ準備

• ビジネス情報フィールドは、アップロードされる書類と正確に一致している必要があります。句読点や法的なサフィックス（「Ltd」などの会社サフィックスは、両方の場所に存在するか、どちらにも存在しないかのいずれかです）を含みます。標準化する言語を1つ決め、すべての場所で使用してください。
• ウェブサイトは到達可能で、HTTPSを提供し、どのページにもエラーや工事中の状態を表示してはならず、そして — これは到達可能性とは別にチェックされ、独立して失敗します — トップページに正確な法的な事業者名が表示されている必要があります。ごく最近登録されたドメインは疑いを招く可能性が高くなります。ある程度の経歴があるドメインの方が優位です。
• ビジネスメールはウェブサイトと同じドメインである必要があります。無料のコンシューマーメールドメインは、拒否率を測定可能なほど増加させ、そうでない場合でも審査を遅らせます。
• ビジネスに正直に一致するリストカテゴリを選択してください。センシティブなカテゴリ（金融、健康、ギャンブル、アルコール）は、追加の精査と追加の必要書類を招きます。
• ポートフォリオに2人の管理者がおり、両方で二要素認証が有効になっていると、摩擦が軽減される傾向があります。保護されていない管理者1人だけでは、それ自体が拒否のトリガーとしてリストされています。
• 認証が必要なアセット（通常はWABA）は、開始前にすでにポートフォリオにアタッチされている必要があります。そうでない場合、認証エントリポイント自体が「不適格」としてグレーアウトされます。

上記が修正されてもウェブサイトが独自のチェックに失敗し続ける場合、Metaは機能するウェブサイトの代わりにビジネスIDを確認するための2つの代替方法を文書化しています：ビジネスに実際に関連付けられている別のドメインの確認メール、または代わりにビジネス電話番号で確認することです。

確認チャネルによって必要な書類が変わる

ウィザード中に選択された確認チャネルによって、アップロード手順で実際に要求されるものが変わります：

• 電話、SMS、またはWhatsAppメッセージをチャネルとして選択 → ウィザードは、法的な事業者名と電話番号を証明する書類を要求します。
• メールをチャネルとして選択 → ウィザードは、法的な事業者名と住所または電話番号を証明する書類を要求します。

したがって、入手が最も簡単な書類に合わせてチャネルを選択してください。その逆ではありません。銀行の書簡と公共料金請求書が入手可能な場合は、メールを選択してください。

提出

認証エントリポイント（現在のMetaのレイアウトではSecurity Center）に移動し、認証するユースケースに一致するものを選択し（通常、特にWhatsApp Businessアカウントのセットアップ用のオプションがあります。両方存在する場合は、汎用的な「アプリの権限」オプションよりもそちらを優先してください）、ウィザードを進めます：国、ビジネスタイプ（未登録の個人事業主は通常「個人事業主」であり、正式な会社がなくても、地元の税務当局が何らかの登録番号を発行している場合は「登録済み」と回答されることがよくあります）、ビジネス詳細、CAPTCHA（常に人間が完了し、自動エージェントは決して使用しない）、公開記録一致ステップ、確認チャネル、書類アップロード、および最終レビュー/提出。

その公開記録ステップとアップロードステップで予想される2つの落とし穴：

• Metaは、もっともらしく見えるが、類似した名前を持つ無関係な別のエンティティに属する公開記録の一致を提供する場合があります。一致を受け入れる前に、すべての識別詳細（住所、ドメイン、表示されている税番号や登録番号）を確認してください。他人のビジネス記録を主張することは、ポリシー違反であり、この1回の認証を失敗させるだけでなく、ポートフォリオ全体を制限する可能性があります。疑わしい場合は、「私のビジネスはリストにありません」を選択してください。
• 一部の書類アップロードステップでは、見逃しやすいトグル（「あなたの書類には電話番号または住所が含まれていましたか？」）がデフォルトで「いいえ」になっている場合があり、その後、ほとんどの申請者が手元に持っていないまったく別の2つ目の書類を要求します。すでにアップロードした単一の書類に両方の情報が含まれている場合は、そのトグルを「はい」に切り替えると、追加のステップが消えます。

提出後、チャネル確認済みの提出では約1〜2営業日、書類ベースの提出では3〜7日（Metaの定期的なポリシー更新期間中は最大14日）を見込んでください。提出が「保留中」の間は触らないでください。つまり、管理者を追加したり、設定を変更したり、気まぐれにサポートスレッドを開いたりしないでください。それらのいずれもキューに入ったレビューを早めることはなく、提出内容と矛盾するものを作成することは、害にしかなりません。

メールに頼らずに「追加情報が必要」を監視する

ステータス変更に関するMetaの通知は、ポートフォリオの管理者連絡先として設定されたメールアドレスに送信されます。これは、誰かが毎日チェックする受信箱ではないことが非常に多いです。ブラウザ不要で信頼できる唯一の確認方法は、APIアクセスがすでに存在する場合に直接APIを呼び出すことです：

curl -s "https://graph.facebook.com/v21.0/$WABA_ID?fields=business_verification_status" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

実際に見られる値：pending（Metaの番、待つ以外にすることはない）、pending_need_more_info（あなたの番 — コンソールで正確に何が要求されているかを確認してください。このフィールドだけではわかりません）、verified。通知されるのを待つのではなく、定期的にこれにポーリングしてください。ステータスが静かに「追加情報が必要」に切り替わってから誰かが実際に気付くまでのギャップが、実際の提出物に完全なレビューサイクルを無駄にさせたことがあります。

2. Cloud APIの立ち上げ（認証前でも機能します）

以下のすべての手順は、認証されていないポートフォリオでも機能します。認証はメッセージングボリュームの上限を変更するだけで、API自体が機能するかどうかには影響しません。一方を待ってから他方を開始するのではなく、両方を並行して進めてください。ビジネスポートフォリオは手順1の前にすでに存在している必要があります（business.facebook.comで作成済み）。以下の手順は、新しいアプリをその既存のポートフォリオにアタッチするものであり、新しいポートフォリオを作成するものではありません。

1. アプリを作成します。 開発者コンソールで、WhatsAppに焦点を当てたユースケース（「WhatsAppを通じて顧客とつながる」、または現在のコンソールでそれに相当するもの）を使用してアプリを作成し、既存のビジネスポートフォリオにアタッチします。このために新しいポートフォリオを作成しないでください。認証がゼロからやり直しになります。
2. WhatsApp Business Account（WABA）をアタッチまたは作成します。 アプリのWhatsApp設定パネルで、既存のWABAに接続するか、新しいWABAを作成します。WABA IDとテスト電話番号のIDを耐久性のある場所に記録します。
3. まずMeta発行のテスト番号を試します。 限られた試用期間中は無料で、事前承認された少数の受信者番号（それぞれホワイトリストに登録するためにワンタイムコードが必要）をサポートし、実際のSIMが関与する前にWebhookとメッセージ送信コードが機能することを証明する最も速い方法です。
4. システムユーザーアクセストークンを生成します。一時的なユーザートークンではありません。適切なロールを持ち、管理アクセス権でアプリに割り当てられたシステムユーザーは、有効期限のないトークンを生成できます。必要な権限は通常、メッセージングとWABA管理のスコープです。統合がAPIを介して（コンソールではなく）認証ステータスを読み取ったり、WABAを削除したりする場合は、より広範なビジネス管理スコープも必要です。クイックスタートからの一時的なトークンは...

[以下、翻訳対象外のため省略]