Enviar webhook
Enviar uma requisição webhook para outro sistema.
O que faz
Envie uma requisição HTTP POST para uma URL de webhook, com os cabeçalhos de webhook adicionados automaticamente. Se quiser, assine os dados enviados com HMAC-SHA256 para uma entrega segura.
Quando usar: Use quando o seu fluxo precisar enviar uma requisição webhook para outro sistema.
Exemplo de situação: Processar os dados antes de seguir para a próxima etapa.
Antes de começar
Conexão necessária: Credencial protegida.
Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.
Passo a passo
- Adicione Enviar webhook ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
- Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.
- Revise a ação principal descrita no cartão do bloco.
- Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
- Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
- Só publique depois de conferir o resultado da execução de teste.
Campos
URL do webhook
ObrigatórioInforma o endereço HTTPS do serviço ou recurso que será acessado.
- Exemplo:
- https://api.exemplo.com/v1/recurso
Payload
Informa o conteúdo enviado no corpo da requisição.
- Exemplo:
- Olá! Sua solicitação foi processada com sucesso.
Segredo de assinatura
Dado protegidoOpcional: segredo para a assinatura HMAC.
- Padrão:
- Segredo protegido
Cabeçalhos
Cabeçalhos personalizados opcionais para a requisição.
Saídas
Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <enviarwebhook.data>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
| Referência | Tipo | O que contém |
|---|---|---|
<enviarwebhook.data> | json | Dados da resposta do endpoint do webhook. |
<enviarwebhook.status> | number | Código de status HTTP. |
<enviarwebhook.headers> | json | Cabeçalhos da resposta. |
Exemplo de uso
Objetivo: Processar os dados antes de seguir para a próxima etapa.
- URL do webhook
- https://api.exemplo.com/v1/recurso
- Payload
- Olá! Sua solicitação foi processada com sucesso.
Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.
Erros comuns e como resolver
- O bloco não executa
- Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
- Aparece “Validação do fluxo” no terminal
- Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
- Um campo chega vazio na etapa seguinte
- Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <enviarwebhook.data>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
- Credencial ausente ou recusada
- Escolha uma conexão válida do workspace. Se a senha ou a chave mudou no serviço, atualize a conexão cadastrada em vez de colar o segredo no bloco.
Blocos relacionados
- AgendamentoIniciar a execução automaticamente nos dias e horários programados.
- Aguardar uma pessoaPausar a execução e aguardar uma decisão ou informação fornecida por uma pessoa.
- AnotaçãoAdicionar uma anotação visual ao desenho do fluxo sem executar uma ação.
- APIExpor um endpoint HTTP legado para iniciar o fluxo; em fluxos novos, prefira o bloco Início.
- AvaliadorAvaliar um conteúdo com critérios definidos e devolver uma nota ou conclusão.
- Base de conhecimentoPesquisar semanticamente nas bases de conhecimento disponíveis.