# Nodaro com o Zapier

> Inicie um workflow do Nodaro em um Zap com o Webhooks by Zapier e capture a imagem ou o vídeo pronto em um segundo Zap. Sem chave de API do Nodaro.

Source: https://nodaro.ai/pt-BR/docs/guides/zapier-integration

O **Zapier** pode iniciar qualquer workflow do Nodaro a partir de um Zap e receber a imagem, o vídeo ou o áudio pronto em um segundo Zap. O Nodaro faz a geração. O Zapier decide quando a execução acontece e para onde o resultado vai depois. Nenhuma das duas direções precisa de uma chave de API do Nodaro, porque o próprio endereço de webhook do workflow inicia a execução.

## Antes de começar
As etapas desta página usam o **Webhooks by Zapier**. O Zapier classifica esse app como premium, disponível nos planos pagos e durante um teste gratuito. Confira o seu plano do Zapier antes de montar o Zap.

## Como os dois se conectam
1. No primeiro Zap, uma ação do **Webhooks by Zapier** do tipo **POST** envia um corpo JSON, por exemplo um prompt, ao endereço de webhook de um workflow do Nodaro.
2. O workflow do Nodaro começa com um [Gatilho de webhook](https://nodaro.ai/docs/nodes/automate/webhook-trigger), executa os nós dele e termina com uma [Saída de webhook](https://nodaro.ai/docs/nodes/publish/webhook-output).
3. A Saída de webhook envia o resultado por POST a um gatilho **Catch Hook**, que inicia um segundo Zap com o resultado.

Workflow: O lado do Nodaro: um Zap inicia o Gatilho de webhook, e a Saída de webhook envia o endereço da imagem a um Catch Hook do Zapier.

- Gatilho de webhook → Gerar imagem (prompt)
- Gerar imagem → Saída de webhook (image_url)

## Etapa 1: capturar o resultado no Zapier
Crie primeiro o Zap que recebe, porque o workflow do Nodaro precisa do endereço dele.

1. Crie um Zap com o gatilho **Webhooks by Zapier › Catch Hook**.
2. Clique em **Continue**. Na aba **Test**, o Zapier mostra a URL do seu webhook. Clique em **Copy**.
3. Deixe o teste aberto. Você envia o primeiro resultado para ele na etapa 2.

## Etapa 2: montar o workflow do Nodaro
1. Adicione um nó **Gatilho de webhook**. Em **Parâmetros de saída**, adicione um parâmetro chamado `prompt`, do tipo **Texto**.
2. Conecte a saída `prompt` à entrada de prompt de um nó [Gerar imagem](https://nodaro.ai/docs/nodes/image/generate-image), ou de qualquer outro nó que crie um resultado.
3. Adicione um nó **Saída de webhook**. Cole a URL do webhook do Zapier em **URL do webhook**. Em **Parâmetros de entrada**, adicione `image_url`, do tipo **URL de imagem**, e conecte a imagem a ele.
4. Salve o workflow e clique em **Executar** uma vez. O resultado chega ao Catch Hook, e no Zapier você clica em **Test trigger** para vê-lo.
5. Selecione o Gatilho de webhook e copie o endereço dele em **URL do webhook**.

O endereço tem a forma `https://app.nodaro.ai/v1/webhooks/<token>`. O token funciona como uma senha: qualquer pessoa que tenha o endereço pode iniciar o workflow.

Adicione ao segundo Zap as ações que usam o resultado e publique-o.

## Etapa 3: iniciar a execução pelo Zapier
1. No Zap que deve iniciar a execução, adicione a ação **Webhooks by Zapier › POST**.
2. Cole o endereço do Nodaro em **URL** e defina **Payload Type** como **json**.
3. Em **Data**, adicione a chave `prompt` à esquerda e mapeie o valor dela de uma etapa anterior à direita.
4. Teste a etapa e depois publique o Zap.

O Zapier envia este corpo ao Nodaro:

```json
{ "prompt": "A red kite over a green hill, morning light" }
```

## O que volta
O Nodaro responde ao POST na hora, antes de gerar qualquer coisa. A resposta é `202`, com o ID da execução:

```json
{ "executionId": "3f9e2b1a-7c6d-4e5f-8a9b-0c1d2e3f4a5b", "status": "pending" }
```

Quando a execução termina, a Saída de webhook envia o resultado por POST ao Catch Hook. O corpo tem uma chave por parâmetro de entrada, e os valores de mídia são endereços de arquivos no Nodaro:

```json
{ "image_url": "https://cdn.nodaro.ai/images/2538b658-d2e1-42ee-890a-72ce06089feb.png" }
```

O segundo Zap mapeia `image_url` como qualquer outro campo.

## Por que não consultar periodicamente com um token de API
O Zapier guarda os cabeçalhos de uma etapa de webhook em texto simples, onde qualquer pessoa com acesso ao Zap pode lê-los. Um token de API pessoal em um cabeçalho fica exposto da mesma forma. O método com a Saída de webhook não precisa de token; por isso, prefira-o no Zapier. Para consultar periodicamente pelo seu próprio código, veja [Executar um workflow com novos valores de entrada](https://nodaro.ai/docs/developers/api/workflows#run-a-workflow-with-new-input-values).

## Limites a considerar
| Limite | O que acontece | O que fazer |
| --- | --- | --- |
| Uma execução por vez em cada workflow | Uma requisição durante uma execução responde `409`, com o `executionId` da execução em andamento. | Envie a próxima requisição depois que o resultado anterior chegar, ou copie o workflow. |
| 10 requisições por minuto por endereço | As requisições a mais respondem `429`. | Espace as requisições. |
| Uma única tentativa de entrega | A Saída de webhook espera 30 segundos por uma resposta e não tenta de novo. Uma entrega com falha faz o nó falhar. | Mantenha publicado o Zap que recebe. |
| Requisições vazias | O Zapier ignora uma requisição com o corpo vazio. | Dê à Saída de webhook pelo menos um parâmetro de entrada. |

## Quanto custa
O Gatilho de webhook e a Saída de webhook não custam nada. Você paga os créditos dos nós entre eles, pelos mesmos preços do editor. No exemplo acima, cada execução custa o preço de uma imagem do Nano Banana 2, 22 créditos. Os créditos reservados para um nó que falha voltam automaticamente. O Zapier contabiliza as próprias tarefas do lado dele.

O mesmo padrão funciona no [n8n](https://nodaro.ai/docs/guides/n8n-integration) e no [Make](https://nodaro.ai/docs/guides/make-integration). [Automações](https://nodaro.ai/docs/guides/automations) trata dos agendamentos e das outras formas de iniciar um workflow.

## Perguntas frequentes

### O Nodaro funciona com o plano gratuito do Zapier?

Não com as etapas de webhook. O Zapier classifica o Webhooks by Zapier como um app premium, disponível nos planos pagos e durante um teste gratuito, e um Zap com mais de duas etapas também exige um plano pago.

### Preciso de uma chave de API do Nodaro?

Não. O Webhooks by Zapier inicia a execução pelo endereço de webhook do workflow do Nodaro, e o nó Saída de webhook envia o resultado a um Catch Hook do Zapier. O endereço do webhook é a única credencial.

### Por que o Nodaro responde 409?

O workflow do Nodaro já tem uma execução em andamento, e um workflow atende uma requisição por vez. Envie a próxima requisição depois que o resultado anterior chegar, ou faça uma cópia do workflow para execuções em paralelo.

### Quanto custa?

O Gatilho de webhook e a Saída de webhook são gratuitos. Você paga os créditos dos nós entre eles, pelos mesmos preços do editor. O Zapier contabiliza as próprias tarefas do lado dele.