Poller

O gatilho Poller verifica periodicamente a fonte de dados em busca de atualizações. Depois de configurá-lo, o Poller verifica periodicamente se há novos dados usando o URL de polling de uma fonte de dados. O Poller é ideal para casos de uso em que atualizações em tempo real não estão disponíveis ou quando a frequência de atualizações é baixa.

Visão geral

O Poller opera com base no conceito de polling, onde o gatilho periodicamente envia solicitações para o URL de polling em busca de novos dados. Você pode configurar o Poller para receber as notificações de eventos recebidos e iniciar a automação subsequente com base na notificação. O URL de polling do aplicativo serve como o endpoint que o gatilho consulta para novos eventos.

Você pode configurar o Poller para uma chamada GET ou uma chamada POST. Você deve adicionar o parâmetro de cabeçalho, parâmetro de consulta, detalhes de gerenciamento de contexto e filtro JSON ao configurar o Poller. A opção POST inclui uma provisão para adicionar um corpo de solicitação. Você pode usar esta opção para enviar dados para o URL de polling que requer dados adicionais para os eventos.

Configurações

As seguintes configurações estão disponíveis no gatilho Listener:

Painel de configurações de polling

Nome
Especifique um nome para o Poller
URL de polling
Especifique o URL de polling do aplicativo.
Tipo de solicitação
Selecione o tipo de solicitação de API. O Poller é compatível com os métodos GET e POST.
  • GET: você pode usar o método GET para obter os detalhes do evento.
  • POST: você pode usar o método POST para limitar os dados da resposta. O método POST possui uma opção para adicionar um corpo de requisição. Essa opção atua como um filtro para limitar os dados de resposta.
Corpo da solicitação
Insira o corpo da solicitação para o método POST. Você pode adicionar o corpo da solicitação em formatos como TXT, JSON, XML e HTML.
Intervalo de polling
Defina a frequência com que o URL será sondado em busca de novas informações. Você pode definir o intervalo em Minutos, Hora ou Dia. O limite mínimo para o intervalo é de 5 minutos.
Modo de autenticação
Especifique o modo de autenticação para o gatilho. Você pode escolher Sem autenticação ou OAuth2 – gerenciado pela Control Room.
Conexão
Use o botão Escolher para escolher uma conexão OAuth existente como o modo de autenticação. Certifique-se de que a conexão esteja configurada e ativa.
Adicionar cabeçalho
Especifique os parâmetros de cabeçalho que são aplicáveis à solicitação de sondagem. Você pode adicionar cabeçalhos de autenticação e outros parâmetros exclusivos que devem ser incluídos no cabeçalho da solicitação.
Ative a caixa de seleção Adicionar cabeçalho e clique em Adicionar cabeçalho para abrir o modal Item. Especifique o nome do parâmetro de cabeçalho e os valores no modal Item.
Adicionar parâmetro de consulta
Especifique os parâmetros de consulta que são aplicáveis à solicitação de sondagem. Marque a caixa de seleção e clique em Adicionar cabeçalho para abrir o modal Item.
Ative a caixa de seleção Adicionar parâmetro de consulta e clique em Adicionar consulta para abrir o modal Item. Especifique o nome do parâmetro de consulta e os valores no modal Item.
Gerenciamento de contexto
Defina o gerenciamento de contexto para quaisquer parâmetros dinâmicos. O gatilho usa o contexto como um ponto de verificação de sondagem para garantir que ele obtenha as informações atualizadas após o último ponto de verificação. Você pode definir o gerenciamento de contexto para URLs de sondagem, cabeçalhos e parâmetros de consulta. Defina o parâmetro como uma string e utilize essa string para definir o contexto.
Por exemplo, a API do Gmail para sondagem usa o ID de histórico de um e-mail para determinar as alterações na caixa de entrada. Ao configurar um gatilho de Poller para a caixa de entrada do Gmail, você pode definir o ID de histórico no URL de sondagem como https://gmail.googleapis.com/gmail/v1/users/me/history?startHistoryId={{historyID}} ou adicionar um parâmetro de consulta com a chave startHistoryId e o valor historyID. Você pode então configurar o contexto para o ID do histórico com o ID do último e-mail que a caixa de entrada recebeu como o ponto de verificação para a sondagem. Você também deve adicionar o nó JSON onde o ID do histórico é capturado na carga útil da resposta no campo Atualizar contexto. Isso garante que o gatilho escolha o ID do último e-mail recebido como o ID de histórico inicial toda vez que o gatilho for executado.
Ative a caixa de seleção Gerenciamento de contexto e clique em Adicionar contexto para abrir o modal Item. Especifique a chave de contexto e os valores no modal Item. Você pode selecionar uma das seguintes opções como condição para atualizar o contexto:
  • Expressão Json: selecione essa opção para definir um nó JSON da carga útil de resposta como o contexto.
  • Carimbo de data/hora atual (Unix): selecione essa opção para definir o carimbo de data e hora da época Unix do parâmetro de consulta como o contexto.
  • Carimbo de data/hora atual (ISO 8601): selecione essa opção para definir o carimbo de data/hora ISO 8601 do parâmetro de consulta como o contexto.
Filtro JSON
Especifique um filtro para os dados de resposta. Essa configuração permite filtrar os dados conforme os seus requisitos. Por exemplo, se os dados JSON contiverem registros com vários comprimentos, como 1, 5, 10, 25 e 30, você pode definir o filtro JSON como record.length>10 . Esse filtro descarta os registros com comprimento menor que 10.
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.