Sobre o conector HTTP Webhook

Webhooks permitem que aplicativos notifiquem sistemas externos em tempo real, reduzindo a necessidade de pesquisas frequentes e minimizando chamadas de API. Em vez de verificar periodicamente atualizações, o sistema recebe retornos de chamada baseados em eventos apenas quando ocorrem alterações relevantes.

O conector UiPath HTTP Webhook permite que você dispare fluxos de trabalho diretamente de aplicativos de fornecedor. Você pode criar gatilhos instantâneos para eventos para qualquer aplicativo de terceiros que suporte notificações de webhook de saída, mesmo que não faça parte do catálogo de conectores.

Você também pode aplicar filtros de dados de evento para especificar as condições exatas sob as quais um evento de webhook deve disparar um fluxo de trabalho.

Como funciona

O gatilho HTTP Webhook gera uma URL de retorno de chamada pública dinâmica. Copie e configure este URL nas configurações de webhook do aplicativo do fornecedor somente após seu gatilho ter sido criado no Orchestrator.

Quando um evento ocorre no sistema do fornecedor:

1. O fornecedor envia a carga do evento para o URL configurado.
2. O Integration Service recebe a carga e a avalia em relação aos seus filtros de dados de evento configurados.
3. Se uma correspondência for encontrada, o Integration Service disparará a execução do fluxo de trabalho por meio do Orchestrator.

As cargas de trabalho do Webhook são processadas da mesma forma que quaisquer outros eventos de gatilhos.

For more information, refer to Using the Webhook connector.

For information on how to create a connection and configure challenge verification, if required by the vendor, refer to HTTP Webhook authentication.

Limites de taxa

Os eventos disparados pelo Webhook estão sujeitos aos seguintes limites:

• 500 eventos por minuto por tenant
• 100 eventos por minuto por conexão

Limitações

• A depuração do gatilho do tempo de design não está disponível no momento.
• Apenas solicitações no formato JSON são compatíveis.

Perguntas frequentes

Colei o URL do Webhook na interface gráfica do provedor. Por que a verificação ainda não está sendo aprovada?

A verificação só será bem-sucedida depois que o gatilho for criado no Orchestrator e desde que você tenha configurado o desafio corretamente. Observe que a UiPath não realiza nenhuma verificação de desafio de nosso lado — a validação acontece totalmente no lado do provedor, para estabelecer confiança com o destino.

Configurei o desafio incorretamente. Por que minha conexão ainda está sendo criada com sucesso?

No momento, a UiPath não valida a etapa de desafio/verificação do provedor. Essa validação é tratada inteiramente pelo fornecedor. Como resultado, a conexão no UiPath pode aparecer ativa mesmo se a verificação de desafio do provedor tiver realmente falhado do seu lado.

Como uso a resposta de um webhook criado no Orchestrator?

Use a atividade Get Trigger Event Output em seu fluxo de trabalho e transmita UiPathEventObjectId (data type=Text) como o argumento de entrada. Essa atividade retornará o corpo e os cabeçalhos recebidos do webhook.

A resposta do webhook é uma string JSON. Como uso partes dele no meu fluxo de trabalho?

Use a atividade Deserialize JSON para converter a string em um JObject, após o qual você pode acessar facilmente campos individuais.