为 Twilio 配置 BYO 短信

必备
  • Genesys Cloud CX 1 数字附加组件 II、Genesys Cloud CX 2、Genesys Cloud CX 2 Digital、Genesys Cloud CX 3 或 Genesys Cloud CX 3 数字许可证

以下权限:

  • 集成 > 集成 > 添加
  • 集成 > 集成 > 删除
  • 集成 > 集成 > 编辑
  • 集成 > 集成 > 查看
  • 短信>电话号码>全部 

如果您与 Twilio 存在短信服务的关系,则可以使用自带 (BYO) 短信功能将您现有的 Twilio 帐户集成到 Genesys Cloud 中。 然后,您可以使用 Genesys Cloud 的所有短信功能向客户发送和接收短信。

注意: 如果您是 Genesys Cloud 的间接客户,则必须直接与您的合作伙伴组织合作,为 Twilio 设置自带短信。

有关自带短信的定价,请参阅 Genesys Cloud 合理使用政策。

使用 Genesys Cloud 入站 Webhook 配置短信号码

在将 Twilio 短信号码添加到 BYO SMS Twilio 集成之前,必须配置短信号码才能使用 Genesys Cloud 入站 Webhook。  为此,你需要在每个短信号码上为你所在的地区配置相应的 Genesys Cloud Webhook 网址。 有关更多信息,请参阅 Twilio Docs 中的 Webhooks 文章。

为 10DLC 号码配置 Webhook

如果你使用的是已经注册的美国 10DLC 号码,那么你可能会发现 Twilio 将这些号码放在消息服务中。 在这种情况下,Genesys 建议您在消息服务的网络挂钩配置中选择 “推迟到发件人的网络挂钩” 选项,并将您的短信号码配置为使用 Genesys Cloud 入站 Webhook。

特定区域的 Genesys Cloud Webhook 网址

