返回开发者新闻

Integrating the WhatsApp Business Platform with HubSpot

2023年3月13日发布者:Rashed Talukder

HubSpot 是一个客户关系管理 (CRM) 平台,有助于组织更有效地推广、销售和支持他们的产品或服务。

借助 WhatsApp Business 开放平台,企业可以使用由 Meta 托管的云端 API,通过 WhatsApp 集成工具从其 CRM 直接与客户进行沟通交流。如此一来,企业可以轻松使用消息功能,而且可以实现与大多数现有技术堆栈的直接集成。

接下来,我们将介绍如何设置 WhatsApp Business 开放平台与 HubSpot 的集成,以及如何在 CRM 中创建工作流程,从而根据 HubSpot 平台上的事件和自定义规则从 WhatsApp 自动回复消息。

前提条件

为完成本教程的学习,您将需要:

  • WhatsApp Business 商业帐号。

  • Meta 开发者帐户。

  • HubSpot 应用开发者帐户(如需新建帐户,选择“应用开发者”帐户类型)。HubSpot 应用开发者帐户提供 HubSpot 的条款和条件列出的功能和服务,包括 HubSpot CRM API 的访问权限和应用创建功能。

  • 指向此 Glitch 示例应用中正在运行的实例的网址,以用于接收 WhatsApp Business Messenger 发送的消息。

本文假设您已熟悉 WhatsApp Business 开放平台、Meta 开发者平台和 HubSpot。

发送消息

第 1 步是设置您的帐户。具体操作如下:

  1. 创建 Facebook 开发者帐户;如果您已拥有该帐户,则直接登录。

  2. 完成官方“入门指南”文档中的“设置开发者资产和开放平台访问权限”步骤并发送测试消息

  3. 在云端 API 应用配置中添加您的电话号码

使用示例应用接收消息

我们需要使用一个端点来设置 Webhooks 和 Webhooks 订户网址,以便测试您的 Webhooks。为此,我们会用到上述示例应用

点击右上方的“整合编辑”按钮,以便能够编辑配置详细信息。

打开 .env 文件,将您的云端 API 访问口令粘贴至 WHATSAPP_TOKEN 字段中。对于 VERIFY_TOKEN 字段,您可以输入任何字符串,但要便于我们后续使用。

设置云端 API Webhooks

接下来,为 API 设置 Webhooks,以允许您的应用从 Meta 开发者应用面板开始订阅有关事件变更的更新或对事件变更的响应。点击 WhatsApp 的导航栏,然后在“入门指南”下依次点击“配置”和“编辑”。

在“编辑 Webhooks 的回调网址”对话框中,填写“回调网址”和“验证口令”字段。在回调网址中输入 https://<<PROJECT NAME>>.glitch.me,将 <<PROJECT NAME>> 替换为您项目的名称(例如 https://defiant-standing-mirror.glitch.me)。然后,验证网址是否与上述网址一致。

点击“验证并保存”。请参阅开发者指南,进一步了解 WhatsApp Webhooks 设置的有关详情。

“编辑 Webhooks 回调网址”页面

现在,您可以向该端点发送测试通知。

在同一页面的“编辑”按钮下,依次点击“Webhooks 字段”和“管理”,订阅您要通过该端点监听的事件。接下来,点击“测试”,向之前配置的收信人电话号码发送通知消息。

“Webhooks 字段”页面

如要验证应用是否正在运行和监听事件,请前往 Glitch,点击“记录”,查看您所选事件的记录。

“在 Glitch 中查看记录”页面

设置 HubSpot CRM

接下来您需要设置 HubSpot CRM,以便向联系人资料中包含电话号码的客户自动发送 WhatsApp 消息。

前往 HubSpot 平台,登录您的开发者帐户或创建一个帐户。开发者帐户提供 HubSpot 所有企业功能(包括营销、销售、服务和内容管理系统 (CMS))90 天免费试用,所以您可以测试 HubSpot API 和工具。

设置开发者帐户后,点击“Manage test accounts”(管理测试帐户)。

已使用开发者帐户登录 HubSpot CRM

然后选择“Create an app test account”(创建应用测试帐户),将帐户命名为 demo_whatsapp_integration(或您喜欢的任何名称)并点击“Create”(创建)。

“创建应用测试帐户”页面

点击新建的应用测试帐户,前往该帐户的面板。然后点击导航栏左上方的“Contacts”(联系人)。您将看到 2 个演示联系人。您可以随意移除这 2 个联系人,然后新增 1 个包含测试电话号码的联系人,以用于 WhatsApp 测试。

新建的应用测试帐户的面板

将 WhatsApp 与 HubSpot CRM 关联

接下来,我们需要安装一个与 HubSpot CRM 关联的 WhatsApp 集成工具。首先,前往 HubSpot 中的“Settings”(设置)。在“Account Setup”(帐户设置)下,依次点击“Integrations”(集成)和“Connected Apps”(已关联的应用)。

“已关联的应用”页面

选择“Visit App Marketplace”(访问应用市场)。使用搜索栏搜索 WhatsApp 应用程序。点击“WhatHub: WhatsApp Integration”(WhatHub:WhatsApp 集成工具)。

