Centro de suporte da Workiva

Os webhooks são mensagens automatizadas que enviam conteúdo - ou "payloads" - para um URL exclusivo. Com o evento de disparo HTTP Webhook, você pode iniciar automaticamente uma cadeia quando um URL de webhook receber uma solicitação HTTP POST com um payload JSON. Você pode usar a carga útil JSON como saída de dados com os comandos da cadeia, por exemplo, para inserir em uma planilha.

 

Requisitos

• O conector de solicitação HTTP deve ser configurado antes de você usar esse evento de acionamento.
   

Inicie a cadeia com o evento de acionamento

Quando você adiciona o evento de acionamento a uma cadeia, ele gera automaticamente o URL do webhook para receber cargas de JSON.

1. Acesse Chain Builder e selecione a cadeia com a qual você gostaria de trabalhar.
2. Procure por Trigger Event play_for_work no menu à esquerda e arraste o comando HTTP Webhook play_for_work para a posição Start na tela.
   
3. Selecione o nó HTTP Webhook e clique em Editar criar.
4. Em Informações básicas, insira um nome e uma descrição exclusivos para ajudar a identificar o evento.
   
5. Em Detalhes do evento de acionamento, selecione o conector HTTP Request e o CloudRunner para usar com o evento.

6. Insira o token de portador a ser usado para proteger o URL do webhook.

   Observação: Pense no token do portador como uma senha. Crie um token que seja difícil de adivinhar e salve-o com segurança.

7. Clique em Salvar.

Chamar o webhook com uma solicitação HTTP POST

Para que o evento de acionamento inicie a cadeia, a solicitação HTTP POST deve incluir:

• O URL do webhook
• O tipo de conteúdo; por exemplo, application/json; charset=UTF-8
• O token de portador da URL
• Um objeto JSON, mesmo que vazio ({})

Por exemplo:

curl --location --request POST 'webhookUrl' \ --header 'Authorization: Bearer bearerToken' \ --header 'Content-Type: application/json' \ --data-raw '{}'