IBM Cloud Docs
与 SMS 集成

与 SMS 集成

IBM Cloud

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

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

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

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

请参阅以下部分以设置 SMS 提供程序的集成:

要在客户互动期间切换语音和文本，请在助手中启用电话和文本信息集成。 集成无需使用相同的第三方服务提供商。 有关更多信息，请参阅与电话集成。

准备工作

要将 Twilio 与助手集成，您必须至少具有“开发者”角色。 有关更多信息，请参阅 Twilio 的角色差异。

如果您没有短信电话号码，请使用 Twilio 帐户设置短信并获取电话号码。

将短信与 Twilio 整合

  1. 转至 Twilio Web 站点。

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

  3. 从侧边栏中的 开发 选项卡，单击 电话号码。 如果 电话号码 不存在，请转至顶部的搜索栏并搜索“电话号码”，然后选择 购买号码。

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

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

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

设置集成

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

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

  2. 单击 SMS 磁贴上的 添加。

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

  4. 请单击确认。

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

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

    • 帐户 SID
    • 认证令牌

  6. 返回到 SMS with Twilio 集成设置页面。 单击 下一步 以转至 SMS with Twilio 集成设置的步骤 1。

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

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

  9. 可选: 输入 Twilio 帐户用于 SMS 集成的电话号码。 Webhook URI 用于传输消息，但如果在此可选字段中添加您的电话号码，那么稍后可以轻松参考。 单击 下一步 以转至 SMS with Twilio 集成设置的步骤 4。

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

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

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

  12. 在“活动号码”页面中，单击其中一个电话号码。

  13. 滚动到 “信息”部分，然后找到 " Webhook "字段，该字段定义了收到信息时的操作。

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

  14. 如果要支持多个电话号码，请针对要使用的每个电话号码重复上一步。

  15. 单击保存。

  16. 从侧边栏中的 开发 选项卡，单击 消息传递> 设置> 地理许可权。 如果 消息传递 不存在，请转至顶部的搜索栏并搜索“消息传递”，然后选择 SMS 地理许可权。

  17. 从“消息传递地理许可权”页面中，选择可对 Twilio 号码进行文本处理的电话号码的国家或地区代码。 缺省情况下，不允许国家或地区代码对 Twilio 编号进行文本。

  18. 返回到 SMS with Twilio 集成设置页面。 单击完成。

使用 IntelePeer 集成 SMS

如果您没有短信电话号码，请使用 IntelePeer 帐户设置短信并获取电话号码。

  1. 转至 IntelePeer Web 站点。

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

    当您获得 IntelePeer 电话号码时，它支持语音和 SMS。 如果未针对 SMS 自动启用数字，那么您将需要手动将其启用。 新电话号码会列为活动号码。 请参阅 氛围消息传递快速入门指南

准备工作

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

设置集成

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

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

  2. 单击 SMS 磁贴上的 添加。

  3. 选择 SMS with IntelePeer 磁贴。

  4. 请单击确认。

  5. 从 IntelePeer 氛围 站点，复制 API 认证令牌 值并将其临时存储，以便您可以在即将执行的步骤中将其粘贴到 SMS with IntelePeer 集成设置页面中。

  6. 从 IntelePeer 客户门户网站 站点的 我的应用程序 部分下，选择 SMS API Management。 在 短信管理 标题栏中，单击齿轮图标，您将在此处设置短信 密钥输入。 “私钥输入”用于阻止 Web 服务器 Webhook 处理并非源自 IntelePeer的任何入站-SMS POST 请求。 在此处设置 Secret Input 值，并记住该值，因为您需要在后续步骤中使用 SMS with IntelePeer 集成设置页面中的值。

  7. 返回到 SMS with IntelePeer 集成设置页面。 单击 下一步 以转至 SMS with IntelePeer 集成设置的步骤 1。

  8. 输入您的账户保密信息。 单击 下一步 以转至 SMS with IntelePeer 集成设置的步骤 2。

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

  10. 可选：输入 IntelePeer 账户用于短信集成的电话号码。 Webhook URI 用于传输消息，但如果在此可选字段中添加您的电话号码，那么稍后可以轻松参考。 单击“下一步”进入 SMS 与 IntelePeer 整合设置的第 4 步。

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

    您将向 IntelePeer中的 Webhook 配置添加此 URI。 如果要支持多个电话号码，那么必须分别将 URI 添加到每个电话号码的 Webhook。

  12. 转至 IntelePeer 客户门户网站 站点，在“我的应用程序”部分下，选择 SMS API Management。

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

  14. 在为短信启用电话号码后，您将看到该号码旁边的 Webhook 图标。

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

  15. 单击保存。

  16. 如果要支持多个电话号码，请针对要使用的每个电话号码重复上一步。

