Gatilho do Listener
- Última atualização2026/01/13
Gatilho do Listener
O gatilho Listener monitora eventos no aplicativo externo e aciona a automação em tempo real. Este gatilho requer um URL de listener que funcione como o endpoint para o qual o aplicativo externo envia os detalhes do evento do webhook.
Visão geral
O gatilho Listener permite que você crie gatilhos para aplicativos compatíveis com webhooks. Você pode configurar o gatilho Listener para receber as notificações de eventos recebidos e iniciar a automação subsequente com base na notificação. Você deve criar um URL de listener para o gatilho Listener, que atua como o endpoint para receber a notificação. A plataforma fixa esse URL e você não pode editá-lo após a criação. Crie o URL de listener na página Gatilhos de evento.
O gatilho Listener oferece opções para adicionar cabeçalhos de autenticação e esquemas de assinatura com base no aplicativo para o qual você está configurando o gatilho. Você deve definir o cabeçalho de autenticação nas configurações do webhook do aplicativo e adicionar os mesmos cabeçalhos em Cabeçalhos de autenticação. Você também pode definir um esquema de segurança para validar a carga recebida. Defina o cabeçalho X-Signature com a chave no lado do aplicativo e adicione o mesmo parâmetro e chave no campo Esquema de assinatura. Atualmente, o gatilho Listener é compatível apenas com assinatura HMA-SHA256.
Configurações
As seguintes configurações estão disponíveis no gatilho Listener:
- Listener
- Escolha um URL de listener apropriado para o gatilho na lista suspensa. Gatilho Listener. Você pode usar o botão Atualizar para atualizar a lista suspensa. Para obter mais informações sobre como criar URLs de listener, consulte Criação de URLs de listener para gatilhos da Web do Listener.
- Cabeçalhos de autenticação
- Insira os cabeçalhos de autenticação que você definiu no lado do aplicativo. Os cabeçalhos de autenticação garantem que os webhooks sejam seguros. Os cabeçalhos usam o formato nome-valor. Certifique-se de inserir o nome e os valores exatos que você configurou nas configurações do aplicativo. Esse campo é opcional.
- Esquema de assinatura
- Selecione um esquema de assinatura apropriado para validar os dados recebidos. O esquema de assinatura verifica a origem e a integridade dos dados, fornecendo uma camada adicional de segurança. O esquema de assinatura consiste em um identificador de chave e um nome de cabeçalho.
- Chave secreta
- Digite a chave secreta usada para identificar a assinatura. Use a opção Credencial para escolher uma chave que esteja disponível no Credential Vault. Como alternativa, insira a chave diretamente na opção String insegura.
- Nome do cabeçalho de assinatura
- Digite o nome do cabeçalho para a chave secreta.
- Resposta
- Selecione uma variável de registro para salvar os dados de resposta do gatilho. A automação salva os dados de resposta do gatilho em um formato de par chave-valor. Após executar o bot, acesse a página Log de auditoria e selecione o evento Execução de bot por gatilho para visualizar os dados de resposta. Consulte a documentação da API do aplicativo externo para obter a carga útil dos dados de resposta.