美国东部 (N. 弗吉尼亚州

https://byosms.mypurecloud.com/vendors/v1/twilio/a906d2848ad146028e8805a8bbaa24d3/mo 

美国东部(俄亥俄州)

https://byosms.use2.us-gov-pure.cloud/vendors/v1/twilio/60b5013a2511482999b30b6db5ec67d8/mo 

美国西部(俄勒冈)

https://byosms.usw2.pure.cloud/vendors/v1/twilio/b1adfe3a944c428bbc65d953bb8629b2/mo

加拿大(加拿大中部)

https://byosms.cac1.pure.cloud/vendors/v1/twilio/1190471d172842c283dc5376a92df73d/mo

南美洲(圣保罗)

https://byosms.sae1.pure.cloud/vendors/v1/twilio/44e8a8cd75f849b18ab6fc8bbad9a057/mo

欧洲(法兰克福)

https://byosms.mypurecloud.de/vendors/v1/twilio/3d904439dc3f4eceb2e574b43c8f5ac5/mo

欧洲(爱尔兰)

https://byosms.mypurecloud.ie/vendors/v1/twilio/a123cbc6467b48ccbdccc3e03fd30f4d/mo

欧洲(伦敦)

https://byosms.euw2.pure.cloud/vendors/v1/twilio/f5c59e8b3a1345739ebd4564a340e526/mo

欧洲(苏黎世)

https://byosms.euc2.pure.cloud/vendors/v1/twilio/FhcOBGsMEALrQfWsxH1LQy39tzI3F3qk/mo  

中东(阿联酋)

https://byosms.mec1.pure.cloud/vendors/v1/twilio/N1aXOj92NXNBA21KqdkZfA3kFjdmAM2B/mo

亚太地区(大阪)

https://byosms.apne3.pure.cloud/vendors/v1/twilio/yXaIsznST36qG0qy7UAP4mWlsHDHh0E0/mo

亚太地区(首尔)

https://byosms.apne2.pure.cloud/vendors/v1/twilio/2e58f741f7a547b49c15c64dfb305361/mo

亚太地区(悉尼)

https://byosms.mypurecloud.com.au/vendors/v1/twilio/97b4889e04514098a34715f0c216bf7b/mo

亚太地区(东京)

https://byosms.mypurecloud.jp/vendors/v1/twilio/b7c9a0818bc343379513f713247b56ce/mo

亚太地区(孟买)

https://byosms.aps1.pure.cloud/vendors/v1/twilio/b462e102a5414620bc6f002bc561595d/mo

警告
  • 如果 Twilio 号码在你尝试导入之前没有设置 webhook 网址,Genesys Cloud 会拒绝导入请求。
  • Genesys Cloud 的 BYO 短信不支持 Twilio 的次要 authTokens 选项。

Genesys Cloud 的 BYO SMS 不支持辅助 AuthTokens 选项,因为 Twilio 隐式使用随入站 SMS/MMS 消息提供的主 Authtoken。 不幸的是,当 Genesys Cloud 尝试验证 AuthToken 时,这种隐式使用会导致失败。 作为替代方案,Genesys 建议使用 Twilio 子帐户进行 BYO SMS 集成。 有关更多信息,请参阅 Twilio 的Twilio 帐户和子帐户入门文章。

设置 BYO Twilio 短信集成

要设置 BYO Twilio 短信集成,请执行以下步骤:

  1. 单击 管理员
  2. 在 “ 集成” 下,单击 “ 集成”
  3. 单击 集成
  4. 找到 “自带 Twilio 短信账户配置” 图块。
  1. 前往 G enesys AppFoundry。
  2. 搜索 BYO Twilio 短信集成。
  3. 要将 BYO Twilio 短信集成添加到你的 Genesys Cloud 组织中,请按照说明进行操作。

  1. 单击 “ 安装”。 将出现 “自带 Twilio 短信账户配置” 屏幕。
  2. (可选)在详细信息选项卡上,自定义集成的名称并添加注释。
    注意: Genesys 建议您使用名称和注释来识别您正在使用的 Twilio 帐户。
  3. 单击配 选项卡。
  4. 单击凭据” 选项卡。
  5. 单击 “ 配置”。 此时将显示 “配置凭据” 对话框。
  6. 账户 SID 框中,键入你的 Twilio 账户的 SID。 
  7. 授权令牌框中,键入您的 Twilio 账户的授权令牌。
    注意: Genesys Cloud 会加密您的 Twilio 凭据并将其存储在安全的环境中。 有关更多信息,请参阅 Genesys Cloud 如何处理凭证?
  8. 单击 “ 确定”
  9. 单击 “ 保存”
  10. 将 “状态” 设置为 “活动”

将您的号码添加到 SMS 号码清单

设置 BYO Twilio SMS 集成后,即可将号码添加到 SMS 号码清单中。 一次只能添加一个数字。

注意: 将您的号码添加到 SMS 号码清单不会影响您对这些号码的控制。 本质上,您允许 Genesys Cloud 使用这些号码发送短信。 这些号码仍保留在你的 Twilio 账户中,你仍然可以在 Twilio 中使用它们进行语音交互。

要添加您的短信号码,请执行以下步骤:

  1. 单击 管理员
  2. 在 “ 消息” 下,单击 SMS 号码库存
  3. 出现 “短信号码清单” 页面时,点击添加号码
  4. 单击 “ 导入”。出现 “导入号码” 对话框。
  5. 从 “集成” 列表中,选择要从中导入数字的集成。
  6. 从 “类型” 列表中,选择要导入的号码类型。
    • 如果您选择 “本地”、“手机” 或 “免费电话”:
      • 在 “发件人 ID” 框中,键入使用 E164 格式的数字。
    • 如果您选择简码
      • 从 “国家” 列表中,选择国家。
      • 在 “发件人 ID” 框中,键入一个数字。
  7. 单击 下一步
  8. 如果您选择短代码来自类型列出所需的互动出现对话框,您必须在三个选项卡中分别填写信息。
    • 帮助标签:
      • 在 “关键词” 框中,输入要使用的帮助关键字。
      • 在 “消息” 框中,输入您要发送给客户以响应帮助请求的消息。
    • 在 “选择退出” 选项卡上:
      • 在 “关键词” 框中,输入您要使用的退出关键字。
      • 在 “消息” 框中,输入您要发送给客户以响应选择退出请求的消息。
    • 在 “重新选择加入” 选项卡上:
      • 在 “关键词” 框中,输入您要使用的选择加入关键词。
      • 在 “消息” 框中,输入您要发送给客户以响应选择加入请求的消息。
  9. 单击 “确认导入”。 Genesys Cloud 会检索短信号码数据,然后将您返回到 “短信号码清单” 页面。 页面顶部会出现一个祝酒词,告诉你数字导入已成功。

有关更多信息,请参阅管理您的 SMS 长代码库存

在 Genesys Cloud 中停用 Twilio 短信集成是暂时的。 停用集成后,SMS 号码清单中将禁用为此集成导入的所有号码。 但是,当任何入站消息从 Twilio 传输到 Genesys Cloud 时,它们都会被丢弃。 换句话说,它们不会路由到您设置的任何队列。

如果您不希望在集成停用时从 Twilio 向 Genesys Cloud 发送入站消息和送达报告,请将数字的 webhook 更改为 Genesys Cloud Webhook 网址以外的内容。

注释:
  • 在 Genesys Cloud 中停用 Twilio 短信集成并不能停用你的 Twilio 账户中的号码。
  • 如果您稍后决定重新激活 Twilio SMS 集成,请将 webhook 网址更改回 Genesys Cloud 网络挂钩网址。

有关 Twilio 主机的更多信息,请参阅 Twilio 的 Webh ooks 文章。 有关如何停用集成的更多信息,请参阅编辑、停用或删除集成。

警告: 删除 Twilio SMS 集成会从短信号码清单中删除所有导入的号码,而不考虑有效的入站流量或队列配置。

在 Genesys Cloud 中删除 BYO SMS Twilio 集成时,应将 Twilio 主机中每个号码的入站 Webhook 网址更改回其原始配置。 如果您不更改 Webhook 网址,则入站消息将继续路由到 Genesys Cloud,这些消息将在那里被丢弃。 这些消息不会路由到您设置的任何队列。

注意: 在 Genesys Cloud 中删除 Twilio 短信集成不会从你的 Twilio 账户中删除这些号码。 它只会取消你在 Genesys Cloud 中使用数字的能力。

有关 Twilio 主机的更多信息,请参阅 Twilio 的 Webh ooks 文章。 有关如何删除集成的更多信息,请参阅编辑、停用或删除集成

如果您在将现有 Twilio 帐户集成到 Genesys Cloud 时收到错误,请使用此表了解更多信息。

注意: 如果您在发送短信时遇到问题,则需要直接使用 Twilio。

消息 描述
请查看集成以获取 BYO 发件人 ID。 当请求发送到后端服务并且集成缺少发件人 ID 时,会出现此消息。 
请为您的发件人 ID 提供所需的合规关键字和消息。

当缺少任何合规性信息时,就会出现此消息。 在 “必需的交互” 对话框中查看三个选项卡上的字段:

  • 帮助
  • 选择退出
  • 重新选择加入
请检查您的发件人 ID 类型。

当电话号码或短代码格式不正确时,就会出现此消息。

  • 电话号码必须采用 E.164 格式。
  • 短代码的长度必须介于五到六个字符之间。
请检查您的发件人 ID 国家/地区代码。 当电话号码和国家/地区代码不匹配时,会出现此消息。
此电话号码地址的配置操作已在进行中。 如果您尝试重新提交已配置的请求,则会显示此消息。 有些数字需要更长的时间才能调配。
此电话号码地址不可用于配置。 请选择其他电话号码地址,然后重试。 当电话号码已在其他组织中配置时,就会出现此消息。
在供应商处找不到此电话号码。 当 Twilio 子帐户中不存在该电话号码时,就会显示此消息。