Oracle Responsys SMS 公共聚合商网络指南
概览
本指南适用于在为 Oracle Responsys 客户提供 SMS 服务时希望成为 Oracle 合作伙伴的 SMS 聚合商。从他们的 Oracle Responsys 会话,已被允许执行此操作的 Oracle Responsys 客户可以订购 SMS 聚合商提供的移动设备代码。SMS 聚合商为客户预配请求的移动设备代码。为 SMS 公共聚合商网络 (SMS Public Aggregator Network, SPAN) 激活的 SMS 聚合商提供可用于 Responsys 客户的 SMS 服务计划。
提示:本指南适用于参加 SPAN 的 SMS 聚合商。如果您是希望管理您账户的 SMS 聚合商的 Oracle Responsys 客户,请改为参考 Oracle Responsys 联机帮助主题管理账户的 SMS 聚合商。
要成为 SPAN 的一部分,您必须在 Oracle Responsys 系统中注册您的服务并输入配置详细信息。您还必须在您的 SMS 聚合商系统上完成配置任务。本指南中介绍了这些任务。完成后,客户将能够从 Oracle Responsys 内订购移动设备代码。一旦您预配了这些代码,客户可以使用移动设备代码发送他们的 SMS 市场活动。
作为参加 SPAN 的 SMS 聚合商,您需要执行四个主要任务:
- :启用是一次性任务,涉及两个步骤。在步骤一,您登录到 Oracle Responsys 并将您的公司注册为 SMS 聚合商。在步骤二,您使用在步骤 1 中提供的信息设置您的 SMS 聚合商系统以与 Oracle Responsys 通信,从而顺利处理 SMS 市场活动启动。
- :在此任务中,您将输入 Responsys 需要的信息,从而可以在 SMS 公共聚合商网络中激活您的公司。激活后,Responsys 用户将在系统中看到您的计划信息并将能够从您那里购买移动设备代码。
- :处理 Oracle Responsys 客户的订单是持续进行的任务。在 Oracle Responsys 中激活您的服务后,客户将能够从您那里订购代码以用于发送 SMS 市场活动。您必须在 Responsys 中为客户预配代码以便使用并完成订单,然后客户才能使用他们所订购的项目。
- :SMS 聚合商的其他持续进行的任务包括处理 Oracle Responsys 客户的发件人名称更改请求以及上载支持请求单详细信息。
常用术语
SPAN:SMS 公共聚合商网络 (SMS Public Aggregator Network)。允许在系统上设置第三方聚合商的 Oracle 框架,可用于所有 Oracle Responsys SMS 客户。
合作伙伴:愿意成为 Oracle 合作伙伴的 SMS 聚合商或通讯公司。
短代码:特殊电话号码,通常 5 或 6 位数字,用于在一个国家/地区将消息发送到移动电话和从移动电话接收消息。
长代码:与短代码功能类似的特殊电话号码。长代码比短代码长(最长 15 位数字),可以全球访问该代码。
移动设备发起 (Mobile-originated, MO) 消息:从用户的移动电话发送到短代码或长代码的消息。
移动设备接收 (Mobile-terminated, MT) 消息:由短代码发送到用户移动电话的消息。
送达回执 (Delivery receipt, DR):SMS 聚合商发送消息后从 SMS 聚合商发送给 Responsys 的消息。DR 消息包含有关每条消息的送达信息,例如运营商和状态代码。
客户:在本文档中,“客户”是指通过 SMS 聚合商经过 SPAN 提供的计划订购短代码和长代码的 Oracle Responsys 用户。
注释
- 本指南假定 SMS 聚合商合作伙伴已完成了提供给他们的业务评估标准并同意遵守该标准。
- 可以配置 SMS 聚合商设置,以实现每小时 5 百万条消息的最大吞吐量。
- 仅能为 SMS 聚合商合作伙伴设置专用短代码。Oracle Responsys 不支持共享短代码。
- 路由类型只是我们系统中的标签。它们没有任何关联的含义。如果您具有新路由类型条目请求,请在启用过程中与 Oracle 联系。
- SMS 聚合商合作伙伴负责不要转发 MT 事务性和 MT 优先级代码的 MO。如果 Oracle Responsys 获得了它们的 MO,则我们只需要处理它们。
启用
在 Responsys 中将您的公司设置为 SMS 聚合商合作伙伴的第一个任务涉及以下步骤:
步骤 1:在 Oracle Responsys 中注册您的服务
Oracle 在 Responsys 中将您设置为 SMS 聚合商后,您将收到欢迎电子邮件。登录到 Responsys 以将您的公司注册为 SMS 聚合商合作伙伴。
要将您的公司注册为 SMS 聚合商合作伙伴,请执行以下操作:
- 使用发送给您的 Responsys SMS 聚合商合作伙伴凭证,登录 Responsys。如果这是您第一次登录 Responsys,则遵循页面上的说明来重置临时密码。
提示:记录您的 Responsys 用户名和密码,因为您以后将使用它们来编辑您的聚合商设置和处理订单(来自 Responsys 用户的短代码和/或长代码订单)。
- 从管理聚合商页,单击开始图标。
- 从添加聚合商对话框,完成以下字段:
重要提示:此屏幕是一次性设置。确保值正确。如果需要更改这些值,请联系 Oracle 技术支持。
- 聚合商名称:此名称用于 Oracle SMS MO 监听程序 URL 和送达回执 (Delivery Receipt, DR) 端点 URL 中的
{aggregator}
属性。 - 显示名称:这是您的聚合商名称,在激活后在 Responsys 中显示给您自己和 Responsys 客户。
- 聚合商 URL:MT 端点 URL,Responsys 使用该 URL 发送到聚合商的系统。例如,Responsys 使用 MT 发送 SMS 市场活动时,系统将获取此 URL 并附加凭证、消息和移动电话号码,然后将该 URL 发布到 SMS 聚合商系统。
- 将发送速率限制为每小时 ... 条消息:输入您系统的限制。默认情况下,Responsys 每小时发送 1 百万条消息。这是近似数,实际吞吐量可能相差 1-2%。最大值为 5 百万。要提高发送速率,请联系 Oracle 技术支持。
- 聚合商名称:此名称用于 Oracle SMS MO 监听程序 URL 和送达回执 (Delivery Receipt, DR) 端点 URL 中的
- (可选)单击高级设置以编辑以下设置:
- 连接超时:Responsys 将等待 SMS 聚合商响应的时间量。默认情况下,该值为 1000 毫秒。
- 重试计数:如果存在连接超时,Responsys 将重试发送消息的次数。默认情况下,该值为 1 次重试。
- 单击添加。
- 从确认对话框,单击提交将您的聚合商设置发送到 Responsys。否则,单击返回修改您的设置。单击“提交”后,有用信息对话框确认已在 Responsys 中配置您的聚合商设置。
重要提示:您将需要在启用的步骤 2 的有用信息对话框上显示的信息。该信息随您的系统向白名单提供一个或多个 Oracle IP 地址,并提供您与 Responsys 通信必须使用的端点 URL。通过在您的聚合商概要信息中访问配置设置,您始终可以重新找到该信息。
- 单击确定关闭对话框。您的聚合商信息将显示在管理聚合商页上的表中,但是标记有红色图标。此图标指示聚合商的启用和配置尚未完成。
- 从 Responsys 注销并完成 。
步骤 2:设置您的基础结构以支持 SPAN
您必须先执行《Oracle Responsys Integration Guide for SMS Aggregators》中所述的任务,才能接受来自 Oracle 系统的流量。本文档介绍如何针对来自 Responsys 的 MT 流量在您的系统上实施相应界面以及对 Responsys 进行 MO 和送达回执 (Delivery Receipt, DR) 状态呼叫。此外,还将讨论白名单以及安全证书要求。
配置
在 Responsys 中将您的公司设置为 SMS 聚合商合作伙伴的下一个任务涉及以下步骤:
(可选)您可以查看您的初始注册的配置设置。
步骤 1:输入短代码和/或长代码以测试您的系统与 Responsys 之间的连接
使用管理代码选项卡输入代码以测试您的系统与 Responsys 之间的连接。Responsys 客户无法使用这些代码。
要添加短代码或长代码进行测试,请执行以下操作:
- 使用您的 SMS 聚合商合作伙伴凭证登录到 Responsys。
- 在管理聚合商页上,单击配置图标 (
)。
- 单击管理代码。
- 从该页右上侧的按钮,选择添加短代码或添加长代码。
- 在添加 ... 代码对话框上,输入以下信息:
- 如果您在添加短代码则输入短代码,如果您在添加长代码则输入长代码。
- 选择国家/地区。如果您在添加长代码,可以选择一个或多个国家/地区。
- 选择路由类型。
- 输入发件人名称。
- 如果适用,输入用户名和密码。使用所选路由类型的授权。这是 Responsys 用于对您的系统进行 MT 呼叫的同一授权。
- 单击添加。
提示:您可以选择为每种路由类型存储凭证,以便您使用管理代码页添加代码时,将不必输入凭证。要存储凭证,请单击管理路由类型的凭证链接。在生成的页面上,找到您要为其存储凭证的路由类型。单击其 编辑图标。输入用户名和密码,然后单击保存。
步骤 2:上载送达回执状态代码
使用送达回执状态代码选项卡配置您的 DR 状态代码并将其映射到 Responsys 类别和子类别。要编辑此页上显示的 DR 状态代码,请编辑并重新上载映射文件。
要上载送达回执状态代码,请执行以下操作:
- 使用您的 SMS 聚合商合作伙伴凭证登录到 Responsys。
- 在管理聚合商页上,单击配置图标 (
)。
- 单击送达回执状态代码。第一次访问此选项卡时,您将看到一条消息,指示您未定义任何详细信息。
- 从送达回执状态代码详细信息页,单击查看示例 .csv 文件链接。
- 滚动到示例文件格式对话框的底部,转到示例 .csv 文件框。
- 单击
复制到剪贴板图标。
- 将示例 .csv 文件粘贴到您将用于创建 DR 状态代码文件的编辑器。
- 将您的送达回执状态代码信息输入该 CSV 文件中。如果您已具有 DR 状态代码文件,则编辑该文件以包括所需的列,“示例文件格式”对话框中介绍了这些列。
- 为您的系统将发送的每个唯一 DR 状态代码创建一个新行。
- 对于每个代码,添加 DR 状态代码名称和 DR 状态代码描述。
- 对于每个代码,从模板中显示的那些 Responsys 类别 + 子类别组合分配一个组合。
- 返回到页面并单击上载文件。上载完成后,表中显示送达回执状态代码及其与 Responsys 类别+子类别的映射。将更新上次更新日期字段来显示您最近上载的时间和日期。
步骤 3:上载定价和绩效详细信息
使用定价和绩效选项卡为每个计划添加定价和绩效详细信息:
- 定价详细信息包括您提供的短代码和长代码的设置费用、每月费用和价格(每千条消息的成本)。
- 绩效详细信息是每个计划的送达能力分数。Oracle 派生的分数不可用时,Responsys 用户将看到这些值。
要更改此页上显示的详细信息,请编辑并重新上载定价和绩效详细信息文件。定价更改将仅适用于新的订单,不适用于现有订单。
重要提示:SMS 聚合商直接与客户一起工作来设置新的服务合同和计费。Oracle Responsys 中不会进行这些活动。
要上载定价和绩效详细信息,请执行以下操作:
- 使用您的 SMS 聚合商合作伙伴凭证登录到 Responsys。
- 在管理聚合商页上,单击配置图标 (
)。
- 单击定价和绩效。第一次访问此选项卡时,您将看到一条消息,指示您未定义任何详细信息。
- 单击查看示例 .csv 文件来查看用于创建 CSV 文件的说明以及复制示例。
- 滚动到示例文件格式对话框的底部,转到示例 .csv 文件框。
- 单击
复制到剪贴板图标。
- 将示例 .csv 文件粘贴到您将用于创建定价和绩效详细信息文件的编辑器。
- 遵循示例文件格式对话框上的说明,创建 CSV 文件。
重要提示:请仔细阅读示例文件格式对话框上的说明,特别是您输入的每个计划的设置费用、每月费用和价格列的说明。
关于声明的送达能力,您可以选择提供送达能力分数,Oracle 派生的分数不可用时将为计划显示该分数。送达能力分数是一个百分比,通过将送达的消息总数除以预期消息数来计算得出。Oracle 派生的分数是基于过去 90 天的数据计算得出的。 - 单击定价和绩效选项卡中的上载文件或示例文件格式对话框中的立即上载。浏览并上载您创建的定价和绩效 CSV 文件。定价和绩效详细信息将显示在页面上。
步骤 4:输入您的联系信息
使用联系信息选项卡输入 SMS 聚合商支持中心信息,作为您的客户的 Responsys 用户将使用该信息联系您。
- 使用您的 SMS 聚合商合作伙伴凭证登录到 Responsys。
- 在管理聚合商页上,单击配置图标 (
)。
- 单击联系信息。
- 在联系信息选项卡上,输入以下字段:
- 输入您的支持中心的电子邮件地址和描述。如果您要输入多个电子邮件地址,请使用添加更多按钮来添加其他字段。例如,对于您开展业务的每个国家/地区,您可能具有不同的支持中心电子邮件。
- 对于电话号码部分,输入支持中心电话号码和描述。如果您要输入多个电话号码,请使用添加更多按钮来添加其他字段。
- (可选)输入您的支持门户 URL。
- 单击保存。或者,如果您要恢复以前的值,请单击放弃更改。
步骤 5:发送测试消息以测试您与 Responsys 的连接
您输入了用于激活的所有详细信息后,但是在您将您的公司激活成为 SPAN 的一部分之前,您可以从管理聚合商页发送测试 MT。
开始之前:确保您已使用聚合商设置中的管理代码选项卡添加您的测试代码。
要发送测试 MT 消息,请执行以下操作:
- 使用您的 SMS 聚合商合作伙伴凭证登录到 Responsys。
- 在管理聚合商页上,单击测试图标 (
)。
- 从测试对话框:
- 选择要测试的代码。此列表中的代码是您在聚合商设置中的管理代码选项卡上输入的代码。
- 输入将接收测试消息的移动电话号码。将自动为与您选择的代码关联的国家/地区添加国家/地区代码,所以您仅需要输入移动电话号码自身。
- 在提供的字段中键入一条测试消息。
- 单击发送测试消息。测试结果对话框返回消息状态(例如,“邮件已成功发送”)。
- 从测试结果对话框,单击完成以关闭对话框,或单击发送其他测试消息以返回测试对话框。
- 对要测试的其他代码重复以上操作。
步骤 6:在 Responsys 中激活您的聚合商概要信息
完成上面步骤 1-4 后,管理聚合商页上显示在您的聚合商名称旁边的图标将从红色(指示需要其他详细信息)更改为黄色。黄色图标指示您的公司已可在 Responsys 中激活为 SMS 聚合商。
重要提示:在 Responsys 中激活您的聚合商概要信息之前,确保您已经添加测试代码并且已经测试您的连接。
要激活聚合商,请执行以下操作:
- 导航到管理聚合商页。
- 如果您位于聚合商配置页上,请单击返回到管理聚合商链接。
- 如果您已从 Responsys 注销,则使用您的 Responsys SMS 聚合商凭证重新登录。
- 找到并单击激活聚合商按钮。
- 从激活聚合商概要信息对话框,阅读该对话框上的说明。
- 如果您尚未通过发送测试消息来测试您的连接,请单击取消并执行所需的测试。
- 如果您已成功发送了测试消息,则单击激活。
管理聚合商页将对您的聚合商概要信息显示“已激活”状态。您的公司现在已添加到 Responsys 中的 SMS 公共聚合商网络。您的计划将可供 Responsys 用户查找和订购。
提示:如果需要,您可以返回管理聚合商页并修改您的聚合商概要信息中的某些设置,例如您的 DR 代码、您的价目表和您的联系信息。
查看配置设置
您可以查看您的配置设置。这是您在注册步骤中添加的信息以及您完成注册后显示的有用信息对话框上显示的信息。
注意:您无法从聚合商概要信息设置更改这些值。如果您必须更改这些值中的任何值,请联系 Oracle 技术支持。
要查看配置设置,请执行以下操作:
- 使用您的 SMS 聚合商合作伙伴凭证登录到 Responsys。
- 在管理聚合商页上,单击查看有用信息图标 (
)。或者,如果您已经在查看您的聚合商概要信息页,则可以选择配置设置选项卡。
此时将显示来自注册步骤的配置设置和有用信息。
处理 Oracle Responsys 客户的订单
Responsys 用户可以从支持他们要在其中发送 SMS 市场活动的国家/地区以及他们要发送的消息类型的 SMS 聚合商订购长代码或短代码。Responsys 用户在下订单之前能够比较每个可能 SMS 聚合商的计划的设置费用和每条消息成本。
Responsys 用户客户针对您的价目表中的一个计划下订单后,该订单将发送给您进行处理。Oracle Responsys 将向您发送电子邮件通知,订单将显示在您的管理订单页上。
如果您接受 Responsys 用户客户的订单并为该客户完成预配,则该客户可以使用他们从您那里购买的代码发送他们的 SMS 市场活动。
要处理 Oracle Responsys 客户的订单,请执行以下操作:
- 您从 Oracle Responsys 收到主题为“Responsy 客户已对代码下订单”的电子邮件时,打开该电子邮件以查看订单详细信息。
- 单击电子邮件中的链接以转至 Responsys 登录页,并使用您的 SMS 聚合商合作伙伴凭证登录。
- 在管理聚合商页上,单击配置图标 (
)。
- 单击管理订单。
- 在未结订单选项卡上,单击箭头来查看每个 Responsys 账户的订单。
- 要接受订单,请单击“订单状态”列中的绿色复选框图标。
- 要拒绝订单,请单击红色“X”框图标。
提示:您可以选择为每个 Responsys 账户的每种路由类型存储凭证,以便您使用完成订单页时,将不必输入凭证。要存储凭证,请单击账户的管理路由类型的凭证链接。在生成的页面上,找到您要为其存储凭证的路由类型。单击其
编辑图标。输入用户名和密码,然后单击保存。
- 如果您接受订单,将显示完成订单对话框。按如下所示完成各个字段:
- 输入账户 ID。这是 Responsys 客户在您的内部系统中的账户 ID,不是他们的 Responsys 账户 ID。
- 输入代码。
- 发件人名称(如果适用)显示客户请求的名称。
- 如果需要,您可以更改该名称。例如,如果发件人名称不可用,您可以将其更改为可用名称。每个发件人名称不能超过 11 个字符,可以包括字母(a-z 或 A-Z)或数字 (0-9)。
- 当路由类型为“移动设备接收 (MT) - 单向批量”时,必须提供发件人名称,但对于其他路由类型,发件人名称为可选。
- 如果客户未请求发件人名称,此字段显示“未请求”。
- (可选)输入等于或少于 150 个字符的备注。此消息将向 Responsys 客户显示。
- 在账户设置部分中,输入用户名和密码。这些是 Responsys 通过此代码向 SMS 聚合商系统发布 MT 消息时使用的凭证。如果您已经为此账户的路由类型保存了凭证,将不显示这些字段。
- 单击完成订单查看确认对话框,或单击取消关闭对话框而不保存。
- 查看确认对话框,然后单击完成订单将订单状态更改为“已完成”或单击取消关闭对话框而不保存。
- 将显示一条消息,指示订单已成功完成。
- 系统生成代码(可以在过去的订单选项卡上查看该代码)。
- 完成的订单从未结订单选项卡移至过去的订单选项卡。(可选)单击过去的订单可查看该订单。
- Responsys 用户客户将在他们的 SPAN 设置视图中看到该代码。
- 对您需要处理的每个订单重复步骤 5-8。
- 完成后,从 Responsys 注销:单击页面左上角的用户图标,然后选择注销。
要查看 Oracle Responsys 客户的过去的订单,请执行以下操作:
- 使用您的 SMS 聚合商合作伙伴凭证登录到 Responsys。
- 在管理聚合商页上,单击配置图标 (
)。
- 单击管理订单。
- 单击过去的订单,然后单击您要查看其过去订单的 Responsys 客户账户旁边的箭头。
生成的表显示订单详细信息,例如订单完成日期、客户订购的内容以及状态。
- (可选)将您的鼠标光标移动到某行的详细信息图标上以查看更多信息:发送给客户的消息、客户下订单的日期以及订单的定价详细信息。
在 Responsys 中管理客户账户
此部分提供 SPAN 聚合商的其他正在进行的账户管理任务的说明:
处理发件人名称更改请求
您的 Responsys SPAN 客户可以提交发件人名称更改请求。客户为他们的账户请求发件人名称更改时,您将收到电子邮件消息。
重要提示:SMS 聚合商负责在 Responsys 系统外确认客户的发件人名称是唯一的,并且符合客户将在其中使用该名称的国家/地区的法规。
要处理发件人名称更改请求,请执行以下操作:
- 您从 Oracle Responsys 收到主题为“Responsy 客户已发出发件人名称请求”的电子邮件时,打开该电子邮件以查看请求详细信息。
- 单击电子邮件中的链接以转至 Responsys 登录页,并使用您的 SMS 聚合商合作伙伴凭证登录。
- 在管理聚合商页上,单击配置图标 (
)。
- 单击管理发件人名称请求。
- 在未结请求选项卡上,单击箭头来查看每个 Responsys 账户的请求。
- 要接受请求,请单击“请求状态”列中的绿色复选框图标。这将显示完成请求对话框,可以在其中输入备注。单击完成请求以继续。
- 要拒绝请求,请单击红色“X”框图标。这将显示完成请求对话框,您必须在其中输入拒绝请求的原因。单击拒绝请求以继续。
- 查看确认对话框并遵循其说明以继续,或者单击取消关闭对话框而不保存。
- 如果您接受了请求,将显示一条消息,指示请求已成功完成。请求的状态将更改为“已完成”。
- 如果您拒绝了请求,将显示一条消息,指示请求已被拒绝。请求的状态将更改为“已拒绝”。
- 已处理请求将从未结请求选项卡移至过去的请求选项卡。(可选)单击过去的请求可查看该请求。
- 如果接受,Responsys 用户客户将在他们的 SPAN 设置视图中看到该发件人名称。
- 对您需要处理的每个请求重复步骤 5-8。
- 完成后,从 Responsys 注销:单击页面左上角的用户图标,然后选择注销。
上载支持请求单数据
可以上载数据文件,其中包含过去 90 天内为 Oracle Responsys 客户创建或解决的支持请求单。(这些支持请求单在您自己的支持请求单系统中进行处理。)该文件可以包含您的所有客户的请求单,但是因为每个记录都具有客户的账户 ID,所以每个 Responsys SPAN 客户都将仅看到他们的账户的支持请求单。
注意:每次文件上载都在 Responsys 中完全刷新您的支持请求单数据;它不是添加到您已上载的数据。
要上载支持请求单数据,请执行以下操作:
- 使用您的 SMS 聚合商合作伙伴凭证登录到 Responsys。
- 在管理聚合商页上,单击配置图标 (
)。
- 单击支持请求单详细信息。(第一次查看此选项卡时,您将看到有关支持请求单数据文件的信息。)
- 单击查看示例 SupportTicket.csv 文件来查看用于创建 CSV 文件的说明以及复制示例。
- 滚动到示例支持请求单对话框的底部,转到示例 supportTicket.csv 文件框。
- 单击
复制到剪贴板图标。
- 将示例 .csv 文件粘贴到您将用于创建支持请求单详细信息文件的编辑器。
- 遵循示例支持请求单对话框上的说明,创建 CSV 文件。
重要提示:请仔细阅读示例支持请求单对话框上的说明,特别是账户 ID 列的说明、文件大小限制 (5 MB) 以及打开和关闭日期的限制(在过去 90 天内)。具有正确的信息可确保每个 Responsys 客户都将看到他们的支持请求单。
- 单击支持请求单详细信息选项卡中的上载文件或示例支持请求单对话框中的立即上载。浏览并上载您创建的 CSV 文件。支持请求单详细信息将显示在页面上。
常见问题
要获得有关 SPAN 配置问题的帮助,请联系 Oracle 合作伙伴网技术支持。
如果您的公司是 Oracle 合作伙伴网络计划的有效成员,则已向您公司的合作伙伴管理员(管理您公司与 Oracle 的关系)提供了您的组织的唯一公司 ID。创建服务请求 (Service Request, SR) 时使用此公司 ID。为了即时传送您的 SR,请确保该 SR 提及您是参加了 SPAN 的 Responsys SMS 聚合商合作伙伴。
完成会话后如何从 Responsys 注销?
要从 Responsys 注销:请单击页面左上角的图标(具有用户名的第一个字母的圆圈)以显示用户操作菜单,然后选择注销。