Executar e aguardar
Submete uma tarefa do PoYo, aguarda pela conclusão e passa o resultado ao nó seguinte.
Todas as integrações
Guia de integração
Instalar o PoYo no n8n
Automatização sem código e com pouco código
Liga a geração do PoYo a formulários, agendamentos, webhooks, bases de dados e às outras aplicações que já fazem parte da tua automatização.
Antes de começares
- Uma instância do n8n que permita Community Nodes
- Uma chave de API do PoYo
Três passos para uma configuração verificada
Conclui os passos por ordem. Cada passo indica onde agir e o resultado que confirma que podes continuar.
- 1
Cria uma chave de API do PoYo
Abre o dashboard do PoYo e cria uma chave para esta credencial do n8n. Mantém a chave à mão para o passo 3.
Criar chave de APIContinua quando: A nova chave fica visível uma única vez e pronta para copiar. - 2
Instala o nó da comunidade no n8n
Usa a interface do n8n. O comando npm só serve para workflows avançados de implementação alojada por ti.
Settings → Community Nodes → Install → n8n-nodes-poyoContinua quando: Ao pesquisares PoYo enquanto adicionas um nó, aparecem os nós do PoYo instalados. - 3
Cria e testa a credencial
Cria uma credencial PoYo API, mantém o Base URL predefinido, a não ser que uses um gateway alojado por ti, cola a chave de API e executa o teste da credencial.
Credentials → New credential → PoYo API → TestContinua quando: O n8n confirma a ligação e a credencial consegue ler a tua conta PoYo.
Executa o teu primeiro workflow do PoYo
Usa o exemplo oficial para testares a instalação e as credenciais antes de construíres um workflow maior.
Escolhe um workflow de exemplo
Começa com um pequeno workflow que corresponda ao comportamento que queres verificar.
Resultado por webhook
Retoma um workflow do n8n a partir de um callback assinado do PoYo e obtém o resultado final.
Como importar
- 1Transfere o ficheiro JSON.
- 2No n8n, escolhe Import from File no menu do workflow.
- 3Seleciona a tua credencial do PoYo, revê a entrada de exemplo e executa o workflow.
- 1Importa um workflow de exemplo oficial do repositório.
- 2Seleciona um modelo do catálogo em direto e indica a entrada de exemplo.
- 3Executa o workflow e aguarda que a tarefa do PoYo termine.
- 4Confirma que o URL do resultado ou o ficheiro transferido chega ao nó final.
Primeiro sucesso: A execução termina com sucesso e o nó final contém um URL de resultado ou um ficheiro do PoYo.
Se algo não funcionar
- Os nós do PoYo não aparecem
- Confirma que os Community Nodes estão ativados nesta instância do n8n e que o n8n indica o n8n-nodes-poyo como instalado.
- O teste da credencial devolve 401
- Cria uma nova chave do PoYo, cola-a sem espaços à volta e mantém o URL da API predefinido, https://api.poyo.ai.
- Uma execução demora demasiado
- Verifica o estado da tarefa antes de submeteres novamente. Uma segunda submissão pode criar outra geração paga.
Detalhes técnicos
Estes detalhes são importantes nas integrações em produção, mas não são pré-requisitos para a primeira execução com sucesso.
- As credenciais ficam fora dos ficheiros de workflow exportados.
- As tarefas mantêm os estados públicos not_started, running, finished e failed.
- Os pedidos chamam diretamente os endpoints REST atuais do PoYo e incluem uma etiqueta X-PoYo-Source.