[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将验证签名,捕获原始有效负载作为体验事件,并将其添加到您的WhatsApp数据集。
先决条件 prerequisites
在创建WhatsApp源连接之前,请在Meta的developers.facebook.com上完成以下操作:
- 创建 Business 类型的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权限的令牌以及对WABA的访问权限。 将{VERSION}替换为当前的Graph API版本,例如v21.0或更高版本。
连接器自动设置的内容 automatic-provisioning
完成创建WhatsApp数据流时,连接器将创建并连接以下实体。 您自己不选择目标数据集或映射字段。
X-Hub-Signature-256签名验证和验证令牌握手。旋转密钥 rotate-secrets
您可以随时通过更新连接来轮换您的应用程序密钥或验证令牌。 Platform支持主密钥和次密钥,因此您可以滚动应用程序密钥而无需停机。 将新值添加为主要密码,同时在过渡期间将上一个值保留为次要密码。 更新连接会将更改应用于使用它的所有数据流。
故障排除 troubleshooting
下表介绍了常见问题以及如何解决这些问题。
将WhatsApp连接到Experience Platform connect-to-platform
以下文档提供了有关如何创建WhatsApp流连接器以使用用户界面连接到Experience Platform的信息: