Tutorial: criar uma conexão com o Zendesk como destino de API

Você pode usar EventBridge para rotear eventos para serviços de terceiros, como Zendesk.

Neste tutorial, você usará o EventBridge console para criar uma conexãoZendesk, um destino de API que aponta e uma regra para a qual rotear eventosZendesk. Zendesk

Pré-requisitos

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

• Uma conta do Zendesk.

• Um bucket EventBridge habilitado do Amazon Simple Storage Service (Amazon S3).

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 EventBridge console da Amazon em https://console.aws.amazon.com/events/.

2. No painel de navegação, escolha Destinos da 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 EventBridge console da Amazon 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.

Para criar uma regra do

1. Abra o EventBridge console da Amazon 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 Event Bus (Barramento de eventos), escolha default (padrão).

6. Em Tipo de Regra, escolha Regra com Padrão de Evento.

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 EventBridge da API.

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 habilitado. EventBridge Quando o evento corresponder à regra, EventBridge chamará a API Zendesk Create Ticket. 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 AWS recursos que você não está mais usando, você evita cobranças desnecessárias em sua AWS conta.

Para excluir as EventBridge conexões

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

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 o (s) destino (s) da EventBridge API

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

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 a (s) EventBridge regra (s)

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

2. Selecione as regras que foram criadas.

3. Escolha Delete (Excluir).

4. Escolha Excluir.