Saída de webhook

O nó Saída de webhook (Webhook Output) 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

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.

Configurações

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ó.

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

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 (Webhook Trigger) ou um Gatilho agendado (Schedule Trigger) 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 (Save to Storage).

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.