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

Source: https://nodaro.ai/pt-BR/docs/nodes/publish/webhook-output

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.

- Found in: Publish › Export
- Output: none
- API type: `webhook-output`

## 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**.

Workflow: A URL de um vídeo e uma legenda são enviadas à sua API como dois valores nomeados em um único corpo JSON.

- Gerar vídeo → Saída de webhook (video_url)
- Prompt → Saída de webhook (caption)

## 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
| 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](#send-with-a-credential). |
| **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:

```json
{
"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** (Webhook Trigger)](https://nodaro.ai/docs/nodes/automate/webhook-trigger) ou um [**Gatilho agendado** (Schedule Trigger)](https://nodaro.ai/docs/nodes/automate/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)](https://nodaro.ai/docs/nodes/publish/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.

## Frequently asked questions

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