このトピックでは、Meta の公式技術プロバイダーとして登録する方法と、CPaaS を使用して登録プロセスを効率化する方法について説明します。
1. 技術プロバイダーとは
技術プロバイダーは、法人顧客に WhatsApp Cloud API へアクセスを提供するために Meta から承認されたテクノロジーインテグレーターです。技術プロバイダーは WhatsApp Business Platform との独自のインテグレーションを開発し、顧客がメッセージを送受信できるようにします。
2. 対象ユーザーとメリット
2.1. 対象
このガイドは、次の種類のプラットフォームおよびサービスプロバイダーを対象としています:
-
独立系ソフトウェアベンダー (ISV)
-
自社構築の顧客管理システムを持つプラットフォーム型企業
-
複数の顧客向けに WhatsApp チャネルを大規模に管理する必要がある仲介サービスプロバイダー
十分な技術リソースがある場合は、3.1. ビジネスポートフォリオの作成 から開始できます。
-
複数の顧客向けに WhatsApp チャネルを管理する必要がある一方、社内の技術リソースが十分ではない企業
技術リソースが限られている場合は、5. CPaaS を使用したクイック登録 から開始できます。
2.2. 技術プロバイダーになるメリット
-
埋め込み登録フローを使用して顧客をオンボーディングし、顧客の WABA を直接管理できます。
-
技術プロバイダーとして登録すると、埋め込み登録ページに会社ロゴが表示されます。非技術プロバイダーの場合は、Alibaba Cloud ロゴが表示されます。
-
Chat App Message Service API を使用して機能リリースサイクルを短縮し、より迅速に統合することで社内開発コストを削減できます。
3. 技術プロバイダーとしての登録
登録を開始する前に、テクニカルサポートに連絡して、アカウントにプロバイダーロールを付与するよう依頼してください。
社内に開発能力がある場合は、ここから開始することを推奨します。
3.1. ビジネスポートフォリオの作成
登録を開始する前に、ビジネスポートフォリオに住所、Web サイト、メールアドレスなど、正確な会社情報とその他のビジネス関連情報が含まれていることを確認してください。
ビジネスポートフォリオがない場合は、新規に作成してください。
企業が作成できるビジネスポートフォリオは最大 2 つです。ビジネス認証段階で拒否されないように、作成時に正確な会社情報を入力してください。
3.2. Meta デベロッパーとしての登録
Facebook アカウントを使用して Meta Developer Platform にアクセスし、デベロッパー登録プロセスを完了してください。これにより、Facebook アカウントが Meta デベロッパーアカウントに変換され、アプリケーションの作成に必要となります。
登録が完了すると、デベロッパープラットフォームのダッシュボードからアプリケーションを作成して管理できます。
3.3. Meta アプリケーションの作成
Meta の application creation ページに移動し、新しい Business アプリケーションを作成してください:
-
アプリケーションの詳細で、Application Name と Contact Email を入力し、Next をクリックしてください。
-
ユースケースで Other を選択し、Next をクリックしてください。
-
アプリケーションタイプで Business を選択し、Next をクリックしてください。
-
詳細で Application Name と Contact Email を確認し、ドロップダウンメニューから会社の business portfolio を選択してください。
-
Create Application をクリックしてください。
3.4. アプリケーション詳細の設定
アプリケーションを作成すると、アプリケーションダッシュボードに自動的にリダイレクトされます。左側メニューで App Settings > Basic をクリックし、次の情報を追加してください:
-
App Icon
サポートされる形式は JPG、GIF、または PNG です。画像サイズは 512×512~1024×1024 ピクセルで、ファイルサイズは 5 MB を超えないようにしてください。
-
Privacy Policy URL
会社のプライバシーポリシーの URL です。このリンクは登録時に顧客に表示されます。
-
Category
カテゴリのドロップダウンメニューから Messaging を選択します。
-
ページ下部で Add Platform をクリックし、アプリケーションを使用するプラットフォーム (例:Website) を選択して、関連設定を行ってください。
-
Save Changes をクリックしてください。
3.5. WhatsApp 製品の追加
この操作は、WhatsApp がサポートされている国または地域のネットワークから実行する必要があります。そうでない場合、WhatsApp アプリケーションカードが表示されません。
左側メニューで Products > Add Product をクリックし、WhatsApp アプリケーションを見つけて Set up をクリックしてください。
Quick Start パネルが表示されるまでセットアッププロセスを完了してください。
3.6. 技術プロバイダーとしての登録
-
Grow Your Business セクションで Get Started ボタンをクリックし、画面の指示に従ってください。
-
Work with a Solution Partner を選択してください。
3.7. ビジネス認証の完了
すでにビジネス認証が完了している場合は、この手順をスキップできます。
Start Verification を選択してビジネス認証を完了してください。このプロセスには通常 2~5 営業日かかります。認証に失敗した場合は、Meta からのフィードバックに基づいて再提出できます。審査中は、Business Information パネルで認証ステータスを確認できます。
3.8. パートナーソリューションの作成
Quick Start > Registration パネルの App Review セクションで Create Partner Solution に移動し、Create Partner Solution ボタンをクリックしてください:
-
Solution Name を追加してください。
-
Chat App Message Service の App ID として
324633502517598を入力してください。 -
Permission Configuration > Send Messages で Partner Only を選択してください。
重要Chat App Message Service は、Partner Only に設定されたソリューションリクエストのみを受け付けます。パートナーソリューションが拒否されないよう、正しいオプションを選択してください。
-
Send Request ボタンをクリックしてください。
パートナーソリューションが作成され、Chat App Message Service に送信されます。サービスがリクエストを受理するまで待機してください。受理されると、ソリューションのステータスがアクティブに変わります。ソリューション ID をコピーし、埋め込み登録の設定に追加してください。
その後、次の操作に進むことができます。
3.9. アプリレビューの準備
アプリレビューは、アプリケーションが特定の WhatsApp 機能にアクセスするために必要な手順です。Meta の審査チームが提出内容を確認し、承認するか、追加情報を要求するかを判断します。
-
Quick Start > Onboarding パネルで、アプリケーションを審査する設定を見つけて該当するボタンをクリックしてください。表示されるウィンドウで、アプリケーションの詳細が正しいことを確認してください。
-
動画を録画してください。アプリレビューの一環として、次の 2 つの動画を提出する必要があります:
-
1 つ目の動画:アプリケーションからメッセージを作成して送信し、そのメッセージが WhatsApp クライアント (モバイルまたは Web アプリ) で受信される様子を示します。
-
2 つ目の動画:アプリケーション内でメッセージテンプレートを作成するプロセスを示します。
-
Meta の 画面録画ガイドを参照し、録画時は次の点に注意してください:
-
アプリケーションの UI 言語を英語に設定してください。
-
UI 言語が英語でない場合は、字幕とプロンプトを用意してください。
-
高解像度 (1080p 以上を推奨) で録画してください。
-
録画中は、幅が 1440 ピクセルを超えないようにモニターの解像度を下げてください。
3.10. 審査へのアプリケーション提出
Quick Start > App Review > Request ページに、保留中のアプリレビューリクエストが表示されます。Edit ボタンをクリックして、審査プロセスにアクセスしてください。
アプリケーションが法人顧客データをどのように使用するか、また whatsapp_business_messaging および whatsapp_business_management 権限に対して高度なアクセスが必要な理由を説明する必要があります。
各権限でのアプリケーションの使用方法を説明する際は、前の手順で作成した画面録画または動画を添付してください:
-
whatsapp_business_messaging:アプリケーションがメッセージを送信し、そのメッセージが WhatsApp クライアントに表示される様子を示す画面録画または動画をアップロードしてください。 -
whatsapp_business_management:アプリケーションがメッセージテンプレートを作成する様子を示す画面録画、または WhatsApp Manager を使用してメッセージテンプレートを作成する様子を示す画面録画をアップロードしてください。
プロセスを完了してリクエストを送信してください。Meta はメールおよびデベロッパー通知で審査結果を送信し、ステータスは App Review > Requests パネルで更新されます。
3.11. アクセス検証の完了
このプロセスでは、技術プロバイダーの基準を満たしていることを確認するために、会社に関する基本情報を収集します。
Quick Start > Onboarding パネルで、アクセス検証を完了する行を見つけ、Start Verification ボタンをクリックして、プロセスを完了し審査に提出してください。
3.12. ステータスの確認
前述の手順が完了すると、Quick Start > Onboarding パネルで全手順が完了 (緑色のチェックマークで表示) となり、技術プロバイダーになったことが確認できます。
技術プロバイダーになる前に Chat App Message Service または CPaaS で顧客の WABA を作成していた場合、技術プロバイダーのステータス取得後に、これらの WABA はアプリケーションに移行されます。移行が完了すると、顧客には Meta から確認メールが送信されます。顧客はメール内のボタンをクリックしてリクエストを承認できます。承認されない場合でも、90 日後にリクエストは自動的に承認されます。
4. 法人顧客のオンボーディング
技術プロバイダーとして確認されたら、法人顧客のオンボーディングを開始できます。顧客は埋め込み登録を完了し、WhatsApp アセットへのアクセスを、あなたと Chat App Message Service に付与する必要があります。
4.1. Facebook Login for Business の設定
顧客をオンボーディングする前に、Facebook Login for Business 製品を作成し、顧客が Facebook アカウントでログインできるように権限を設定する必要があります。
-
Facebook Login for Business > Configure をクリックし、Create Configuration を選択してください。
-
Name フィールドに Configuration Name を入力し、Next をクリックしてください。
-
Login Method で WhatsApp Embedded Signup を選択し、Next をクリックしてください。
-
Access Token で 60 days を選択し、Next をクリックしてください。
-
Select Assets で WhatsApp Account を選択し、Next をクリックしてください。
-
Permissions で
whatsapp_business_managementとwhatsapp_business_messagingを選択してください。 -
Create ボタンをクリックし、Configuration ID をコピーしてください。
4.2. ログイン認可の管理
Facebook Login for Business > Settings > Client OAuth Settings に移動し、次のトグルを Yes に設定してください:
-
Client OAuth login
-
Web OAuth login
-
Enforce HTTPS
-
Embedded browser OAuth login
-
Use strict mode for redirect URIs
-
Login with JavaScript SDK
Valid OAuth redirect URIs と Allowed Domains for the JavaScript SDK フィールドにドメインを追加し、Save Changes ボタンをクリックしてください。
4.3. 埋め込み登録の追加
-
Facebook JavaScript SDK の読み込み
Facebook JavaScript SDK は、ファイルのダウンロードやインストールは不要です。ページ上で SDK を非同期に読み込むために、HTML に標準の短い JavaScript スニペットを追加するだけです。
<script> window.fbAsyncInit = function() { FB.init({ appId : '<APP_ID>', autoLogAppEvents : true, xfbml : true, version : 'v23.0' }); }; </script> <script async defer crossorigin="anonymous" src="https://connect.facebook.net/en_US/sdk.js"> </script> -
埋め込み登録の設定
埋め込み登録コードの起動メソッドとコールバック登録セクションで、ソリューション ID を
extras.setupオブジェクト内のsolutionIDプロパティに割り当ててください。// 起動メソッドとコールバック登録 const launchWhatsAppSignup = () => { FB.login(fbLoginCallback, { config_id: '<CONFIGURATION_ID>', // ここに設定 ID を指定します。必ず引用符で囲んでください response_type: 'code', override_default_response_type: true, extras: { setup: { solutionID: '<SOLUTION_ID>' // ここにソリューション ID を追加します。必ず引用符で囲んでください }, featureType: '', sessionInfoVersion: '3', } };
設定後、プラットフォーム上の適切な場所で、カスタムの埋め込み登録フローを顧客に提示してください。
顧客が埋め込み登録ページで登録を完了したら、Chat App Message Service API の呼び出しを開始できます。
5. CPaaS を使用したクイック登録
CPaaS プラットフォームを使用して技術プロバイダーとして迅速に登録するには、最初に CPaaS サービスを有効化する必要があります。完了が必要なのは、3.1. ビジネスポートフォリオの作成、3.2. Meta デベロッパーとしての登録、3.7. ビジネス認証の完了のみです。その後、Meta アプリケーションへのアクセス権限を当社に付与できます。以降は当社が、Meta アプリケーションの作成、詳細設定、WhatsApp 製品の追加、アプリレビューの準備と提出、アクセス検証の完了など、技術プロバイダー登録プロセスの残りを代行します。必要なアプリケーション情報のみをご提供ください。
代行登録を当社に許可する前に、ビジネスマネージャーまたはテクニカルサポートに連絡してサポート担当者のメールアドレスを取得してください。次に、以下の手順に従って WhatsApp Business Manager でアプリケーション権限を付与してください:
-
WhatsApp Business Manager の右上で Invite People をクリックしてください。
-
Add People セクションで、サポート担当者の email アドレスを入力してください。
More settings で Temporary access トグルを有効にし、Next をクリックできます。
-
Assign access セクションで、Partial access の下にある Apps and integrations を有効にしてください。
full control の下にある Everything を有効にしてください。
-
Assign business assets セクションで、Select asset type 列から Apps を選択し、Select Assets 列から許可するアプリケーションを選択してください。
-
Check invitation information セクションで、詳細を確認してください。
その後、サポート担当者が残りの技術プロバイダー登録手順を代行します。プロセスが完了すると、埋め込み登録ページを通じて CPaaS で顧客のオンボーディングを開始できます。顧客が埋め込み登録を使用すると、アプリケーションアイコンが表示されます。ページは Facebook OAuth 認可画面にリダイレクトされ、そこで WhaleCloud アプリケーションがユーザーの名前とプロフィール写真へのアクセスを要求します。青色の Continue as... ボタンをクリックして認可を付与するか、Cancel をクリックして拒否できます。
埋め込み登録ページでは、技術プロバイダーとしてあなたがアクセスできる権限に加え、Alibaba Cloud の権限も表示されます。
埋め込み登録の認可ページには、タイトルとして Connect your account to WhaleCloud's Market が表示されます。権限リストには 2 つの項目が含まれます:WhatsApp Business account access (電話番号の追加またはリンク、メッセージテンプレートの作成、メッセージの送受信、ユーザーの割り当て、メトリクスへのアクセス) と billing management permission (Alibaba Cloud Singapore がクレジット枠を紐付け、直接課金することが許可されます)。ページ下部には、WhatsApp Business Terms of Service、Meta Terms of Service、Business Tool Terms へのリンクがあります。青色の Get Started ボタンは右下にあります。
6. よくある質問
6.1. WhatsApp アプリケーションカードが見つからない
Meta では、サポート対象の国または地域からのみ WhatsApp アプリケーションへのアクセスと追加が許可されています。これらの場所のいずれかのネットワークからこの操作を実行するか、テクニカルサポートに連絡して、サポート担当者が支援できるよう権限を付与してください。
6.2. 既存顧客の WABA の移行
技術プロバイダーになった後、テクニカルサポートに連絡して、顧客の WABA を自社のアプリケーションに移行するよう依頼してください。移行は Chat App Message Service によって開始されます。完了すると、顧客には Meta から確認メールが送信されます。顧客はメール内のボタンをクリックして移行を承認できます。承認されない場合でも、90 日後に自動的に承認されます。
6.3. ビジネス認証が失敗した理由
Meta は、法人に対して真正かつ検証可能な資格情報を求めています。承認される可能性を高めるために、提供する情報がビジネスライセンスおよび会社メールアドレスと一致していることを確認してください。
6.4. パートナーソリューションリクエストが保留中
パートナーソリューションリクエストを送信した後は、Chat App Message Service がリクエストを受理するまで待つ必要があります。通常 2~3 営業日かかります。長期間保留のままの場合は、テクニカルサポートに連絡して状況を確認してください。
6.5. パートナーソリューションリクエストが拒否された
Chat App Message Service は、権限が Partner Only に設定されたパートナーソリューションリクエストのみを受け付けます。リクエストが拒否された場合は、新しいパートナーソリューションを作成し、権限設定で Partner Only を選択してください。詳細については、「3.8. パートナーソリューションの作成」をご参照ください。