Todas as integrações

Guia de integração

Instale PoYo para n8n

Automação sem código e com pouco código

Conecte a geração PoYo a formulários, agendas, webhooks, bancos de dados e outros aplicativos já em sua automação.

Antes de começar

  • Uma instância n8n que permite Community Nodes
  • Uma chave PoYo API

Três etapas para uma configuração verificada

Conclua as etapas em ordem. Cada etapa inclui o local para agir e o resultado que confirma que você pode continuar.

  1. 1

    Crie uma chave PoYo API

    Abra o painel PoYo e crie uma chave para esta credencial n8n. Mantenha a chave disponível para a etapa 3.

    Criar chave API
    Continuar quando: A nova chave fica visível uma vez e pronta para ser copiada.
  2. 2

    Instale o nó da comunidade em n8n

    Use a interface n8n. O comando npm destina-se apenas a fluxos de trabalho de implantação auto-hospedados avançados.

    Settings → Community Nodes → Install → n8n-nodes-poyo
    Continuar quando: Pesquisar PoYo ao adicionar um nó retorna os nós PoYo instalados.
  3. 3

    Crie e teste a credencial

    Crie uma credencial PoYo API, mantenha o URL base padrão, a menos que você use um gateway auto-hospedado, cole a chave API e execute o teste de credencial.

    Credentials → New credential → PoYo API → Test
    Continuar quando: n8n confirma a conexão e a credencial pode ler sua conta PoYo.

Execute seu primeiro fluxo de trabalho PoYo

Use o exemplo oficial para que a instalação e as credenciais sejam testadas antes de criar um fluxo de trabalho maior.

Escolha um exemplo de fluxo de trabalho

Comece com um pequeno fluxo de trabalho que corresponda ao comportamento que você deseja verificar.

Corra e espere

Envie um trabalho PoYo, aguarde a conclusão e passe o resultado para o próximo nó.

Webhook resultado

Retome um fluxo de trabalho n8n a partir de um retorno de chamada PoYo assinado e recupere o resultado final.

Como importar
  1. 1Baixe o arquivo JSON.
  2. 2Em n8n, escolha Import from File no menu do fluxo de trabalho.
  3. 3Selecione sua credencial PoYo, revise a entrada de amostra e execute o fluxo de trabalho.
  1. 1Importe um fluxo de trabalho de amostra oficial do repositório.
  2. 2Selecione um modelo do catálogo ativo e forneça a amostra de entrada.
  3. 3Execute o fluxo de trabalho e aguarde a conclusão do trabalho PoYo.
  4. 4Confirme se o URL de resultado ou o arquivo baixado chega ao nó final.

Primeiro sucesso: A execução termina com sucesso e o nó final contém um URL ou arquivo de resultado PoYo.

Se algo não funcionar

PoYo nós estão faltando
Confirme se Community Nodes estão habilitados para esta instância n8n e se n8n relata n8n-nodes-poyo como instalado.
O teste Credential retorna 401
Crie uma nova chave PoYo, cole-a sem espaços adjacentes e mantenha o URL API padrão https://api.poyo.ai.
Uma corrida espera muito
Inspecione o status do trabalho antes de enviar novamente. Um segundo envio pode criar outra geração paga.
Detalhes técnicos

Esses detalhes são importantes para integrações de produção, mas não são pré-requisitos para uma primeira execução bem-sucedida.

  • Credentials ficam fora dos arquivos de fluxo de trabalho exportados.
  • As tarefas mantêm os status públicos not_started, running, finished e failed.
  • As solicitações chamam os endpoints PoYo REST atuais diretamente e incluem uma tag X-PoYo-Source.