[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将验证签名,捕获原始有效负载作为体验事件,并将其添加到您的WhatsApp数据集。

先决条件 prerequisites

在创建WhatsApp源连接之前,请在Meta的developers.facebook.com上完成以下操作:

  • 创建​ Business ​类型的Meta应用,并将​ WhatsApp ​产品添加到其中。
  • 创建具有注册电话号码的WhatsApp商业帐户(WABA)。
  • 确保应用程序具有whatsapp_business_management和whatsapp_business_messaging权限。
  • 从​应用程序设置 > 基本,复制您的应用程序密钥。 Meta使用应用程序密钥对webhook负载进行签名。
  • 选择验证令牌。 它可以是任何字符串,并且是您在Platform和Meta中输入的共享密钥。

下表描述了在何处查找每个凭据及其用途。

凭据
从何处获得
用于
应用程序密钥
Meta > 应用程序设置 > 基本
正在验证每个入站webhook上的X-Hub-Signature-256签名。
验证令牌
由您选择
Meta与Platform之间的一次性验证握手。

将应用程序订阅到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权限的令牌以及对WABA的访问权限。 将{VERSION}替换为当前的Graph API版本,例如v21.0或更高版本。

连接器自动设置的内容 automatic-provisioning

完成创建WhatsApp数据流时,连接器将创建并连接以下实体。 您自己不选择目标数据集或映射字段。

实体
名称或标识符
已创建或已重用
注释
架构
WhatsApp Webhook原始事件(XDM ExperienceEvent类)
如果存在则重用,否则每个沙盒创建一次
沙盒中的第一个WhatsApp数据流创建它。 之后的每个数据流都重用相同的架构。
字段组
WhatsApp Webhook有效负载V2
已重用(标准)
连接器引用现有的标准字段组。 它从来不创造一个。
数据集
WhatsApp Webhook原始活动
为每个数据流创建
入站消息的原始登陆体验事件数据集。
字段映射
系统生成
为每个数据流创建
将原始webhook有效负载映射到架构中,并作为转换连接到数据流中。
流端点(入口)
显示为回调URL
为每个数据流创建
强制执行X-Hub-Signature-256签名验证和验证令牌握手。
目标(数据湖)连接
系统生成
为每个数据流创建
将映射的数据路由到数据集。

旋转密钥 rotate-secrets

您可以随时通过更新连接来轮换您的应用程序密钥或验证令牌。 Platform支持主密钥和次密钥,因此您可以滚动应用程序密钥而无需停机。 将新值添加为主要密码,同时在过渡期间将上一个值保留为次要密码。 更新连接会将更改应用于使用它的所有数据流。

故障排除 troubleshooting

下表介绍了常见问题以及如何解决这些问题。

症状
可能的原因和修复
Platform中的所有组件看起来正常,但未摄取任何数据。
应用程序未订阅WABA。 完成将应用程序订阅到WABA中所述的WABA订阅。 这是最常见的原因,并且会无提示地失败。 如果已订阅应用程序,请确认Platform中的应用程序密钥与Meta中​应用程序设置 > 基本​下的当前应用程序密钥相匹配。
在Meta中,“验证并保存”失败。
Meta中的验证令牌必须与在Platform中输入的验证令牌完全匹配。

将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