出于安全原因，在初始设置后将从视图中除去认证字段。 如果更改了认证所需的字段，那么必须再次填充并验证相关字段中的所有条目。

与自带服务提供商 (BYOP) 短信服务集成

设置集成

请按照以下步骤设置 BYOP 短信集成：

  1. 点击集成图标进入集成页面
    (集成图标 ）。

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

  3. 选择自带 SMS 提供商选项。

  4. 请单击确认。

  5. 在 API URL 字段中，输入用于向外发送短信的端点。

  6. 复制验证令牌并妥善保存。
    向 watsonx Assistant 发送短信时需要使用此令牌。 单击 下一步。

  7. (可选） 输入用于短信集成的电话号码，然后单击下一步。

  8. 复制 Webhook URI 值。
    使用此 URI 发送短信至 watsonx Assistant。

  9. 单击保存。

SMS 高级配置选项

设置 SMS 集成后，高级选项 选项卡可用。 单击“高级选项”选项卡，对消息传递行为进行以下任何自定义操作：

  • 从入站消息发起交谈：如果要将消息传递支持限制为仅允许在进行中电话集成交谈的上下文中发送的消息，而不允许客户在电话呼叫外部启动与助手的消息交换，请禁用此选项。
  • 缺省失败消息：添加要在 SMS 连接失败时发送给客户的消息。
  • 基本 URL：此 URL 是您使用的 SMS 服务的 REST API 端点。

优化信息传递行动

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

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

  • SMS 集成不支持使用 connect_to_agent 响应类型启动的交谈传输。

  • 图像，音频，视频 响应类型允许发送包含媒体的消息。 标题和描述随附件一起发送。 请注意，根据最终用户的运营商和设备，可能无法成功接收这些消息。 有关 Twilio 支持的内容类型的列表，请参阅 Twilio: Accepted Content Types for Media。

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

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

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

故障诊断

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

  • 如果收到 禁止 消息，那么表示无法验证配置集成时指定的电话号码。 请确保号码与 SMS 电话号码完全匹配。

从 Voice Agent with Watson 迁移

如果在 IBM Cloud 中创建了 IBM® Voice Agent with Watson 服务实例以使客户能够与助手交换文本消息，请改为使用 SMS 集成。

SMS 集成提供与助手的更无缝集成，并支持所需数量的电话号码。 但是，集成当前不支持以下功能:

  • 启动仅 SMS 与传出文本的交互
  • 配置备份位置
  • 查看使用情况摘要页面。 请改为使用 IBM Log Analysis。

要从 Voice Agent with Watson 迁移到 watsonx Assistant SMS 集成，请完成以下步骤:

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

    • 如果您的Voice Agent with Watson服务实例使用的短信服务提供商不是 Twilio 或IntelePeer,无法继续使用。 必须先使用 Twilio 或 IntelePeer 创建 SMS 帐户。 完成 开始之前-Twilio 或 开始之前- IntelePeer 步骤以创建帐户。 接下来，设置集成。

    • 如果 Voice Agent with Watson 服务实例使用 Twilio 或 IntelePeer 作为其 SMS 提供程序，那么您可以直接转至 设置集成-Twilio 或 设置集成- IntelePeer。