Configuração do Conector de eventos para o Amazon EventBridge da Zendesk

Observação: esse recurso está disponível para os seguintes planos:

• Zendesk Suite Growth com o complemento API para volume alto
• Plano Zendesk Suite Professional ou superior
• Plano Support Enterprise com o complemento API para volume alto
• Plano Support Suite Enterprise legado com o complemento API para volume alto
• Plano Sunshine Professional ou superior

O Amazon EventBridge é um serviço de barramento de eventos que consome streaming de dados de eventos do Zendesk. Os eventos recebidos no Amazon EventBridge podem ser redirecionados para os serviços da AWS como o streaming do AWS Lambda, o Amazon SNS, o Amazon SQS e o Amazon Kinesis. Isso permite que os aplicativos gerados por eventos definam quais aplicativos podem assinar e reagir aos eventos do Zendesk.

Essa arquitetura diminui a dependência e a sobrecarga de integrações baseadas em API e gerenciamento de API. O conector de eventos do Zendesk proporciona a conexão com o Amazon EventBridge para transmitir dados de eventos do Zendesk.

Para configurar uma conexão entre o conector de eventos e o Amazon EventBridge, você precisará de uma conta da AWS. Em seguida, você configura a origem do evento do Zendesk na Central de administração do Zendesk e associa um novo barramento de eventos com a origem do evento do Zendesk no Amazon EventBridge.

Este artigo contém os seguintes tópicos:

• Configuração da origem do evento do Zendesk
• Associação da origem do evento do Zendesk ao barramento de eventos
• Exclusão de uma conexão de evento

Informações relacionadas:

• Esquema de eventos para o Amazon EventBridge
• Publicação de notificações do Amazon SNS para eventos do ticket do Zendesk
• Documentação do Amazon EventBridge
• Redução do código personalizado ao usar regras avançadas no Amazon EventBridge

Configuração da origem do evento do Zendesk

O processo requer a realização de algumas tarefas no Amazon EventBridge e na Central de administração.

Como configurar sua origem do evento do Zendesk

1. No Amazon EventBridge, vá até Events > Partner event sources e clique em Set up na lista de parceiro do Zendesk. A página Set up event source é exibida.
2. Na Etapa 1: copie as informações da conta da AWS, clique em Copy para copiar o número da conta da AWS para a sua área de transferência.
3. Na Central de administraçãoCentral de administração, clique em Aplicativos e integrações na barra lateral e selecione Integrações > Integrações.
4. Clique em Conectar no Conector de eventos para o Amazon EventBridge para abrir a página e configurar sua origem do evento do Zendesk.
   
5. Cole a ID da conta da AWS que você copiou na etapa 2 no campo ID da conta da Amazon Web Services.
6. No campo suspenso Região da Amazon Web Services, selecione a região da AWS que receberá os eventos.
7. Em Tipos de evento, selecione os tipos de evento que deseja enviar para o Amazon EventBridge.

   Observação: atualmente somente os eventos do tipo do Zendesk Support e do Chat estão disponíveis, no futuro mais tipos de eventos serão adicionados. Para obter mais informações sobre quais eventos estão disponíveis, consulte Eventos para o Amazon EventBridge.

8. Clique em Conectar. O nome da origem do evento pode levar alguns minutos para aparecer no Amazon EventBridge.

Associação da origem do evento do Zendesk ao barramento de eventos

Para estabelecer uma conexão de evento ao Amazon EventBridge, a origem do evento do Zendesk precisa estar associada ao barramento de eventos no Amazon EventBridge. A origem do evento do Zendesk criada pode ser vista em Amazon EventBridge > Partner events sources. Você pode selecionar o nome da origem do evento e associá-lo ao barramento de eventos.

Como associar a origem do evento do Zendesk ao barramento de eventos

1. Entre no Console de gerenciamento da AWS como usuário de IAM com permissões de administrador.
2. Em Amazon EventBridge > Events > Partner event sources, selecione o nome da origem do evento do parceiro e, no canto superior direito da página, clique em Associate with event bus.
   
3. Deixe as configurações de permissão do jeito que estão e clique em Associate. Pode levar uns dois minutos para esse processo ser concluído.

Uma vez estabelecida a conexão, os eventos do Zendesk começarão a transmitir de dados do Zendesk para o Amazon EventBridge. É possível definir regras e alvos no Amazon EventBridge para determinar quais eventos do Zendesk são redirecionados para um serviço da AWS. Para saber mais sobre a criação de regras e alvos para eventos do Zendesk, consulte o tutorial Publicação de notificações do Amazon SNS para eventos do ticket do Zendesk.

Exclusão de uma conexão de evento

Ao apagar uma conexão de evento, você precisa primeiro apagar uma regra de evento associada ao barramento de eventos no AWS EventBridge antes de apagar o barramento de eventos. Se não fizer isso primeiro, o barramento de eventos não será apagado.

Como desconectar uma conexão de evento

1. Na Central de administraçãoCentral de administração, clique em Aplicativos e integrações na barra lateral e selecione Integrações > Integrações.
2. Em Amazon Web Services, clique em Configure.
3. Desconecte a origem do evento na interface do Conector do Zendesk ao clicar em Desconectar.
   
4. Confirme para desconectar a origem do evento. Uma notificação de confirmação para a desconexão da origem do evento é exibida e os eventos param de transferir dados imediatamente. Pode levar até 20 segundos para o status da origem do evento ser registrado como desconectado no Amazon EventBridge.
5. No Amazon EventBridge, apague a regra associada ao barramento de eventos. Para obter mais informações, consulte Exclusão e desativação de uma regra do EventBridge.
6. Remova o barramento de eventos no console de eventos da AWS. Para obter mais informações, consulte a documentação do Amazon EventBridge.