与SMS集成

在线编辑

添加文本消息传递集成，以便助手可以与客户交换消息。

AWS IBM Cloud

注：

自2025年7月31日起， watsonx Orchestrate 的 IntelePeer 免费电话号码服务将停止提供。 在此日期之后，使用此服务的电话号码将不再连接，用户也无法拨打或接听电话。 为确保持续服务，请将您的电话号码迁移到 Twilio 或其他电话服务提供商。 请在 watsonx Orchestrate 中更新您的电话号码并调整集成设置。 如需过渡期间的协助，请通过 https://www.ibm.com/mysupport/ 联系客服。

短消息服务 (SMS) 支持纯文本消息。 通常，SMS 将文本消息长度限制为 160 个字符。 多媒体消息服务 (MMS) 支持发送图像以及长度超过 160 个字符的文本消息。 使用 Twilio 创建电话号码时，会自动包含 MMS 消息支持。 目前还不支持IntelePeer彩信。

客户向您的托管电话号码发送短信。 Twilio 和IntelePeer使用你设置的信息 Webhook 向你的助手发送包含文本信息正文的 POST 请求。 助手的每个回复都会发回 Twilio 或IntelePeer，转换成外向短信发送给客户。 回复会发送到 SMS 提供商的 API 进行处理。 您提供 SMS 提供商的身份验证令牌信息，作为您的 API 访问凭证。

请参阅以下部分，为您的 SMS 提供商设置集成：

如果您希望助手在客户交互期间能够在语音和文本之间进行切换，请启用电话和文本消息传递集成。 这两个集成不需要使用相同的第三方服务提供者。 更多信息，请参阅与电话集成。

准备工作

要将 Twilio 与您的助手集成，您必须至少拥有开发人员角色。 如需了解更多信息，请参阅 Twilio 角色之间的区别。

如果您没有短信电话号码，请创建一个 "使用 Twilio 发送短信账户并获取一个电话号码。

将短信与 Twilio整合

  1. 访问 Twilio 网站。

  2. 创建帐户。 免费试用账户不能用于此集成。

  3. 在侧边栏的 "开发"选项卡中，单击 "电话号码"。 如果没有 "电话号码"，请转到顶部的搜索栏搜索 "电话号码"，然后选择 "购买号码"。

  4. 按照说明购买号码。 如何通过控制台搜索并购买 Twilio 电话号码。

获得 Twilio 电话号码后，它会自动支持语音、SMS 和 MMS。 新电话号码会列为活动号码。

使 Twilio Web 页面在 Web 浏览器选项卡中保持打开，以便稍后可以再次参考该页面。 您还可以将电话号码固定在侧边栏上。

设置集成

要设置集成，请完成以下步骤：

  1. 点击左侧菜单中的集成图标（集成图标），进入 “集成 ”页面。

  2. 单击短信磁贴上的添加。

  3. 单击 "SMS with Twilio "磁贴。

  4. 点击 “确认 ”。

  5. 在 Twilio 网站上，点击左上角菜单中的账户名，进入账户控制面板。

复制以下值并暂时保存，以便在接下来的步骤中将其粘贴到SMS 与 Twilio集成设置页面。

  • 帐户 SID

  • 认证令牌

  1. 返回SMS 与 Twilio集成设置页面。 单击 "下一步"进入短信与 Twilio集成设置的第 1 步。

  2. 输入您的账户 SID信息。 单击 "下一步"，进入短信与 Twilio集成设置的第 2 步。

  3. 输入您的Auth 令牌信息。 单击 "下一步"，进入短信与 Twilio集成设置的第 3 步。

  4. 可选：输入 Twilio 账户用于短信集成的电话号码。 webhook URI 用于传输信息，但如果在此可选字段中添加您的电话号码，以后就可以很方便地查询。 单击 "下一步"进入短信与 Twilio集成设置的第 4 步。

  5. 复制Webhook URI字段中的值。

您将把此 URI 添加到 Twilio 的 webhook 配置中。 如果要支持多个电话号码，必须为每个电话号码分别添加 URI 到 webhook。

  1. 转至 Twilio 帐户 Web 页面。 从侧边栏的 "开发"选项卡，单击 "电话号码">"管理">"活动号码"。

  2. 在"活动号码"页面，单击其中一个电话号码。

  3. 滚动到消息传递部分，然后找到定义消息到达时要执行的操作的 Webhook 字段。

将从 Webhook URI 字段复制的值粘贴到其中。

  1. 如果要支持多个电话号码，请为每个电话号码重复上一步。

  2. 单击保存。

  3. 从侧栏的 "开发"选项卡，单击 "信息">"设置">"地理权限"。 如果未显示 "信息"，请转到顶部的搜索栏搜索 "信息"，然后选择SMS 地理权限。

  4. 从 "信息地理权限"页面，选择可以给 Twilio 号码发短信的电话号码的国家代码。 默认情况下，不允许使用国家代码给 Twilio 号码发短信。

  5. 返回SMS 与 Twilio集成设置页面。 单击完成。

与 "带有 "IntelePeer的短信 整合

如果您没有短信电话号码，请创建一个 "带有 "IntelePeer的短信 账户并获取一个电话号码。

  1. 访问 IntelePeer 网站。

  2. 创建帐户或启动免费试用。

您获得的IntelePeer电话号码支持语音和短信。 如果号码没有自动启用短信功能，则需要手动启用。 新电话号码会列为活动号码。 请参阅《 Atmosphere 消息传递快速入门指南》

准备工作

