IBM®Silverpop®连接器和IBM SilverpopEngage®的组合作为营销团队的一部分,可以实现更安全,更有针对性的电子邮件营销和潜在客户生成活动。 而且,借助IBMWebSphere®Cast Iron,您可以将Silverpop Engage与其他企业系统无缝集成,以帮助改善公司的销售和营销策略。 通过同步从Silverpop Engage到SugarCRM系统的新线索的得分或排名,营销团队可以识别出显示出更强购买力的线索,以供销售人员关注。
本教程重点介绍了技巧,以帮助您使用IBM WebSphere Cast Iron配置和集成Silverpop连接器活动。 您将学习如何使用OAuth 2.0身份验证将Silverpop连接器安全地连接到Silverpop Engage平台,以及如何将WebSphere Cast Iron Studio中的Silverpop连接器端点连接到Silverpop Engage。 您还将学习如何配置Silverpop连接器活动以及如何通过使用WebSphere Cast Iron将Silverpop与SugarCRM系统集成。
要求
在阅读本教程之前,您应该熟悉IBM WebSphere Cast Iron Studio,与之相关的术语以及它所支持的连接器。 您还应该具有Silverpop及其连接器活动的基本知识。
为了获得最佳结果,需要以下产品和资产:
- WebSphere Cast Iron Studio V7.5
- WebSphere铸铁设备V7.5
- Silverpop Engage用户界面和登录详细信息
- SugarCRM用户界面和登录详细信息
建立OAuth 2.0身份验证以将Silverpop连接器连接到Silverpop Engage
通过在Silverpop中使用OAuth 2.0身份验证,您可以绕过用户名和密码身份验证以与Silverpop Engage平台一起使用。 要在Silvercast Engage和WebSphere Cast Iron中的Silverpop连接器之间建立OAuth 2.0认证,必须首先生成刷新令牌,客户端ID和客户端密钥。 然后,您必须生成一个访问令牌。
生成带有客户端ID和客户端密钥的刷新令牌
要利用Silverpop中的OAuth 2.0身份验证连接到Silverpop Engage平台,您需要访问令牌。 访问令牌是一个字符串值,表示无需使用用户名和密码即可安全地访问客户端的授权。
在生成访问令牌之前,必须生成刷新令牌,客户端ID和客户端密钥:
- 从Silverpop Portal用户界面(UI)登录。
- 选择设置>组织设置 。
- 单击以展开“ 应用程序帐户访问” ,然后选择“ 添加应用程序” 。
- 输入名称(任何唯一名称)和您的应用程序描述。 单击确定 。 客户端ID和客户端机密值生成后,保存它们。
- 选择您的应用程序,然后在创建或添加的应用程序列表下方,点击添加帐户访问 。
您会收到一封带有主题行的电子邮件:“已发出用户帐户刷新令牌。” 该电子邮件发送到注册的邮件ID(登录邮件ID),其中包含刷新令牌。
- 保存刷新令牌值。
生成访问令牌
访问令牌可帮助您无需使用用户名和密码即可将Silverpop与Silverpop Engage安全连接。 要生成访问令牌,请从Google Chrome Advanced REST客户端或任何其他REST客户端输入以下URL进行REST调用,其中[x]是互动窗格编号:
https://api[x].pilot.silverpop.com/oauth/token
例如,如果互动窗格编号为1,则URL为:
https://api1.pilot.silverpop.com/oauth/token
URL警告消息:在浏览器中输入URL时,将显示一条警告消息,说明证书是自签名的。 如果要访问自己的服务器,则可以接受自签名证书并继续。 当您到达页面时,请使用REST客户端并获取访问令牌。
在主体(如清单1所示)中,输入正确的客户端ID,客户端密码并刷新以前生成的令牌值。
清单1.生成访问令牌
Header: Content-type: application/x-www-form-urlencoded
Operation: POST
Body:
grant_type=refresh_token&client_id=e4d37a88-9a4d-4f4d-bf9e-2bbd7&client_secret=e11ebd7b-df6a-4ae9-9920-43938&refresh_token=qwe6JAcg_rqkc9lYP-qczLvDtWW4ORQRgrXKoARUS1
正文语法 :执行REST调用时,请在正文中的每个参数,客户端密码和刷新令牌值之间保留与符号(&)。
图1显示了生成访问令牌的REST POST调用。 它提供URL,标题和正文。
图1. REST POST调用以生成访问令牌
清单2显示了来自图1的REST API POST调用的示例输出响应。生成的访问令牌为"cdUevem8i1VZKz1rFHCPD0a730Gd5LjVOG-UQwS1"
。
清单2. REST客户端的示例输出
{
access_token: "cdUevem8i1VZKz1rFHCPD0a730Gd5LjVOG-UQwS1"
token_type: "bearer"
refresh_token: "qwe6JAcg_rqkc9lYYV2cP-qczLORQRgrXKoARUS1"
expires_in: 6933
}
将Silverpop连接器端点连接到Silverpop Engage
为了确保Silverpop连接器端点和Silverpop Engage之间的连接,WebSphere Cast Iron Studio提供了一个“测试连接”按钮。 要将Silverpop连接器端点连接到WebSphere Cast Iron Studio中的Silverpop Engage:
- 打开WebSphere Cast Iron Studio。
- 为Silverpop连接器创建一个项目。
- 创建一个业务流程工作区,以处理Silverpop连接器的活动。 在面板的左侧,单击“ 端点”图标,然后单击“ Silverpop连接器” 。
- 在Silverpop端点窗口中的Silverpop选项卡上,在“连接详细信息”下(图2):
- 输入Silverpop连接器详细信息:
- 应用程序网址:
api[x].pilot.silverpop.com
- 身份验证URL:
https://api[x].pilot.silverpop.com/oauth/token
用您的互动广告连播编号替换[x]。
- 访问令牌:从REST API输出中输入令牌(请参见清单1)。
- 刷新令牌:从您收到的电子邮件中输入令牌。
- 客户端ID和客户端密钥:在“与客户端ID和密钥一起生成刷新令牌”部分的创建的应用程序中输入这些值。
- 应用程序网址:
- 可选:在“代理连接详细信息”下输入代理详细信息。
图2. Silverpop连接器端点
- 单击测试连接。
- 输入Silverpop连接器详细信息:
- 验证Silverpop Engage和Silverpop连接器之间的连接。
参与Silverpop连接器活动
通过在Silverpop V1中添加连接器活动 ,您现在可以添加,删除,选择和更新联系人和潜在客户。 当前版本专注于Silverpop Engage中的联系和潜在顾客操作。
验证与Silverpop连接器的连接成功后,可以将Silverpop连接器活动拖到“业务流程”窗口中。 在清单中,您将看到以下选项卡,这些选项卡可用于每个Silverpop连接器活动:
- 摘要选项卡 。 查看活动摘要。
- 选择“端点”选项卡。 选择Silverpop端点,或者创建或修改一个新端点。 当您需要将活动连接到其他Silverpop Engage平台时,此选项卡很有用。
- 配置选项卡。 浏览并配置Silverpop连接器活动。
- 地图输入标签。 输入每个活动的输入。
- 地图输出选项卡。 查看架构输出。
以下各节更详细地显示“配置”,“映射输入”和“映射输出”选项卡。 尽管每个连接器活动都有相同的选项卡,但是您输入的字段和值对于每个活动项都是不同的。
配置标签
必须先在Silverpop Engage中创建数据库,然后才能使用Silverpop连接器活动的“配置”选项卡。 如果创建了数据库,则可以选择一个来保存联系人或潜在顾客。 如果需要创建数据库:
- 登录到Silverpop Engage平台。
- 选择数据>数据库>创建 。 您可以创建常规,测试列表,抑制列表或种子列表数据库。
- 输入要创建的数据库的名称,例如
Silverpop1
。 选择您希望数据库是私有的还是在用户之间共享的。 单击下一步 。 - 将字段添加到您的联系人或潜在客户条目。 编辑唯一标识符。 然后,选择必填字段。 最后,点击创建 。
创建数据库之后,可以从WebSphere Cast Iron在Silverpop Engage中浏览它:
- 在“ 数据库摘要”选项卡上,您可以在其中查看所有数据库字段,单击“ 显示其他详细信息”以查看数据库ID。
- 在“ 配置”选项卡上,单击“ 浏览”按钮以浏览Silverpop连接器数据库(图3)。
图3.从Configure选项卡中选择一个Silverpop对象
图4显示为从Silverpop Engage检索的数据库显示的字段。
图4. Configure选项卡上的Silverpop Connector活动字段
地图输入标签
在Map Inputs选项卡(图5)上,输入每个字段的输入。 您必须配置地图输入详细信息,以对每个活动获得正确的响应。 有关此选项卡上的字段的信息,对于IBM知识中心内WebSphere Cast Iron的Silverpop活动部分中的每个连接器活动,请遵循业务流程链接下方显示的Configure Activity部分中的Click Map Map链接。
图5. Map Inputs选项卡
地图输出选项卡
Map Outputs选项卡(图6)显示了输出的响应模式,如果发生异常,则显示一条消息。 有关此选项卡上字段的信息,请从Silverpop活动部分中的每个活动的“在业务流程下方显示的配置活动部分中的“单击地图输入”链接,显示在业务流程中”页面,单击映射 活动 的输出 。
图6. Map Outputs选项卡
验证活动
配置活动后,要对其进行验证,请右键单击它,然后选择验证活动 。 在WebSphere Cast Iron的Verify选项卡上(图7),检查响应。
图7.验证业务流程或活动
要部署活动,请将入门活动添加到业务流程的开头,然后将其部署到设备。
要验证活动在设备中是否正常运行,请在WebSphere Cast Iron Studio中单击发布项目 。 然后,输入设备详细信息,然后单击“ 确定” 。
整合Silverpop和SugarCRM
通过使用WebSphere Cast Iron将Silverpop集成到各种平台(例如Salesforce,Force.com Bulk API和SugarCRM),可以提供持续的客户参与和支持。 本教程重点介绍SugarCRM和Silverpop集成。 该数字营销解决方案可以通过提供更好的针对性营销和销售策略来帮助确保更可实现的销售目标,从而改善客户关系管理。 图8说明了当您集成Silverpop和SugarCRM时WebSphere Cast Iron的工作方式。
图8.整合Silverpop和SugarCRM
为了演示使用WebSphere Cast Iron集成Silverpop和SugarCRM的优势,请考虑一家公司的情况,该公司需要设置营销线索的标准。 标准是线索达到一定分数后即合格。 然后将线索发送给SugarCRM,以分配给销售代表。 为达到此标准并促进与潜在客户和联系人的合作,WebSphere Cast Iron充当集成工具,同时支持Silverpop和SugarCRM连接器。
在这种情况下,公司希望将具有特定分数的销售线索信息从Silverpop转移到SugarCRM,以由销售代表来管理销售线索:
- 开发人员选择将Silverpop连接器(端点配置为端点)来访问潜在客户信息所在的Silverpop Engage。
- 开发人员使用SugarCRM连接器,其中将端点配置为连接到SugarCRM系统。 通过使用WebSphere Cast Iron,开发人员可以将Silverpop中的潜在客户转移到SugarCRM系统中的潜在客户,同时保留相同的客户信息。
此外,开发人员可以:
- 将引线转换为Silverpop到SugarCRM连接器的触点。
- 从Silverpop到SugarCRM创建,更新,删除或检索潜在客户和联系人,反之亦然,从SugarCRM到Silverpop。
要将Silverpop集成到WebSphere Cast Iron中的SugarCRM中:
- 打开WebSphere Cast Iron Studio。
- 创建一个项目,然后打开业务流程。
- 为两个SugarCRM连接器创建一个端点,如图9所示:
- 对于SugarCRM,输入以下信息:
- SugarCRM REST URL :输入SugarCRM Rest API实例的REST API URL,例如
https://<sugar-server>/<sugar-path>/rest/v10
。 - 用户名 :输入SugarCRM Rest API的用户名以连接到SugarCRM服务器。
- 密码 :输入与用户名关联的密码以连接到SugarCRM服务器。
- 客户端ID :输入SugarCRM的客户端ID以获取OAuth令牌。
- 客户端密码 :输入SugarCRM的客户端密码以获取OAuth令牌。
- SugarCRM REST URL :输入SugarCRM Rest API实例的REST API URL,例如
- 单击测试连接,并确保从WebSphere Cast Iron的SugarCRM端点与SugarCRM的连接成功。
图9.创建一个SugarCRM连接器端点
- 对于SugarCRM,输入以下信息:
- 为Silverpop Connector创建一个端点, 如图2所示。
- 添加一个启动器活动,并将Silverpop连接器的“ 选择线索”活动拖到“业务流程”工作区窗口中。
- 在“ 配置”选项卡上,选择从中转移潜在客户详细信息的数据库。
- 在“ 地图输入”选项卡上,输入“收件人ID”并填写必填字段,以从Silverpop Engage检索销售线索。
- 在Map Output选项卡上,将From活动架构复制到To Orchestration 。
- 将“ 创建对象 SugarCRM”活动拖到“业务流程”工作区窗口中。 图10显示了最终的业务流程。
图10.业务流程
- 在Configure选项卡(图11)中,浏览Leads对象,这是一个标准对象。
图11. SugarCRM连接器的“配置”选项卡
- 在Map Inputs选项卡上(图12),单击Select Inputs 。 然后,例如,选择body1 ,它将先前的活动字段(即Silverpop连接器的Select Lead活动)映射到SugarCRM连接器的Create Object活动。
图12. SugarCRM连接器的“映射输入”选项卡
- 要开始业务流程,请单击“ 验证业务流程” ,并确保将线索从SugarCRM GUI转移或添加到SugarCRM系统,如图13所示。
图13. SugarCRM用户界面,其中添加了条目
结论
本教程重点介绍了通过使用IBM WebSphere Cast Iron将IBM Silverpop与Silverpop Engage和SugarCRM结合使用的技巧。 您学习了如何使用Silverlight连接器的OAuth 2.0身份验证凭据来安全地连接到Silverpop Engage。 您还学习了如何将Silverpop连接器端点连接到Silverpop Engage平台,以及如何使用Silverpop活动。 此外,您还了解了如何通过将Silverpop与SugarCRM集成,可以将具有特定分数的销售线索信息传输到SugarCRM,以由销售代表来管理销售线索。
致谢
感谢Varun Ojha和Hariharan I. Subramanian在审阅本文和提供宝贵意见方面的帮助。