WhatsApp 整合
IBM Cloud
与 WhatsApp 消息传递集成,以便助手可以与客户就地交换消息。
许多客户使用的是 WhatsApp,因为它能免费提供快速、简单、安全的消息传递,可在世界各地通过电话使用。 WhatsApp 使用电话因特网连接来发送消息,这样客户就无需支付 SMS 费用。
此集成使用 Twilio 作为提供者,在助手与 WhatsApp 之间创建连接。
准备工作
要将 Whatsapp 与助手集成,您必须有权访问 Twilio 和至少一个开发者角色。 有关更多信息,请参阅 Twilio 的角色差异。
-
转至 Twilio Web 站点。
-
创建一个帐户。
-
从 开发 选项卡中,单击 电话号码。
-
按照指示信息来获取电话号码。
获得 Twilio 电话号码后,它会自动支持语音、SMS 和 MMS。 新电话号码会列为活动号码。 请考虑供应多个电话号码,并执行用于获取并行号码许可权的过程。 如果您的号码先前已由其他企业使用(例如,因为 Twilio 为您分配的是先前使用过的号码),那么 WhatsApp 会拒绝该号码。
使 Twilio Web 页面在 Web 浏览器选项卡中保持打开,以便稍后可以再次参考该页面。
WhatsApp启用Twilio号码的权限
WhatsApp 对希望与其网络客户互动的所有企业进行严格审查。 WhatsApp, 由Meta(前身为Facebook)所有,要求您在Meta企业名录中注册您的企业。
-
要注册,请前往 元业务工具页面,点击 “创建新账户”。 遵循指示信息以创建帐户。
-
获取您的Meta Business Manager ID。 在 “设置”中,点击 “业务信息” 选项卡。 业务经理ID位于页面顶部。
-
使用 WhatsApp网页启用您的Twilio号码,这是Meta官方支持的唯一途径,用于在2025年1月1日之前将您的客户引入 WhatsApp。 更多信息,请参阅 WhatsApp供应商计划概述 》。
用于指定以下值的提示:
-
Twilio 账户 SID:在 Twilio 网站上,点击主页图标进入项目仪表板,找到 SID。
-
元业务经理ID:添加您在之前步骤中创建的账户的ID。
-
你们是否为客户提供自助服务? 选择编号 通过采用技术提供商计划,您的客户将使用Meta的 WhatsApp产品登录 WhatsApp。
-
-
单击提交。
请耐心等待 WhatsApp 会评估并批准您的提交。 核准请求可能最长需要 7 天。
设置集成
要设置集成,请完成以下步骤:
-
通过单击左侧菜单中的集成图标 (
),转至“集成”页面。
-
单击 具有 Twilio 的 WhatsApp 磁贴上的 添加。
-
请单击确认。
-
从 Twilio 站点,单击左上方菜单中的帐户名称以转至帐户仪表板。
复制以下值并临时保存,以便在接下来的步骤中将其粘贴到集成 Twilio 的 WhatsApp中。
- 帐户 SID
- 认证令牌
-
返回到集成Twilio WhatsApp 设置页面。 单击 下一步 以转至 WhatsApp with Twilio 集成设置的步骤 1。
-
请输入您的账户SID 信息。 单击 下一步 以转至 WhatsApp with Twilio 集成设置的步骤 2。
-
输入 认证令牌 信息。 单击 下一步 以转至 WhatsApp with Twilio 集成设置的步骤 3。
-
从Webhook URI字段复制值。
您可以在以下部分中使用此 Webhook URI 来测试集成。
-
单击完成。
如果更改了认证所需的字段,那么必须再次填充并验证相关字段中的所有条目。
测试集成
在等待 WhatsApp 批准您的提交时,您可以使用Twilio沙盒测试集成。 使用沙盒,您可以使用预先配置的共享 Twilio 测试号码,向加入沙盒的号码发送和接收预先批准的模板消息。
不要在生产环境中使用 Twilio 沙箱。 沙箱会话将在 3 天后到期。
-
要创建沙盒,请访问 Twilio控制台网页,并使用您的Twilio凭据登录。 这将显示激活沙箱提示。 请同意创建沙箱,并确认您的选择。
-
按照指示信息来创建沙箱。
-
通过将 WhatsApp 消息从设备发送到沙箱电话号码来连接到沙箱。
-
从 开发 选项卡中,单击 消息传递> 设置> WhatsApp 沙箱设置。
-
在沙盒配置部分,将之前复制的webhook URI粘贴到 “当有消息进来时”字段中。 单击保存。
-
可以通过将消息从 WhatsApp 发送到分配给 Twilio 沙箱的共享电话号码来测试集成。
如需完整、详细的信息,请参阅 WhatsApp入门 》。
完成产品集成
WhatsApp 授予访问权限并允许WhatsApp后,更新集成,使用您的专用Twilio电话号码代替沙盒号码。
-
从 WhatsApp with Twilio 集成设置页面,滚动到 基本设置 选项卡的 Webhook 部分。 复制 WhatsApp Webhook 字段中的值。
-
转到您的Twilio账户网页,添加复制到Twilio配置中的webhook,以完成Twilio WhatsApp连接。
让客户快速联系到您的助理
您可以向 Web 页面添加一个图标,供客户单击以通过 WhatsApp 启动与助手的交谈。
要向 Web 页面添加图标,请完成以下步骤:
-
在 WhatsApp with Twilio 集成设置页面中,单击单击以聊天选项卡。
-
在预填信息栏中,添加您希望 WhatsApp 发送给助理的文本,以便助理代表客户开始对话。
指定您确信助手可以通过有用的方式应答的消息。
-
复制嵌入链接,并将其添加到您的网页中。 请考虑在图标前面添加用于说明图标用途的文本。 例如,您可以在图标
<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.
格式 | 语法 | 示例 |
---|---|---|
斜体 | We're talking about _practice_. |
我们正在讨论实践。 |
粗体 | There's *no* crying in baseball. |
在棒球比赛中,不许哭泣。 |