Webhook HTTP

Set up an HTTP Webhook, as a trigger or a wait step, with its fields and the request data it outputs.

HTTP Webhook conecta um fluxo de trabalho a qualquer aplicativo que possa enviar um webhook, uma solicitação que o aplicativo envia para um endereço da Web quando algo acontece. O nó fornece esse endereço. Você cola no outro aplicativo, e cada solicitação que ele envia chega ao fluxo de trabalho.

O nó aparece em dois lugares e funciona da mesma maneira em ambos:

• Como um gatilho, na lista Alterar gatilho : cada solicitação inicia uma nova execução.
• Como uma etapa de espera, em Adicionar nó > Aguardar evento: a execução pausa no nó até que uma solicitação chegue e, em seguida, continua.

Configurar

1. Adicione o nó, como um gatilho ou como uma etapa de espera.
2. In Connection, select an HTTP Webhook connection, or create one. Connection describes its fields.
3. Copie o URL do webhook da caixa na parte superior do painel e cole-o nas configurações do webhook do outro aplicativo.
4. Opcionalmente, adicione um Filtro, para que apenas as solicitações correspondentes sejam contadas:
   1. Selecione Adicionar condição ou Adicionar grupo.
   2. Escolha Todos (AND) ou Qualquer (OR).
5. Implante o fluxo de trabalho. As solicitações só o alcançam após sua implantação.

Campos

Campo	Required	Description
URL do Webhook	—	O endereço a ser colado no outro aplicativo. Cada nó tem o seu próprio.
Conexão	Sim	A conexão HTTP Webhook que recebe as solicitações. Atualizar Esquema recarrega a forma dos dados de entrada.
Filtro	Não	Condições às quais uma solicitação deve corresponder. As solicitações que não correspondem são ignoradas.
Argumentos de entrada	Não	Apenas gatilho. Valores que outros nós leem sob $vars.<node ID>.output.

Conexão

An HTTP Webhook connection receives the requests of one app. The webhook URL is created with the connection, so the node shows it only after the connection exists. Create a connection describes how to create a connection from the node. On the Connect to HTTP Webhook page, fill in these fields:

Campo	O que inserir
Folder in which connection is stored	The folder that holds the connection.
What application is this webhook for?	A name for the app that sends the requests, such as Stripe-prod. It also becomes the connection identifier.
Tipo de Autenticação	None, or Header Based Authentication to accept only requests that carry a header and value that you choose. Set the same header in the other app.
Local do desafio	No challenge, or where the app sends its verification challenge: Header, Body, or Query parameter.

With Header Based Authentication, a request without the matching header is rejected with the HTTP status 401.

Some apps, such as Slack, WhatsApp, and Stripe, check the webhook URL before they send events. They send a challenge, a value that the URL must return. If the app does this, select where the challenge arrives in Challenge location, then fill in the fields that appear, as the webhook documentation of the app describes. WhatsApp, for example, sends the challenge in the hub.challenge query parameter, and expects it back as plain text.

Saída

The node's output is the request that the other app sent. Until the first request arrives, the node doesn't know its shape, so send one test request before you reference its fields in later nodes.

Próximas Etapas

• Gatilhos: as outras maneiras de iniciar um fluxo de trabalho.
• Atraso: pausa uma execução por um período definido.
• Implantar um fluxo de trabalho: torne o webhook ativo.
• Comunidade: faça perguntas e compartilhe fluxos de trabalho com outros construtores no Fórum da UiPath.