Nodaro com o Zapier

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, executa os nós dele e termina com uma Saída de webhook.
3. A Saída de webhook envia o resultado por POST a um gatilho Catch Hook, que inicia um segundo Zap com o resultado.

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, 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:

{ "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:

{ "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:

{ "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.

Limites a considerar

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 e no Make. Automações trata dos agendamentos e das outras formas de iniciar um workflow.