[Beta]{class="badge informative"}
Adobe Experience Platform 讓您可以從外部來源擷取資料,同時可以使用 Experience Platform 服務來建立、加標籤,同時強化傳入資料。 您可以從多種來源(例如Adobe應用程式、雲端儲存、資料庫和許多其他來源)內嵌資料。
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使用您的應用程式密碼(
X-Hub-Signature-256)簽署webhook裝載,並將其傳送至您在Platform串流端點上設定的回呼URL。 - Platform會驗證簽章,擷取原始裝載當作Experience事件,並將其新增至您的WhatsApp資料集。
先決條件 prerequisites
建立WhatsApp來源連線之前,請先在Meta的developers.facebook.com完成下列專案:
- 建立 企業 型別的Meta應用程式,並將 WhatsApp 產品加入其中。
- 使用註冊的電話號碼建立WhatsApp商業帳戶(WABA)。
- 確定應用程式具有
whatsapp_business_management和whatsapp_business_messaging許可權。 - 從應用程式設定 > 基本,複製您的應用程式機密。 Meta使用應用程式密碼簽署webhook裝載。
- 選擇驗證權杖。 機密可以是任何字串,而且是您在Platform和Meta上輸入的共用機密。
下表說明要在何處尋找每個證明資料及其用途。
X-Hub-Signature-256簽章。將應用程式訂閱至WABA subscribe-app
訂閱您的Meta應用程式至WhatsApp商業帳戶,讓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許可權的Token以及對WABA的存取權。 以目前的Graph API版本取代{VERSION},例如v21.0或更新版本。
聯結器自動布建的內容 automatic-provisioning
當您完成建立WhatsApp資料流時,聯結器會建立並連線下列實體。 您沒有自行選取目標資料集或對應欄位。
X-Hub-Signature-256簽章驗證與驗證Token交握。旋轉密碼 rotate-secrets
您可以隨時更新連線,輪換您的應用程式密碼或驗證Token。 Platform支援主要和次要密碼,因此您可以滾動應用程式密碼而不需要停機。 新增值作為主要密碼,同時保留先前的值作為轉換期間的次要密碼。 更新連線會將變更套用至使用它的所有資料流。
疑難排解 troubleshooting
下表說明常見問題以及如何解決這些問題。
將WhatsApp連線至Experience Platform connect-to-platform
以下檔案提供如何建立WhatsApp串流聯結器,以使用使用者介面與Experience Platform連線的資訊: