Configure um Listener para acionar uma ação quando um evento ocorrer em um aplicativo externo. Esse exemplo mostra como criar um Task Bot com um gatilho do Listener para enviar um e-mail para uma caixa de entrada do Microsoft 365 Outlook quando um usuário criar um ticket na plataforma Zendesk.

O gatilho monitora quaisquer eventos na plataforma Zendesk. Quando o usuário cria um ticket na plataforma, o gatilho inicia o fluxo de automação subsequente para enviar um e-mail contendo os detalhes do ticket para a caixa de entrada do Microsoft 365 Outlook configurada.

Pré-requisitos

Certifique-se de cumprir os seguintes pré-requisitos:
  • Um URL de listener para a automação. Para obter mais informações sobre como criar URLs de listener, consulte Criação de URLs de listener para gatilhos da Web do Listener.
  • Privilégios de administrador para a plataforma Zendesk para criar, atualizar e excluir tickets.
  • Requisitos de gatilho do listener listados em Gatilho do Listener.
  • Uma variável de registro chamada TriggerData.
  • Conexão OAuth ativa para o Microsoft 365 Outlook.
  • Uma variável de credencial que contém o nome de usuário do Microsoft 365 Outlook.

Procedimento

  1. Execute as seguintes etapas para criar um webhook na plataforma Zendesk.
    1. Faça login no seu portal Zendesk
    2. Vá para Central de administração > Aplicativos e integrações > Webhooks e clique em Criar webhook.
    3. Insira as seguintes informações nos campos apropriados.
      1. Selecione uma forma de conectar Selecione Eventos do Zendesk e escolha Quaisquer eventos de ticket na lista suspensa de tipos de evento.
      2. Nome: Digite um nome apropriado para o webhook.
      3. URL do endpoint: Adicione o URL do listener criado na Control Room.
      4. Autenticação: Selecione a Chave de API.
      5. Nome do cabeçalho: Digite ticket-header.
      6. Valor Insira um valor apropriado para o cabeçalho.
      Para mais informações sobre como criar webhooks, consulte Creating webhooks in Zendesk.
  2. Execute as seguintes etapas para criar um Task Bot na Control Room.
    1. No painel da esquerda, clique em Automation (Automação).
    2. Clique em Criar > Task Bot.
      O assistente Criar bot de tarefa é exibido.
    3. Digite um nome apropriado para o bot no campo Nome.
      O sistema armazena todos os bots na pasta <\Bots> por padrão.
    4. Opcional: Adicione uma descrição para o bot no campo Descrição.
    5. Opcional: Clique em Escolher e siga as instruções para salvar o bot em uma pasta diferente.
    6. Clique em Criar e editar.
      O bot é criado e a opção Editar bot de tarefa é exibida.
  3. Execute as etapas a seguir para adicionar e configurar o gatilho da Web do Listener.
    1. Clique em Gatilhos > Gatilho da Web universal e clique duas vezes ou arraste Listener para adicionar o gatilho da Web à seção Gatilhos.
    2. Selecione o URL de listener gerado na lista suspensa Listener.
      O sistema preenche automaticamente o URL gerado no campo URL.
    3. Clique em Adicionar nos Cabeçalhos de autenticação para abrir o modal Cabeçalhos.
    4. Digite o nome do cabeçalho de autenticação em Nome.
    5. Selecione String insegura e insira o valor do cabeçalho em Valor.
      Como alternativa, você pode salvar o valor como uma credencial em Credential Vault e usar a opção Credencial para selecionar o valor.
    6. Clique em Adicionar para incluir o cabeçalho de autenticação.
    7. Selecione Sem validação no menu suspenso Esquema de assinatura.
    8. Selecione TriggerData na lista suspensa Resposta.
      A variável TriggerData armazena a carga útil de resposta recebida do Zendesk. Para obter mais informações sobre a carga útil de resposta dos eventos de ticket, consulte Zendesk ticket events payloads.
  4. Execute as etapas a seguir para adicionar e configurar a ação Conectar do Microsoft 365 Outlook.
    1. Clique em Ações > Microsoft 365 Outlook e, em seguida, clique duas vezes ou arraste Conectar para adicionar a ação à seção Ações.
    2. Selecione Azure Global em Azure Cloud.
      Se o seu Microsoft 365 Outlook faz parte da versão governamental do Microsoft 365, escolha Azure US GCC High.
    3. Selecione Gerenciado pela Control Room em Modo de autenticação OAuth2.
    4. Clique em Escolher e siga as instruções no modal Escolher uma conexão OAuth para escolher a conexão OAuth para o Microsoft 365 Outlook.
    5. Clique em Variável > Inserir um valor e siga as instruções para selecionar a credencial de nome de usuário do Microsoft 365 Outlook.
    6. Opcional: Insira um nome apropriado para a sessão em Criar sessão do Microsoft 365 Outlook.
      O sistema define Microsoft365OutlookSession como o nome da sessão por padrão.
  5. Execute as etapas a seguir para adicionar e configurar a ação Enviar do Microsoft 365 Outlook.
    1. Clique em Ações > Microsoft 365 Outlook e, em seguida, clique duas vezes ou arraste Enviar para adicionar a ação à seção Ações.
    2. Insira o nome da sessão que você informou ao configurar a ação Conectar.
      Se o nome padrão for mantido, o sistema preencherá automaticamente Microsoft365OutlookSession como a sessão do Microsoft 365 Outlook.
    3. Digite o ID de e-mail do Microsoft 365 Outlook para o qual os detalhes do arquivo devem ser encaminhados em Para.
    4. Insira $TriggerData{"detail.subject"}$ em Assunto.
      A chave detail.subject contém o assunto do ticket do Zendesk como seu valor.
    5. Selecione código HTML em Tipo de corpo de e-mail e insira $TriggerData{"detail.description"}$.
      A chave detail.description contém a descrição do ticket do Zendesk como seu valor.
  6. Clique em Salvar para salvar a configuração.
Ao clicar em Executar > Executar com gatilhos, o sistema ativa o gatilho e ele começa a monitorar os eventos de tickets na plataforma Zendesk. Quando um usuário cria um ticket, o gatilho inicia as ações subsequentes do Microsoft 365 Outlook. A caixa de entrada do Microsoft 365 Outlook recebe um e-mail com o assunto do ticket como assunto do e-mail e a descrição do ticket como corpo do e-mail.