[Beta 版]{class="badge informative"}

在用户界面中创建WhatsApp源连接

NOTE
WhatsApp源为测试版。 有关使用带有Beta标记的连接器的更多信息,请阅读源概述。

本教程提供了使用Adobe Experience Platform用户界面创建WhatsApp源连接的步骤。

快速入门 getting-started

本教程需要对以下Experience Platform组件有一定的了解:

先决条件 prerequisites

在创建WhatsApp源连接之前,请先完成WhatsApp源概述中的先决条件,包括向WABA订阅应用程序,并做好以下准备:

  • 您的Meta应用程序密钥
  • 您的验证令牌

第1步:创建帐户 create-account

在Experience Platform UI中,从左侧导航中选择​ 源 ​以访问源工作区。

转到​ 营销自动化 ​类别,选择WhatsApp源卡,然后选择​添加数据。

源目录的“营销自动化”类别中的WhatsApp源卡。

出现​ 身份验证 ​选项卡。 在此选项卡上,您可以使用新帐户或现有帐户。

创建新帐户

选择​ 新帐户 ​并提供以下信息。

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
字段 输入内容
帐户名称 此连接的名称。
描述​(可选) 帐户的简短描述。
验证令牌 您在先决条件中选择的验证令牌。 它是与Meta进行一次性webhook验证握手的共享密钥。
应用程序密钥(当前) 来自先决条件的Meta应用程序密钥。 用于验证入站Web挂钩上的X-Hub-Signature-256签名。
应用程序密钥(上一步) (可选) 以前的应用程序密钥,仅在密钥轮换期间使用,以便您可以滚动应用程序密钥而无需停机。

选择​ 连接到源 ​以验证和创建帐户,然后选择​下一步。 帐户可以在多个数据流中重用,因此每个帐户只输入一次这些凭据。

用于验证新WhatsApp帐户的新帐户界面,显示帐户名称、说明、验证令牌和应用程序密钥字段。

使用现有帐户

选择​现有帐户,选择要重用的帐户,然后选择​下一步。

现有的帐户界面,您可以在其中选择要重用的现有WhatsApp帐户。

步骤2:配置数据流 configure-dataflow

出现​ 数据流详细信息 ​选项卡。 输入​数据流名称、可选的​描述,并选择性地通过选择​源数据流运行开始、源数据流运行成功​或​ 源数据流运行失败 ​订阅警报。

NOTE
您不选择目标数据集或映射字段。 连接器会自动创建和分配数据集、架构和字段映射。

数据流详细信息选项卡,显示数据流名称、描述和警报订阅选项。

选择​下一步。

出现​ 审阅 ​选项卡。 查看连接和数据集分配,然后选择​完成。

审核选项卡,确认帐户已连接且已分配数据集。

步骤3:检索流端点 retrieve-streaming-endpoint

创建数据流后,转到其​ 数据流活动 ​页面,并查找​ 属性 ​面板的​ API使用情况 ​部分。 复制​ 流终结点 ​和​ 数据流ID ​值。

属性面板的“API使用情况”部分中的流终结点和数据流ID。

合并这两个值以生成您在Meta中输入的回调URL:{STREAMING_ENDPOINT}?x-adobe-flow-id={DATAFLOW_ID}。

步骤4:在Meta中配置webhook configure-webhook

在Meta中,转到​WhatsApp > Configuration​并完成以下步骤。

  1. 输入您在步骤3中构建的回调URL以及来自先决条件的相同验证令牌。
  2. 选择 Verify and Save。 Meta使用GET质询调用回调URL,Platform应答该质询以完成握手。
  3. 订阅messages webhook字段。

后续步骤 next-steps

通过学习本教程,您已配置一个流式数据流以将您的WhatsApp数据引入Experience Platform。 要监视正在摄取的数据,请参阅关于使用Experience Platform UI监视流式数据流的指南。

如果在发送测试邮件后未显示任何数据,请参阅WhatsApp源概述中的疑难解答。

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