IBM Cloud Docs
WhatsApp 整合

WhatsApp 整合

IBM Cloud

与 WhatsApp 消息传递集成,以便助手可以与客户就地交换消息。

许多客户使用的是 WhatsApp,因为它能免费提供快速、简单、安全的消息传递,可在世界各地通过电话使用。 WhatsApp 使用电话因特网连接来发送消息,这样客户就无需支付 SMS 费用。

此集成使用 Twilio 作为提供者,在助手与 WhatsApp 之间创建连接。

准备工作

要将 Whatsapp 与助手集成,您必须有权访问 Twilio 和至少一个开发者角色。 有关更多信息,请参阅 Twilio 的角色差异

  1. 转至 Twilio Web 站点

  2. 创建一个帐户。

  3. 开发 选项卡中,单击 电话号码

  4. 按照指示信息来获取电话号码。

    获得 Twilio 电话号码后,它会自动支持语音、SMS 和 MMS。 新电话号码会列为活动号码。 请考虑供应多个电话号码,并执行用于获取并行号码许可权的过程。 如果您的号码先前已由其他企业使用(例如,因为 Twilio 为您分配的是先前使用过的号码),那么 WhatsApp 会拒绝该号码。

使 Twilio Web 页面在 Web 浏览器选项卡中保持打开,以便稍后可以再次参考该页面。

WhatsApp启用Twilio号码的权限

WhatsApp 对希望与其网络客户互动的所有企业进行严格审查。 WhatsApp, 由Meta(前身为Facebook)所有,要求您在Meta企业名录中注册您的企业。

  1. 要注册,请前往 元业务工具页面,点击 “创建新账户”。 遵循指示信息以创建帐户。

  2. 获取您的Meta Business Manager ID。 在 “设置”中,点击 “业务信息” 选项卡。 业务经理ID位于页面顶部。

  3. 使用 WhatsApp网页启用您的Twilio号码,这是Meta官方支持的唯一途径,用于在2025年1月1日之前将您的客户引入 WhatsApp。 更多信息,请参阅 WhatsApp供应商计划概述 》。

    用于指定以下值的提示:

    • Twilio 账户 SID:在 Twilio 网站上,点击主页图标进入项目仪表板,找到 SID。

    • 元业务经理ID:添加您在之前步骤中创建的账户的ID。

    • 你们是否为客户提供自助服务选择编号 通过采用技术提供商计划,您的客户将使用Meta的 WhatsApp产品登录 WhatsApp。

  4. 单击提交

请耐心等待 WhatsApp 会评估并批准您的提交。 核准请求可能最长需要 7 天。

设置集成

要设置集成,请完成以下步骤:

  1. 通过单击左侧菜单中的集成图标 (集成图标),转至“集成”页面。

  2. 单击 具有 Twilio 的 WhatsApp 磁贴上的 添加

  3. 请单击确认

  4. 从 Twilio 站点,单击左上方菜单中的帐户名称以转至帐户仪表板。

    复制以下值并临时保存,以便在接下来的步骤中将其粘贴到集成 Twilio 的 WhatsApp中。

    • 帐户 SID
    • 认证令牌
  5. 返回到集成Twilio WhatsApp 设置页面。 单击 下一步 以转至 WhatsApp with Twilio 集成设置的步骤 1。

  6. 请输入您的账户SID 信息。 单击 下一步 以转至 WhatsApp with Twilio 集成设置的步骤 2。

  7. 输入 认证令牌 信息。 单击 下一步 以转至 WhatsApp with Twilio 集成设置的步骤 3。

  8. 从Webhook URI字段复制值。

    您可以在以下部分中使用此 Webhook URI 来测试集成。

  9. 单击完成

如果更改了认证所需的字段,那么必须再次填充并验证相关字段中的所有条目。

测试集成

在等待 WhatsApp 批准您的提交时,您可以使用Twilio沙盒测试集成。 使用沙盒,您可以使用预先配置的共享 Twilio 测试号码,向加入沙盒的号码发送和接收预先批准的模板消息。

不要在生产环境中使用 Twilio 沙箱。 沙箱会话将在 3 天后到期。

  1. 要创建沙盒,请访问 Twilio控制台网页,并使用您的Twilio凭据登录。 这将显示激活沙箱提示。 请同意创建沙箱,并确认您的选择。

  2. 按照指示信息来创建沙箱。

  3. 通过将 WhatsApp 消息从设备发送到沙箱电话号码来连接到沙箱。

  4. 开发 选项卡中,单击 消息传递> 设置> WhatsApp 沙箱设置

  5. 沙盒配置部分,将之前复制的webhook URI粘贴到 “当有消息进来时”字段中。 单击保存

  6. 可以通过将消息从 WhatsApp 发送到分配给 Twilio 沙箱的共享电话号码来测试集成。

如需完整、详细的信息,请参阅 WhatsApp入门 》。

完成产品集成

WhatsApp 授予访问权限并允许WhatsApp后,更新集成,使用您的专用Twilio电话号码代替沙盒号码。

  1. WhatsApp with Twilio 集成设置页面,滚动到 基本设置 选项卡的 Webhook 部分。 复制 WhatsApp Webhook 字段中的值。

  2. 转到您的Twilio账户网页,添加复制到Twilio配置中的webhook,以完成Twilio WhatsApp连接。

让客户快速联系到您的助理

您可以向 Web 页面添加一个图标,供客户单击以通过 WhatsApp 启动与助手的交谈。

要向 Web 页面添加图标,请完成以下步骤:

  1. WhatsApp with Twilio 集成设置页面中,单击单击以聊天选项卡。

  2. 预填信息栏中,添加您希望 WhatsApp 发送给助理的文本,以便助理代表客户开始对话。

    指定您确信助手可以通过有用的方式应答的消息。

  3. 复制嵌入链接,并将其添加到您的网页中。 请考虑在图标前面添加用于说明图标用途的文本。 例如,您可以在图标 <span> 元素前添加一个 <span> HTML标签,显示为 Have a question? Ask watsonx Assistant for help

    当用户点击您网页上的图标时,会打开一个与您的助手连接的 WhatsApp会话,并将您指定的文本添加到用户的文本字段中,随时可以提交。

操作注意事项

为了获得最佳的客户体验,请WhatsApp设计您的操作:

  • 包含超过 1,600 个字符的文本响应会拆分成多个响应。
  • 不要在文本响应中包含 HTML 元素。
  • 集成Twilio WhatsApp 不支持以 “连接到客服”响应类型发起的聊天转移。
  • 如果使用 Markdown 语法,请参阅支持的 Markdown 语法表。
  • 要在文本响应中包含超文本链接,请直接指定 URL。 不要对链接使用 Markdown 语法。 例如,请指定Contact us at https://www.ibm.com.
支持的 Markdown 语法
格式 语法 示例
斜体 We're talking about _practice_. 我们正在讨论实践
粗体 There's *no* crying in baseball. 在棒球比赛中,不许哭泣。