为 Shomer 设置集成 - Amazon Connect

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

为 Shomer 设置集成

要定期更新 Amazon Connect 客户资料,您可以使用亚马逊与 Shopify 集成AppIntegrations。您首先在Amazon Connect 和 Shopify 中设置连接,然后验证 Shopify 集成。

在亚马逊 Connect 和 Shopify 中设置连接

  1. 通过 https://console.aws.amazon.com/connect/ 打开 Amazon Connect 控制台。

  2. 在实例页面上,选择实例别名。实例别名也是您的实例名称,出现在您的 Amazon Connect 网址中。下图显示了 Amazon Connect 虚拟联络中心实例页面,实例别名周围有一个方框。

    
                                    Amazon Connect 虚拟联络中心实例页面,实例别名。
  3. 在导航窗格中,选择客户资料

  4. 客户资料配置页面上,选择添加集成

    
                                    客户资料配置页面,添加集成按钮。
  5. 选择来源页面上,选择 Shopify。查看 “选择应用程序” 页面上列出的申请要求。

    
                                    选择源页面。
  6. 建立连接页面上,选择以下选项之一:

    • 使用现有连接:这允许您重复使用您可能在自己创建的现有亚马逊EventBridge资源AWS 账户。

    • 创建新连接:输入外部应用程序所需的信息。

      
                                            建立连接页面。
      • 连接名称:为连接提供名称。使用此连接的集成会引用连接名称。

      • 连接 URL:输入您的应用程序连接 URL。此 URL 用于深度链接到在外部应用程序中创建的对象。连接网址是应用程序网站上提供的 Shopify 合作伙伴应用程序网址。

        要查找您的 Shopify 合作伙伴应用程序网址,请执行

        • 登录你的 partners.shopify.com 账户。

        • 转到您的应用程序。

        • 从浏览器复制网址。

      • 客户端 ID:输入您的应用程序客户端 ID。这是一个在外部应用程序中唯一区分客户端的字符串。此客户端 ID 是应用程序网站上提供的源名称。您可以使用在此处指定的 ID 来标识您希望 Customer Profiles 从中提取对象的客户端。完成源代码设置步骤后,您的客户端 ID 可能可用。

        要查找您的来源名称,请执行以下操作:

        • 登录你的 partners.shopify.com 账户。

        • 转到您的应用程序。

        • 从您的亚马逊EventBridge事件源复制来源名称。

  7. 来源设置页面上,将您的AWS 账户 ID 复制到剪贴板,然后选择登录 Shopify

  8. 按照以下说明设置 Shopify:

    1. 登录 partners.shopify.com。

    2. 在 “亚马逊” 下EventBridge,选择 “创建来源”。

    3. 粘贴您的AWS 账户 ID 并选择您的AWS区域。

    4. 设置事件源目的地后,返回客户档案。您将看到一条提醒,表明Amazon Connect 已成功与 Shopify 建立连接。

  9. 集成选项页面上,选择要提取的源对象并选择其对象类型。

    对象类型存储您摄取的数据。它们还定义了在引入集成的对象时如何将其映射到配置文件。客户配置文件提供了默认对象类型模板,您可以使用这些模板定义如何将源对象中的属性映射到客户配置文件中的标准对象。您也可以使用从中创建的对象映射PutProfileObjectType

    
                                    集成选项页面。
  10. 对于采集开始日期,客户档案开始采集添加集成后创建的记录。

    注意

    如果您需要历史记录,可以使用 Amazon S3 作为集成源来导入它们

  11. 在 “查看和集成” 页面上,检查连接状态是否显示为 “已连接”,然后选择 “添加集成”。

    注意

    添加此集成后,您需要设置 webhook 订阅,以允许事件开始流入此集成。

    
                                    “查看和整合” 页面。
  12. 设置集成后,返回客户资料配置页面,集成部分显示当前设置了哪些集成。上次运行集成运行状况目前不适用于此类集成。

    
                                    集成部分。

    要查看正在发送哪些数据,请选择集成,然后选择查看对象

  13. 转到下一步,使用 API 设置 webhook 订阅,以便事件可以开始流入此集成。