要将 IntelePeer 与您的助手集成，您需要为 create, read, update, 和 delete 提供访问类型为 "SMS "的服务。 如需了解更多信息，请参阅 “客户门户中的用户管理 ”。

设置集成

要设置集成，请完成以下步骤：

  1. 点击左侧菜单中的集成图标（集成图标），进入 “集成 ”页面。

  2. 单击短信磁贴上的添加。

  3. 选择短信与IntelePeer磁贴。

  4. 点击 “确认 ”。

  5. 请从 IntelePeer Atmosphere 网站上复制 API 认证令牌的值并暂时保存，以便在后续步骤中将其粘贴到“ IntelePeer ”短信集成设置页面中。

  6. 在 IntelePeer 客户门户网站的 “我的申请 ”部分，选择 “短信服务（SMS ） API Management ”。 在 "短信管理"标题栏中，单击齿轮图标，您将在此设置 "短信密文输入"。 秘密输入用于防止网络服务器 webhook 处理任何非来自IntelePeer 的入站短信 POST 请求。 在此设置秘密输入值并记住它，因为在接下来的步骤中，您需要在短信与IntelePeer集成设置页面中使用该值。

  7. 返回短信与IntelePeer集成设置页面。 单击 "下一步"进入SMS 与IntelePeer集成设置的第 1 步。

  8. 输入您的账户保密信息。 单击 "下一步"进入SMS 与IntelePeer集成设置的第 2 步。

  9. 输入您的Auth 令牌信息。 单击 "下一步"进入SMS 与IntelePeer集成设置的第 3 步。

  10. 可选 ：输入 IntelePeer 账户用于短信集成的电话号码。 webhook URI 用于传输信息，但如果在此可选字段中添加您的电话号码，以后就可以很方便地查询。 单击 " 下一步 "进入 SMS 与 IntelePeer 整合设置的第 4 步。

  11. 复制Webhook URI字段中的值。

您将把该 URI 添加到IntelePeer 的网络钩子配置中。 如果要支持多个电话号码，必须为每个电话号码分别添加 URI 到 webhook。

  1. 请访问您的 IntelePeer 客户门户网站，在 “我的应用程序 ”部分下，选择 “短信 API Management ”。

  2. 转到要启用短信功能的电话号码。 切换数字旁边的 "已启用/禁用径向按钮，将其设置为 "已启用。 电话号码激活短信功能可能需要几分钟时间。

  3. 电话号码启用短信功能后，您会在号码旁边看到一个 webhook 图标。

将从 Webhook URI 字段复制的值粘贴到其中。

  1. 单击保存。

  2. 如果要支持多个电话号码，请为每个电话号码重复上一步。

出于安全考虑，初始设置后，验证字段将被删除。 如果更改了验证所需的字段，则必须重新填写和验证相关字段中的所有条目。

短信高级配置选项

高级选项选项卡可在设置短信集成后使用。 单击高级选项选项卡可对消息传递行为进行以下任何定制：

  • 从入站消息发起交谈：如果要将消息传递支持限制为仅允许在进行中电话集成交谈的上下文中发送的消息，而不允许客户在电话呼叫外部启动与助手的消息交换，请禁用此选项。

  • 缺省失败消息：添加要在 SMS 连接失败时发送给客户的消息。

  • 基本 URL：此 URL 是您使用的 SMS 服务的 REST API 端点。

优化信息传递行动

为获得最佳客户体验，在设计操作时应考虑到短信集成的功能：

  • 不要在文本响应中包含 HTML 元素。

  • 短信集成不支持使用connect_too_agent响应类型启动的聊天传输。

  • 图像、音频、视频响应类型允许发送包含媒体的信息。 标题和说明与附件一起发送。 请注意，根据终端用户的运营商和设备情况，这些信息可能无法成功接收。 有关 Twilio 支持的内容类型的列表，请参阅 《Twilio：媒体支持的内容类型》。

有关这些响应类型的更多信息，请参阅响应类型参考。

如果您想在部署到多个不同平台的助手中使用相同的操作，请为每个集成类型添加自定义响应。 您可以添加条件回复，告诉助手只有在使用短信集成时才显示回复。

有关参考文档，请参阅 SMS 集成参考文档。

故障诊断

查找使用集成时可能遇到的问题的解决方案。

  • 如果收到 "Forbidden（禁止）"信息，则表示您在配置集成时指定的电话号码无法验证。 请确保号码与 SMS 电话号码完全匹配。

从 "Voice Agent with Watson迁移

如果您已在 IBM Cloud 中创建了 IBM Voice Agent with Watson 服务实例，以便客户与助手交换短信，请改用 SMS 集成。

短信集成可与助手实现更无缝的集成，并支持所需数量的电话号码。 不过，该集成目前不支持以下功能：

  • 通过发送短信开始纯短信交互

  • 配置备份位置

  • 查看使用摘要页面。 改用IBM Log Analysis。

若要从“ Voice Agent with Watson ”迁移至 AI 助手短信集成，请完成以下步骤：

  1. 执行下列其中一项操作：

    • 如果您的 Voice Agent with Watson 服务实例使用的短信服务提供商不是Twilio或 IntelePeer, ，则无法继续使用该服务。 您必须先在 Twilio 或 IntelePeer 上创建一个短信账户。 请完成 “开始之前 - Twilio ”或 “开始之前 - IntelePeer ”中的步骤来创建账户。 接下来，设置集成。

    • 如果您的 Voice Agent with Watson 服务实例使用Twilio或 IntelePeer 作为短信服务提供商，您可以直接跳转至 “设置集成 - Twilio ” 或“设置集成 - IntelePeer ”。