Saída de webhook
Envie os resultados do workflow a qualquer URL por HTTP POST com corpo JSON, com valores nomeados e uma credencial opcional cujo segredo fica no servidor.
O nó Saída de webhook envia os resultados do seu workflow para uma URL como uma requisição HTTP POST com um corpo JSON. Use-o para entregar um vídeo, uma imagem, um arquivo de áudio ou um texto finalizado ao seu próprio backend, a um sistema de gerenciamento de conteúdo ou a um serviço de automação. Você escolhe os nomes dos valores que ele envia, e ele pode enviar uma chave salva em cada requisição sem nunca mostrar a chave no workflow.
Quando usar
- Envie a URL de um vídeo gerado a um sistema de gerenciamento de conteúdo quando o vídeo ficar pronto.
- Inicie uma automação em outro serviço quando um workflow terminar.
- Entregue os resultados à sua própria API para processamento adicional.
- Avise outro sistema que uma execução agendada ou acionada por gatilho terminou.
Início rápido
Adicionar o nó
Pressione Tab no canvas e escolha Publicar › Exportação › Saída de webhook.
Digitar o endereço
No painel de configurações, digite a URL do webhook, por exemplo https://example.com/webhook. Use um endereço https://.
Dar nome aos valores a enviar
Em Parâmetros de entrada, clique em Adicionar para cada valor, digite o nome dele, como video_url, e escolha o tipo. Cada parâmetro adiciona ao nó uma entrada com esse nome.
Conectar e executar
Conecte cada entrada ao nó que produz o valor dela e clique em Executar. O painel mostra o código de status HTTP da entrega em Última execução.
Entradas
As entradas dependem dos parâmetros que você define.
- Sem parâmetros. O nó tem uma entrada. Tudo o que está conectado a ela é enviado como um único payload.
- Um ou mais parâmetros. O nó tem uma entrada por parâmetro, com o nome dele. Cada valor é enviado com o nome do parâmetro dele.
Enviar uma vez por item
Quando uma lista chega a uma entrada por uma conexão Cada item, o nó envia uma requisição por item. Por exemplo, um Filtrar lista de artigos envia uma requisição para cada artigo. Uma segunda lista em outro parâmetro forma pares por linha: o item 3 sai com o item 3. Uma lista mais curta recomeça do primeiro item. Um item vazio não envia nada para aquele parâmetro naquela requisição.
Quando nenhuma conexão do nó trouxe nada nesta execução, o nó não envia nada e mostra Pulado · sem entrada. Por exemplo, o Filtrar lista não manteve nenhum item. Nenhuma requisição vazia chega ao seu endpoint, e a execução é concluída normalmente.
Saídas
A saída Resposta traz o que a entrega retornou, para você executar outra etapa depois dela. Em uma execução pelo editor, ela traz o corpo da resposta. Em uma execução no servidor, como uma execução por gatilho ou agendada, ela traz a palavra sent.
Configurações
| Configuração | O que faz |
|---|---|
| URL do webhook | O endereço que recebe a requisição POST. |
| Credencial | Uma chave salva, enviada como cabeçalho em cada requisição. O padrão é Nenhuma — enviar sem credencial. Veja Enviar com uma credencial. |
| Parâmetros de entrada | Os valores nomeados a enviar. Cada um tem um nome e um tipo: Texto, URL de imagem, URL de vídeo ou URL de áudio. |
| Última execução | O código de status HTTP da última entrega, ou Ainda não enviado. |
Como é a requisição
O nó envia uma requisição POST com um corpo JSON. Com dois parâmetros chamados video_url e caption, o corpo fica assim:
{
"video_url": "https://cdn.example.com/results/clip.mp4",
"caption": "Our new product, in 15 seconds."
}Os valores de mídia são as URLs dos arquivos, que o serviço que os recebe pode baixar.
Enviar com uma credencial
Muitos serviços só aceitam uma entrega com uma chave em um cabeçalho, como Authorization: Bearer .... Salve a chave uma vez como credencial e depois escolha essa credencial no nó.
Salvar a chave
Abra Integrações › Credenciais HTTP e salve uma nova credencial com um nome de cabeçalho, por exemplo Authorization, e o valor secreto dele. O link Gerenciar credenciais do painel abre a mesma página.
Escolher quem pode usá-la
A página Integrações pergunta quem pode usar a chave. Escolha Qualquer endereço ou Apenas um endereço. A diferença é explicada abaixo.
Escolher a credencial no nó
No menu Credencial do nó, escolha a credencial salva. A partir daí, cada entrega deste nó leva o cabeçalho.
O nó guarda só uma referência à credencial. O segredo é descriptografado no servidor quando a requisição é enviada e nunca mais é mostrado. Ele nunca entra no workflow, em uma exportação, em um template nem em uma predefinição. Para trocar uma chave, salve um novo valor por cima do antigo.
Qualquer endereço ou apenas um endereço
| Escolha | Onde funciona | Quando usar |
|---|---|---|
| Qualquer endereço | Só nas execuções que você mesmo inicia: uma execução a partir do editor e um agendamento que você configura no editor. | Você ainda está criando o workflow. |
| Apenas um endereço | Em todas as execuções, incluindo apps publicados, workflows compartilhados e execuções acionadas por gatilho, mas só quando o nó envia para o endereço vinculado. | O workflow é executado sem você, ou outras pessoas o executam. |
Uma credencial não vinculada é recusada em um app publicado, em um workflow compartilhado, na execução de um colaborador, em uma execução iniciada com um token de API, em um gatilho de webhook e em um agendamento criado pela API. Nesses casos, o nó falha com uma mensagem clara, em vez de enviar sem a chave.
Uma credencial vinculada fica associada a um único endereço https://. Por padrão, o vínculo vale para esse endereço exato. Ative Permitir também caminhos abaixo deste endereço para usar uma só chave em vários endereços do mesmo serviço. Quando você escolhe uma credencial vinculada a um endereço exato, a URL do webhook acompanha a credencial e não pode ser editada.
O vínculo não pode ser desfeito. Você pode mudar o endereço vinculado depois, mas não pode removê-lo.
Publicar e compartilhar exigem credenciais vinculadas
Antes de publicar um workflow como app ou de compartilhá-lo para que outras pessoas o executem, cada credencial com que ele envia precisa estar vinculada a um endereço para o qual o nó envia, incluindo as credenciais de sub-workflows. As caixas de diálogo de publicação e de compartilhamento oferecem vincular uma credencial à URL atual do nó com um clique.
O que o vínculo impõe
Em cada requisição e em cada redirecionamento:
- A URL precisa corresponder ao endereço vinculado. Caso contrário, a requisição é recusada antes de sair.
- Um redirecionamento para qualquer outro endereço não é seguido. A requisição falha, em vez de continuar sem a chave.
- Uma credencial não vinculada é removida de um redirecionamento para outro site.
- Uma credencial nunca é enviada por
http://simples.
As respostas ficam ocultas quando há uma chave anexada
Com uma credencial anexada, o corpo da resposta não é retornado, armazenado nem mostrado, só o código de status. Alguns serviços repetem os cabeçalhos da requisição na resposta, e a chave não pode voltar para o workflow.
Uma credencial que foi excluída, ou que pertence a outra conta, faz o nó falhar. O nó nunca envia uma requisição sem a chave dele.
Workflows exportados
Uma exportação de workflow ou um template nunca contém uma credencial. Quando alguém importa o workflow, o nó Saída de webhook chega sem credencial, e quem importa escolhe a sua. As credenciais são gerenciadas só no app do Nodaro.
Dicas
- Teste o endereço primeiro. Enquanto você monta o workflow, aponte o nó para um serviço de inspeção de requisições e confira o corpo antes de conectar o seu endpoint real.
- Use os nomes que o destino espera. Dê aos parâmetros exatamente os nomes que o serviço que recebe espera.
- Inicie execuções de fora. Combine a Saída de webhook com um Gatilho de webhook ou um Gatilho agendado para ter um workflow que é executado sem ninguém no editor.
- Guarde uma cópia. Conecte o mesmo resultado também ao Salvar no armazenamento.
Solução de problemas
O nó falhou depois da requisição. O endereço que recebe respondeu com um erro. O código de status aparece em Última execução, e o erro aparece no histórico de execuções.
A requisição é recusada antes de ser enviada. Confira o endereço. Uma URL que aponta para um endereço de rede privada ou local é recusada. Quando há uma credencial anexada, a URL também precisa corresponder ao endereço vinculado da credencial.
O painel avisa que a URL não é o endereço vinculado. A credencial está vinculada a outro endereço, por exemplo depois de uma importação. Clique em Usar o endereço vinculado ou escolha outra credencial.
O nó funciona quando você o executa, mas falha em um app publicado ou em uma execução acionada por gatilho. A credencial não está vinculada a um endereço. Vincule-a ao endereço do nó em Integrações e execute de novo.
Perguntas frequentes
O que a “Saída de webhook” envia?
Uma requisição HTTP POST com um corpo JSON. Com parâmetros, o nome de cada parâmetro é uma chave, e o valor do nó conectado é o valor dela, por exemplo a URL de um vídeo. Sem parâmetros, todos os dados conectados são enviados como um único payload.
Como envio uma chave de API ou um token com o webhook?
Salve a chave uma vez como credencial em “Integrações”, com um nome de cabeçalho, como Authorization, e o valor secreto dele. Depois, escolha essa credencial no menu “Credencial” do nó. O segredo fica no servidor e nunca faz parte do workflow.
Por que a minha credencial é recusada em um app publicado ou em um workflow compartilhado?
Uma credencial que não está vinculada a um endereço só funciona nas execuções que você mesmo inicia. Vincule-a ao endereço para o qual o nó envia, e ela passa a funcionar também em apps publicados, workflows compartilhados e execuções acionadas por gatilho.
Por que não consigo ver a resposta do servidor?
Quando há uma credencial anexada, o Nodaro não retorna, não armazena nem mostra a resposta, só o código de status dela, porque alguns servidores repetem na resposta os cabeçalhos da requisição, incluindo a chave.
A “Saída de webhook” custa créditos?
Não. Enviar um webhook é gratuito. Você paga só pelos nós que criaram os resultados.
Páginas relacionadas
Nós de publicação
Gatilho de webhook
Salvar no armazenamento
Automações
Webhooks
Última atualização
Salvar no armazenamento
Salve uma imagem, um vídeo ou um áudio no armazenamento do Nodaro para mantê-lo na biblioteca de mídia. O nó é gratuito, e os arquivos contam na sua cota.
Controles criativos
Os Controles criativos são nós seletores que adicionam ao prompt textos testados de luz, câmera, movimento, efeitos, música e voz, sem custar créditos.