设置 webhook 订阅

  1. 使用以下 URL 来确保您的应用程序具有所需的权限:

    https://{shop}.myshopify.com/admin/oauth/authorize?client_id={api_key}&scope={scopes}&redirect_uri={redirect_uri}&state={nonce}

    其中:

    • shop是您的 Shomer Gateways。

    • api_key是你的 Shopify 应用程序的 API 密钥。您可以在 Shopify 应用详细信息页面上找到此信息。

    • scopes应该有这个值read_customers,read_orders,read_draft_orders

    • redirect_uri是您在创建应用程序时为其指定的重定向 URI。就我们的目的而言,它可以是任何有效的网址。

    • nonce可以是任何用于识别他人给定授权请求的唯一值。我们建议使用时间戳。

    构建 URL 后,将其粘贴到您的浏览器中。将显示类似于下图的安装/授权页面,要求商店所有者授予定义范围的权限。

    
                                    shopify页面。
  2. 选择 “安装未发布的应用程序” 以代表您的商店安装和授权该应用程序。

    您将被带到您输入的重定向 URI,并在重定向 URI 后附加授权码作为查询参数。例如:

    https://example.org/some/redirect/uri?code={authorization_code}&hmac=da9d83c171400a41f8db91a950508985&host={base64_encoded_hostname}&timestamp=1409617544&state={nonce}&shop={shop_origin}&host={host}
  3. 复制此 URI 中的。authorization_code在接下来的步骤中,你将使用它来获得永久访问令牌。

  4. 使用任何用于进行 API 调用的工具。例如,CURLPOSTMAN

  5. 要获取永久访问令牌,请向此终端节点发出 ShopifyAdmin API 的 POST 请求:

    https://{shop}.myshopify.com/admin/oauth/access_token

    使用以下请求正文:

    { "code": "authorization_code_received_from_redirect_uri", "client_id": "your_app_api_key", "client_secret": "your_app_api_secret" }

    此请求返回以下响应:

    { "access_token": "permanent_access_token", "scope": "read_customers,read_orders,read_draft_orders" }
  6. 记下 access_token。这是一个永久令牌,其作用域与上一步相同。现在,您已准备好创建 Webhect 订阅。

  7. 对于以下 API 调用,请确保将 HTTP 标头密钥设置X-Shopify-Access-Token为从先前调用的响应中收到的。access_token

  8. 要设置 webhook 订阅,请对下一步中列出的每个topic值发出以下 POST 请求:

    终端节点:https://{shop}.myshopify.com/admin/api/2021-04/webhooks.json

    请求正文传递:

    { "webhook": { "topic": "replace_this_with_one_of_the_topics_in_the_list_below", "address": "this_is_the_event_source_arn_generated_when_you_created_the_event_integration", "format": "json" } }
  9. 对于每个订阅,将的值替换为topic以下值:

    • customers/create

    • customers/enable

    • customers/update

    • draft_orders/create

    • draft_orders/update

    • orders/cancelled

    • orders/create

    • orders/fulfilled

    • orders/paid

    • orders/partially_fulfilled

    • orders/updated

现在,您已准备好接收来自 Shopify 商店的活动。接下来,验证您的 Shopify 集成。

验证您的 Shomer 集成

  1. 以管理员身份登录您的 Shopify 商店。

  2. 在左侧导航菜单中,选择客户

  3. 选择添加客户

  4. 输入您的客户详细信息。请务必输入电话号码和电子邮件。这些不一定属于真正的客户。验证集成后,您将删除此客户条目。

  5. 保存客户对象。

  6. 活动交付应几乎是即时的,但要等一分钟才能交付活动并创建客户档案。

  7. 打开 Amazon Connect 代理体验,通过您在 Shopify 商店中输入的电子邮件或电话号码查找用户。您应该能够使用相同的电子邮件或电话号码查看客户资料。

  8. 如果您看不到客户资料,则说明您的集成存在问题。要进行故障排除:

    1. 转到AmazonEventBridge 控制台。

    2. 检查是否EventSource处于活动状态以及匹配项是否EventBus存在且正在运行。

    如果这些都起作用,请联系AWS Support以寻求调查问题的帮助。

监控您的客户资料集成

建立连接后,如果连接停止运行,请删除集成,然后重新建立。

如果未发送对象该怎么办

如果对象无法发送,请选择 Flow detials 以详细了解出了什么问题。

您可能需要删除配置并重新连接到外部应用程序。