[Beta]{class="badge informative"}

WhatsApp

NOTE
WhatsApp來源是測試版。 閱讀來源概觀,瞭解使用Beta標籤聯結器的詳細資訊。
IMPORTANT
此來源為私人測試版,僅供有限數量的客戶使用。 請聯絡您的 Adobe 代表以請求存取權。

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:

  1. 客戶傳送訊息至您的WhatsApp Business電話號碼。
  2. Meta使用您的應用程式密碼(X-Hub-Signature-256)簽署webhook裝載,並將其傳送至您在Platform串流端點上設定的回呼URL。
  3. Platform會驗證簽章,擷取原始裝載當作Experience事件,並將其新增至您的WhatsApp資料集。

先決條件 prerequisites

建立WhatsApp來源連線之前,請先在Meta的developers.facebook.com完成下列專案:

  • 建立​ 企業 ​型別的Meta應用程式,並將​ WhatsApp ​產品加入其中。
  • 使用註冊的電話號碼建立WhatsApp商業帳戶(WABA)。
  • 確定應用程式具有whatsapp_business_management和whatsapp_business_messaging許可權。
  • 從​應用程式設定 > 基本,複製您的應用程式機密。 Meta使用應用程式密碼簽署webhook裝載。
  • 選擇驗證權杖。 機密可以是任何字串,而且是您在Platform和Meta上輸入的共用機密。

下表說明要在何處尋找每個證明資料及其用途。

認證
從何處取得
用於
應用程式機密
Meta > 應用程式設定 > 基本
正在驗證每個傳入webhook上的X-Hub-Signature-256簽章。
驗證權杖
由您選擇
Meta和平台之間的一次性驗證交握。

將應用程式訂閱至WABA subscribe-app

訂閱您的Meta應用程式至WhatsApp商業帳戶,讓Meta將WABA的事件路由至您的應用程式。 此為必要步驟,且會完全在Meta上進行,但只有在您設定回撥URL後,才會開始傳遞。 請參閱將WhatsApp Business連線至Experience Platform。

IMPORTANT
如果您略過此步驟,訊息永遠不會傳遞,而且Platform中未顯示任何錯誤。 遺失WABA訂閱是「未擷取任何資料」問題最常見的原因。 請參閱疑難排解。

使用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資料流時,聯結器會建立並連線下列實體。 您沒有自行選取目標資料集或對應欄位。

實體
名稱或識別碼
已建立或已重複使用
附註
結構描述
WhatsApp Webhook原始事件(XDM ExperienceEvent類別)
若存在則重複使用,否則每個沙箱建立一次
沙箱中的前WhatsApp個資料流會建立它。 之後的每個資料流都會重複使用相同的結構描述。
欄位群組
WhatsApp Webhook裝載V2
重複使用(標準)
聯結器會參考現有的標準欄位群組。 它永遠不會建立一個。
資料集
WhatsApp Webhook原始活動
根據資料流建立
傳入訊息的原始登陸體驗事件資料集。
欄位對應
系統產生
根據資料流建立
將原始webhook裝載對應到結構描述,並作為轉換連線到資料流。
串流端點(入口)
顯示為回呼URL
根據資料流建立
強制執行X-Hub-Signature-256簽章驗證與驗證Token交握。
目標(資料湖)連線
系統產生
根據資料流建立
將對應資料路由傳送到資料集。

旋轉密碼 rotate-secrets

您可以隨時更新連線,輪換您的應用程式密碼或驗證Token。 Platform支援主要和次要密碼,因此您可以滾動應用程式密碼而不需要停機。 新增值作為主要密碼,同時保留先前的值作為轉換期間的次要密碼。 更新連線會將變更套用至使用它的所有資料流。

疑難排解 troubleshooting

下表說明常見問題以及如何解決這些問題。

症狀
可能的原因和修正
Platform中的所有專案看起來都很健康,但是沒有擷取任何資料。
應用程式未訂閱WABA。 完成將應用程式訂閱至WABA中所述的WABA訂閱。 這是最常見的原因,且會在無訊息的情況下失敗。 如果已訂閱應用程式,請確認Platform中的應用程式密碼符合Meta中​應用程式設定 > 基本​下的目前應用程式密碼。
在Meta中,驗證並儲存失敗。
Meta中的驗證Token必須與在Platform中輸入的驗證Token完全相符。

將WhatsApp連線至Experience Platform connect-to-platform

以下檔案提供如何建立WhatsApp串流聯結器,以使用使用者介面與Experience Platform連線的資訊:

使用UI連線WhatsApp至Experience Platform connect-to-platform-using-ui

其他資源 additional-resources

recommendation-more-help
experience-platform-help-sources