Integratiegids

PoYo installeren voor n8n

No-code- en low-code-automatisering

Koppel PoYo-generatie aan formulieren, schema's, webhooks, databases en de andere apps die al in je automatisering zitten.

Voordat je begint

Voer de stappen in volgorde uit. Elke stap vermeldt waar je moet handelen en welk resultaat bevestigt dat je verder kunt.

1
Maak een PoYo API-sleutel aan
Open het PoYo-dashboard en maak een sleutel aan voor deze n8n-credential. Houd de sleutel bij de hand voor stap 3.
API-sleutel aanmaken
Ga verder wanneer: De nieuwe sleutel is eenmalig zichtbaar en klaar om te kopiëren.
2
Installeer de community node in n8n
Gebruik de n8n-interface. De npm-opdracht is alleen bedoeld voor geavanceerde workflows met zelf gehoste implementaties.
Settings → Community Nodes → Install → n8n-nodes-poyo
Ga verder wanneer: Als je bij het toevoegen van een node naar PoYo zoekt, verschijnen de geïnstalleerde PoYo-nodes.
3
Maak de credential aan en test hem
Maak een PoYo API-credential aan, laat de standaard Base URL staan tenzij je een zelf gehoste gateway gebruikt, plak de API-sleutel en voer de credentialtest uit.
Credentials → New credential → PoYo API → Test
Ga verder wanneer: n8n bevestigt de verbinding en de credential kan je PoYo-account lezen.

Gebruik het officiële voorbeeld, zodat de installatie en de inloggegevens zijn getest voordat je een grotere workflow bouwt.

Begin met één kleine workflow die past bij het gedrag dat je wilt controleren.

Dien een PoYo-job in, wacht tot die klaar is en geef het resultaat door aan de volgende node.

Hervat een n8n-workflow vanuit een ondertekende PoYo-callback en haal het eindresultaat op.

Zo importeer je

1Download het JSON-bestand.
2Kies in n8n in het workflowmenu Import from File.
3Selecteer je PoYo-credential, bekijk de voorbeeldinvoer en voer de workflow uit.

1Importeer een officiële voorbeeldworkflow uit de repository.
2Kies een model uit de actuele catalogus en geef de voorbeeldinvoer op.
3Voer de workflow uit en wacht tot de PoYo-job klaar is.
4Controleer of de resultaat-URL of het gedownloade bestand de laatste node bereikt.

Eerste succes: De uitvoering wordt succesvol afgerond en de laatste node bevat een PoYo-resultaat-URL of -bestand.

PoYo-nodes ontbreken: Controleer of Community Nodes zijn ingeschakeld voor deze n8n-instantie en of n8n meldt dat n8n-nodes-poyo is geïnstalleerd.
Credentialtest geeft 401 terug: Maak een nieuwe PoYo-sleutel aan, plak hem zonder spaties eromheen en laat de standaard-API-URL https://api.poyo.ai staan.
Een uitvoering wacht te lang: Controleer de jobstatus voordat je opnieuw indient. Een tweede inzending kan een nieuwe betaalde generatie veroorzaken.

Technische details

Deze details zijn belangrijk voor integraties in productie, maar zijn geen voorwaarde voor de eerste geslaagde uitvoering.

Inloggegevens blijven buiten geëxporteerde workflowbestanden.
Taken behouden de publieke statussen not_started, running, finished en failed.
Verzoeken roepen de actuele REST-endpoints van PoYo rechtstreeks aan en bevatten een X-PoYo-Source-tag.