教程:创建连接,将 Zendesk 作为 API 目标 - Amazon EventBridge

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

教程:创建连接,将 Zendesk 作为 API 目标

您可以使用 EventBridge 将事件路由到第三方服务,例如Zendesk

在本教程中,您将使用 EventBridge 控制台创建指向的连接Zendesk、指向Zendesk的 API 目标以及将事件路由到的规则Zendesk。

先决条件

完成本教程需要以下资源:

步骤 1:创建连接

要向 Zendesk 发送事件,您必须先与 Zendesk API 建立连接。

创建连接
  1. 打开亚马逊 EventBridge 控制台,网址为 https://console.aws.amazon.com/events/

  2. 在导航窗格中,选择 API 目标

  3. 选择连接选项卡,然后选择创建连接

  4. 为连接输入名称和描述。例如,输入 Zendesk 作为名称,Connection to Zendesk API 作为描述。

  5. 对于授权类型,选择基本(用户名/密码)

  6. 对于用户名,输入您的 Zendesk 用户名。

  7. 对于密码,输入您的 Zendesk 密码。

  8. 选择创建

步骤 2:创建 API 目标

现在,您已经创建了连接,接下来您将创建用作规则目标的 API 目标。

创建 API 目标
  1. 打开亚马逊 EventBridge 控制台,网址为 https://console.aws.amazon.com/events/

  2. 在导航窗格中,选择 API 目标

  3. 选择创建 API 目标

  4. 为 API 目标输入名称和描述。例如,输入 ZendeskAD 作为名称,Zendesk API destination 作为描述。

  5. 对于 API 目标端点,请输入 https://your-subdomain.zendesk.com/api/v2/tickets.json,其中 your-subdomain 是与您的 Zendesk 账户关联的子域名。

  6. 对于 HTTP 方法,选择 POST

  7. 对于调用速率限制,输入 10

  8. 对于连接,选择使用现有连接,然后选择您在步骤 1 中创建的 Zendesk 连接。

  9. 选择创建

步骤 3:创建规则

接下来创建一条规则,在创建 Amazon S3 对象后将事件发送到 Zendesk。

创建 规则
  1. 打开亚马逊 EventBridge 控制台,网址为 https://console.aws.amazon.com/events/

  2. 在导航窗格中,选择规则

  3. 选择创建规则

  4. 为规则输入名称和描述。例如,输入 ZendeskRule 作为名称,Rule to send events to Zendesk when S3 objects are created 作为描述。

  5. 对于事件总线,选择默认

  6. 对于规则类型,选择具有事件模式的规则

  7. 选择下一步

  8. 对于事件源,选择其他

  9. 对于事件模式,输入以下代码:

    { "source": ["aws.s3"] }
  10. 选择下一步

  11. 对于目标类型,请选择 EventBridge API 目标

  12. 对于 API 目标,选择使用现有 API 目标,然后选择您在步骤 2 中创建的 ZendeskAD 目标。

  13. 对于执行角色,选择为此特定资源创建新角色

  14. 对于其他设置,执行以下操作:

    1. 对于配置目标输入,从下拉列表中选择输入转换器

    2. 选择配置输入转换器

    3. 对于示例事件,输入以下代码:

      { "detail":[] }
    4. 对于目标输入转换器,执行以下操作:

      1. 对于输入路径,输入以下代码:

        {"detail":"$.detail"}
      2. 对于输入模板,输入以下代码:

        {"message": <detail>}
    5. 选择确认

  15. 选择下一步

  16. 选择下一步

  17. 查看规则详细信息并选择创建规则

步骤 4:测试规则

要测试您的规则,请通过将文件上传到 EventBridge已启用的存储桶来创建 Amazon S3 对象。当活动符合规则时, EventBridge 将调用 C Zendeskreate Ticket API。新工单将显示在 Zendesk 控制面板中。

步骤 5:清理资源

除非您想要保留为本教程创建的资源,否则可立即将其删除。通过删除不再使用的 AWS 资源,可以防止向您的 AWS 账户收取不必要的费用。

删除 EventBridge 连接
  1. 打开 EventBridge 控制台的 API 目标页面

  2. 选择连接选项卡。

  3. 选择您创建的连接。

  4. 选择删除

  5. 输入连接的名称,然后选择删除

删除 EventBridge API 目的地
  1. 打开 EventBridge 控制台的 API 目标页面

  2. 选择您创建的 API 目标。

  3. 选择删除

  4. 输入 API 目标的名称,然后选择删除

要删除 EventBridge 规则
  1. 打开 EventBridge 控制台的 “规则” 页面

  2. 选择您创建的规则。

  3. 选择 Delete

  4. 选择 删除