[ベータ版]{class="badge informative"}
Adobe Experience Platform を使用すると、データを外部ソースから取得しながら、Experience Platform サービスを使用して、受信データの構造化、ラベル付け、拡張を行うことができます。 アドビのアプリケーション、クラウドベースのストレージ、データベースなど、様々なソースからデータを取り込むことができます。
Experience Platformでは、ストリーミングアプリケーションからデータを取り込む機能をサポートしています。 メッセージングプロバイダーのサポートにはWhatsAppが含まれます。
WhatsApp Businessは、ビジネスがWhatsAppを通じて顧客とコミュニケーションを取るために使用するメッセージ プラットフォームです。 WhatsApp ソースは、お客様がWhatsApp Businessの電話番号に送信するインバウンドメッセージをほぼリアルタイムでExperience Platformにストリーミングします。
Metaは、各メッセージをPlatform ストリーミングエンドポイント（Webhook）に配信します。このエンドポイントは、生のエクスペリエンスイベントレコードとしてキャプチャされ、ダウンストリームで使用するためにデータレイクのデータセットに追加されます。 コネクターは生のWebhook ペイロードをそのまま取り込むため、WhatsApp個のメッセージタイプはすべて保持されます。
コネクタの仕組み how-it-works
WhatsApp ソースは、次の順序に従ってメッセージをExperience Platformに取り込みます。
- お客様がWhatsApp Businessの電話番号にメッセージを送信します。
- Metaは、App Secret （
X-Hub-Signature-256）でWebhook ペイロードに署名し、Platform ストリーミングエンドポイントで設定したコールバック URLに送信します。 - Platformは署名を検証し、生のペイロードをエクスペリエンスイベントとしてキャプチャし、それをWhatsApp データセットに追加します。
前提条件 prerequisites
WhatsApp ソース接続を作成する前に、developers.facebook.comのMetaで次の手順を実行します。
- Business型のMeta アプリを作成し、WhatsApp商品を追加します。
- 登録済みの電話番号でWhatsApp ビジネス アカウント （WABA）を作成します。
- アプリに
whatsapp_business_managementおよびwhatsapp_business_messaging権限があることを確認してください。 - アプリ設定 > 基本から、アプリの秘密鍵をコピーします。 Metaは、App Secretを使用してWebhook ペイロードに署名します。
- 「Verify Token」を選択します。 任意の文字列を指定でき、PlatformとMetaの両方に入力する共有秘密です。
次の表に、各資格情報の検索場所と使用目的を示します。
X-Hub-Signature-256署名を検証しています。アプリをWABAに登録する subscribe-app
Meta アプリをWhatsApp Business Accountに登録して、MetaがWABAのイベントをアプリにルーティングするように設定します。 この手順は必須で、Metaですべて実行されますが、配信はコールバック URLを設定した後にのみ開始されます。 WhatsApp BusinessをExperience Platformに接続を参照してください。
Graph APIを使用してアプリを購入します。
POST https://graph.facebook.com/{VERSION}/{WHATSAPP_BUSINESS_ACCOUNT_ID}/subscribed_apps
次の方法でサブスクリプションを確認します。
GET https://graph.facebook.com/{VERSION}/{WHATSAPP_BUSINESS_ACCOUNT_ID}/subscribed_apps
両方の呼び出しには、whatsapp_business_management権限を持つトークンと、WABAへのアクセスが必要です。 {VERSION}を現在のGraph API バージョン（例：v21.0以降）に置き換えます。
コネクタが自動的にプロビジョニングするもの automatic-provisioning
WhatsApp データフローの作成が完了すると、コネクタは次のエンティティを作成して配線します。 ターゲットデータセットを選択したり、自分でフィールドをマッピングしたりすることはありません。
X-Hub-Signature-256署名の検証とverify-token ハンドシェイクを適用します。シークレットを回転 rotate-secrets
接続を更新することで、いつでもアプリシークレットまたは検証トークンを回転できます。 Platformはプライマリおよびセカンダリ秘密鍵をサポートしているので、ダウンタイムなしでApp Secretをロールできます。 新しい値をプライマリシークレットとして追加し、移行中は前の値をセカンダリシークレットとして保持します。 接続を更新すると、その接続を使用するすべてのデータフローに変更が適用されます。
トラブルシューティング troubleshooting
次の表では、一般的な問題とその解決方法について説明します。
WhatsAppをExperience Platformに接続 connect-to-platform
以下のドキュメントでは、ユーザーインターフェイスを使用してExperience Platformと接続するためのWhatsApp ストリーミングコネクタを作成する方法について説明します。