Tutorial: enviar eventos ao Zendesk por meio do Amazon EventBridge - Amazon EventBridge
Pré-requisitosEtapa 1: criar uma conexãoEtapa 2: criar um destino de APIEtapa 3: criar regraEtapa 4: testar a regraEtapa 5: limpar os recursos

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Tutorial: enviar eventos ao Zendesk por meio do Amazon EventBridge

É possível usar o EventBridge para encaminhar eventos para serviços de terceiros, como Zendesk.

Neste tutorial, será usado o console do EventBridge para criar uma conexão aoZendesk, um Destino de API que aponta para o Zendesk e uma regra que roteia eventos para o Zendesk.

Pré-requisitos

Para concluir este tutorial, serão necessários os seguintes recursos:

Etapa 1: criar uma conexão

Para enviar eventos para o Zendesk, primeiro é preciso estabelecer uma conexão com a API do Zendesk.

Para criar a conexão

  1. Abra o console do Amazon EventBridge em https://console.aws.amazon.com/events/.

  2. No painel de navegação, escolha Destinos de API.

  3. Escolha a guia Conexões e Criar conexão.

  4. Insira um nome e uma descrição para a conexão. Por exemplo, insira Zendesk para o nome e Connection to Zendesk API para a descrição.

  5. Em Tipo de autorização, escolha Básico (nome de usuário/senha).

  6. Em Nome de usuário, insira seu nome de usuário do Zendesk.

  7. Em Senha, insira sua senha do Zendesk.

  8. Escolha Criar.

Etapa 2: criar um destino de API

Agora que criou a conexão, criará o destino da API para usar como destino da regra.

Para criar o destino de API

  1. Abra o console do Amazon EventBridge em https://console.aws.amazon.com/events/.

  2. No painel de navegação, escolha Destinos da API.

  3. Escolha Criar destino de API.

  4. Insira um nome e uma descrição para o destino de API. Por exemplo, insira ZendeskAD para o nome e Zendesk API destination para a descrição.

  5. Em Endpoint de destino da API, insira https://your-subdomain.zendesk.com/api/v2/tickets.json, onde your-subdomain é o subdomínio associado à sua conta Zendesk.

  6. Em Método HTTP, escolha POST.

  7. Em Limite de taxa de invocação, insira 10.

  8. Em Conexão, escolha Usar uma conexão existente e escolha a conexão Zendesk criada na etapa 1.

  9. Escolha Criar.

Etapa 3: criar regra

Em seguida, crie uma regra para enviar eventos para o Zendesk quando um objeto do Amazon S3 é criado.

Como criar uma regra

  1. Abra o console do Amazon EventBridge em https://console.aws.amazon.com/events/.

  2. No painel de navegação, escolha Regras.

  3. Escolha Create rule.

  4. Insira um nome e uma descrição para a regra. Por exemplo, insira ZendeskRule para o nome e Rule to send events to Zendesk when S3 objects are created para a descrição.

  5. Em Barramento de eventos, escolha padrão.

  6. Em Rule type, escolha Rule with an event pattern.

  7. Escolha Próximo.

  8. Em Fonte do evento, escolha Outra.

  9. Em Padrão de evento, insira um do seguintes:

    {
  "source": ["aws.s3"]
}

  10. Escolha Próximo.

  11. Em Tipos de destino, escolha o Destino da API do EventBridge.

  12. Em Destino da API, escolha Usar um destino de API existente e escolha o destino do ZendeskAD criado na etapa 2.

  13. Em Perfil de execução, escolha Criar um novo perfil para este recurso específico.

  14. Para Configurações de atualização, faça o seguinte:

    1. Em Configurar entrada de destino, escolha Transformador de entrada na lista suspensa.

    2. Escolha Configurar transformador de entrada

    3. em Eventos de amostra, insira o seguinte:

      {
  "detail":[]
}

    4. Para o Transformador de entrada de destino, faça o seguinte:

      1. Em Caminho de entrada, insira o seguinte:

        {"detail":"$.detail"}

      2. Em Modelo de entrada, insira o seguinte:

        {"message": <detail>}

    5. Escolha Confirmar.

  15. Escolha Próximo.

  16. Escolha Próximo.

  17. Analise os detalhes da regra e selecione Criar regra.

Etapa 4: testar a regra

Para testar sua regra, crie um objeto do Amazon S3 fazendo o upload de um arquivo em um bucket compatível com o Eventbridge. Quando o evento corresponder à regra, o EventBridge chamará a API Criar tíquete do Zendesk. O novo tíquete aparecerá no painel Zendesk.

Etapa 5: limpar os recursos

Agora você pode excluir os recursos criados para este tutorial, a menos que queira mantê-los. Ao excluir os recursos da AWS que não estão mais sendo usados, são evitadas cobranças desnecessárias em sua conta da AWS.

Para excluir as conexões do EventBridge

  1. Abra a página de Destino da API do console do EventBridge.

  2. Escolha a guia Connections (Conexões).

  3. Selecione as Conexões que foram criadas.

  4. Escolha Excluir.

  5. Insira o nome da conexão e escolha Excluir.

Para excluir os destinos da API do EventBridge

  1. Abra a página de Destino da API do console do EventBridge.

  2. Selecione os destinos da API que foram criados.

  3. Escolha Excluir.

  4. Insira o nome do destino da API e escolha Excluir.

Para excluir as regras do EventBridge

  1. Abra a página Regras no console do EventBridge.

  2. Selecione as regras que foram criadas.

  3. Escolha Excluir.

  4. Escolha Excluir.