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
<a name="eb-tutorial-zendesk"></a>

É possível usar o EventBridge para encaminhar [eventos](eb-events.md) para serviços de terceiros, como [https://www.zendesk.com/](https://www.zendesk.com/).

Neste tutorial, será usado o console do EventBridge para criar uma conexão aoZendesk, um [Destino de API](eb-api-destinations.md) que aponta para o Zendesk e uma [regra](eb-rules.md) que roteia eventos para o Zendesk. 

**Topics**
+ [Pré-requisitos](#eb-zd-prereqs)
+ [Etapa 1: criar uma conexão](#eb-zd-create-connection)
+ [Etapa 2: criar um destino de API](#eb-zd-api-destination)
+ [Etapa 3: criar regra](#eb-zd-create-rule)
+ [Etapa 4: testar a regra](#eb-zd-test-rule)
+ [Etapa 5: limpar os recursos](#cleanup)

## Pré-requisitos
<a name="eb-zd-prereqs"></a>

Para concluir este tutorial, serão necessários os seguintes recursos:
+ Uma [conta do Zendesk](https://www.zendesk.com/register/#step-1).
+ Um bucket do [Amazon Simple Storage Service (Amazon S3)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html) habilitado pelo EventBridge.

## Etapa 1: criar uma conexão
<a name="eb-zd-create-connection"></a>

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/](https://console.aws.amazon.com/events/).

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

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

1. 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.

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

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

1. Em **Senha**, insira sua senha do Zendesk.

1. Escolha **Criar**.

## Etapa 2: criar um destino de API
<a name="eb-zd-api-destination"></a>

Agora que criou a conexão, criará o destino da API para usar como [destino](eb-targets.md) da regra.

**Para criar o destino de API**

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

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

1. Escolha **Criar destino de API**.

1. 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.

1. 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.

1. Em **Método HTTP**, escolha **POST**.

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

1. Em **Conexão**, escolha U**sar uma conexão existente** e escolha a conexão `Zendesk` criada na etapa 1.

1. Escolha **Criar**.

## Etapa 3: criar regra
<a name="eb-zd-create-rule"></a>

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/](https://console.aws.amazon.com/events/).

1. No painel de navegação, escolha **Regras**.

1. Escolha **Create rule**.

1. 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.

1. Em **Barramento de eventos**, escolha **padrão**.

1. Em **Rule type**, escolha **Rule with an event pattern**.

1. Escolha **Próximo**.

1. Em **Fonte do evento**, escolha **Outra**.

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

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

1. Escolha **Próximo**.

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

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

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

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

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

   1. Escolha **Configurar transformador de entrada**

   1. em **Eventos de amostra**, insira o seguinte:

      ```
      {
        "detail":[]
      }
      ```

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

      1. Em **Caminho de entrada**, insira o seguinte:

         ```
         {"detail":"$.detail"}
         ```

      1. Em **Modelo de entrada**, insira o seguinte:

         ```
         {"message": <detail>}
         ```

   1. Escolha **Confirmar**.

1. Escolha **Próximo**.

1. Escolha **Próximo**.

1. Analise os detalhes da regra e selecione **Criar regra**.

## Etapa 4: testar a regra
<a name="eb-zd-test-rule"></a>

Para testar sua regra, crie um [objeto do Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/upload-objects.html) 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](https://developer.zendesk.com/rest_api/docs/support/tickets#create-ticket). O novo tíquete aparecerá no painel Zendesk.

## Etapa 5: limpar os recursos
<a name="cleanup"></a>

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](https://console.aws.amazon.com/events/home#/apidestinations) do console do EventBridge.

1. Escolha a guia **Connections (Conexões)**.

1. Selecione as Conexões que foram criadas.

1. Escolha **Excluir**.

1. 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](https://console.aws.amazon.com/events/home#/apidestinations) do console do EventBridge.

1. Selecione os destinos da API que foram criados.

1. Escolha **Excluir**.

1. Insira o nome do destino da API e escolha **Excluir**.

**Para excluir as regras do EventBridge**

1. Abra a página [Regras](https://console.aws.amazon.com/events/home#/rules) no console do EventBridge.

1. Selecione as regras que foram criadas.

1. Escolha **Excluir**.

1. Escolha **Excluir**.