App Marketplace(应用市场)

选择 demo_whatsapp_integration 帐户,并点击“Choose Account”(选择帐户)。然后,在该联系人页面上的其他联系方式选项旁边,您就能看到 WhatsApp 图标。点击该图标,开始从 HubSpot CRM 发送消息。您可以使用自定义消息或预定义模板来发送消息。

WhatsApp 自定义消息

您还可以在“Activity”(动态)选项卡上看到一个由消息及消息状态构成的列表。

设置自动化工作流程

接下来,我们会将该集成纳入 CRM 中由事件触发的工作流程。为此,我们要在 HubSpot 面板设置一个自定义工作流程。点击导航栏中的“Automation”(自动化),然后点击“Workflows”(工作流程),打开“Workflow”(工作流程)面板。

点击“Create workflow”(创建工作流程)并选择“From scratch”(从零开始)选项。现在,依次点击“Contact-based”(基于联系人)和“Next”(下一步)。

“返回工作流程”页面

点击“Set up triggers”(设置触发条件),并选择“WhatHub: WhatsApp Integration: WhatsApp message sent from HubSpot portal”(WhatHub:WhatsApp 集成工具:从 HubSpot 网站发送的 WhatsApp 消息)集成事件选项。

“设置触发条件”页面

选择“Message sent”(已发送消息)筛选条件类型,将工作流程触发条件设置为“is equal to any of”(等于以下任何一项),并将值指定为“Buy item”(购买商品)。最后,点击“Apply filter”(应用筛选条件),然后点击“Save”(保存)。

接下来,点击“+”图标,添加另一个操作。在“Choose an action”(选择一个操作)列表中,点击“Create task”(创建任务)。

“选择一个操作”页面

将该任务命名为“Test Task”(测试任务),将其分配给您的测试帐户,然后点击“Save”(保存)。接下来,点击“Review”(审核),发布任务,然后点击窗口右上角的“Turn on”(打开),从而打开工作流程。

“打开工作流程”页面

现在,选择“Test”(测试)并选择您的测试联系人,以测试工作流程。此操作会触发该工作流程,如下所示。

“选择您的测试联系人”页面

接下来,我们将创建一个集成,用于监听 WhatsApp 并在收到通知时自动更新 HubSpot CRM 中的数据。在设置工作流程之前,我们需要将测试联系人添加至列表中。依次点击“Contacts”(联系人)和“Lists”(列表),以新建列表。

创建列表后,前往“Workflow”(工作流程)页面,新建一个工作流程,并将其命名为“WhatsApp Automation”(WhatsApp 自动化)。

选择“Contact-based lists”(基于联系人的列表),添加列表名称,然后选择“Static list”(静态列表)。依次点击“Next”(下一步)和“+ Add filter”(+ 添加筛选条件)按钮。

现在,从“Add filter”(添加筛选条件)列表中选择“List membership”(列表成员),将其添加为筛选条件,然后点击“Save list”(保存列表)。

“添加筛选条件”页面

现在,您可以继续设置工作流程。选择“Contact-based”(基于联系人),然后将“Contact enrollment trigger”(联系人注册触发)添加至“List membership”(列表成员)。

“联系人注册触发”页面

创建一个任务,将其设置为在该工作流程被启用时触发。确认该任务已显示在“Actions”(操作)时间线上,然后点击“Save”(保存)。

在“Choose an action”(选择一个操作)列表中,点击“Send a webhook”(发送 Webhooks)。

“发送 Webhooks”选项

接下来,为工作流程创建一个操作,以便在该工作流程被触发时,系统会将负载发送至端点。

“发送 Webhooks”页面

请务必使用您之前在此教程中设置的网址。点击“Save”(保存)。最后,按照之前的方式继续测试工作流程:打开“Test”(测试)列表,从“Preview for”(预览)列表中选择您的测试联系人,然后点击“Test”(测试)。该工作流程到此完成。

现在,我们来查看记录和“Actions”(操作)时间线。返回“Actions”(操作)时间线,查看已创建的任务。

记录和“Actions”(操作)时间线

如要查看记录,返回运行中的 Glitch 应用,查看“Logs”(记录),确认消息接收情况。

在 Glitch 应用中查看“Logs”(记录)

总结

通过将 WhatsApp Business 开放平台与 HubSpot 集成,您可以根据为事件和客户所采取操作而创建的规则,自动收发消息。

本文在分步教程中介绍了将这 2 项服务关联的方法,以向在 HubSpot 中具有注册详细信息的联系人发送 WhatsApp 消息。您可以设置相关自定义工作流程,以基于预定义事件触发操作。此外,您还可以设置一个工作流程,以将通知发送至之前设置的端点并开始一项新任务。

为确保消息正常传递并及时将相关的预期更新发送至客户,您应该注意消息的数量。请避免向用户发送垃圾消息,让客户满意且乐于参与消息互动。

如需了解更多可将 WhatsApp 集成至您应用和项目的方法,请参阅我们的其他开发者教程