platforma Trigger pentru n8n
Configurați nodul platformă Trigger pentru a începe fluxurile de lucru n8n pe evenimentele webhook ale platformei, care acoperă verificarea semnăturilor, câmpurile de ieșire și rezolvarea problemelor.
The the platform Trigger Node lansează un flux de lucru n8n atunci când apare un eveniment subscris al platformei. acesta înlocuiește sondajul cu un abonament webhook gestionat ca parte a ciclului de viață al fluxului de lucru.
Requirements
Section titled “Requirements”- credențialele platformei API cu acces la organizația selectată și permisiunea de a gestiona abonamentele webhook.
- Un URL webhook de producție la care platforma poate ajunge prin HTTPS.
- Configurarea corectă a webhook-ului public în n8n, mai ales atunci când n8n rulează în spatele unui proxy invers.
How it works
Section titled “How it works”Când activați un flux de lucru care include platforma Trigger:
- Nodul creează un abonament webhook în platformă pentru organizația și evenimentele selectate.
- the platform delivers signed
POSTCautarea URL-ului webhook al nodului. - Nodul verifică semnătura HMAC-SHA256 și prospețimea timestamp-ului în mod implicit.
- Fluxul de lucru rulează cu sarcina webhook ca element de intrare.
- Când dezactivați fluxul de lucru, nodul șterge abonamentul.
Dacă organizația, evenimentele selectate sau URL-ul webhook se modifică, nodul elimină abonamentul static și creează un abonament corespunzător în timpul activării.
Configuration
Section titled “Configuration”| Field | Description |
|---|---|
| Organization ID | Organizația care emite evenimentele |
| Events | Unul sau mai multe tipuri de evenimente pentru a vă abona la |
| Verify Signature | Refuzarea livrărilor cu o semnătură HMAC lipsă sau invalidă; activată în mod implicit |
| Timestamp Tolerance (Seconds) | Refuzarea livrărilor în afara acestei ferestre trecut sau viitor; 300. Set to 0 doar pentru a dezactiva verificarea prospețimii. |
Credentials use the same the platform API credentials Ca un nod de acțiune.
Supported events
Section titled “Supported events”platforma Trigger acceptă același set de evenimente ca și abonamentele webhook, inclusiv:
- Third party created / updated / deleted
- User created / updated / deleted
- Obligation created / updated / deleted
- Rights request created / updated / deleted
- Document created / updated / archived / unarchived / deleted
- Document version created / updated / published / rejected / deleted
- Document version signature requested / signed / cancelled
- Document version approval quorum requested / updated / approved / rejected / voided
See the full wire-format payloads in Webhook Event Types.
Output
Section titled “Output”Fiecare executare a declanșatorului produce întregul corp JSON al webhook-ului – învelișul rădăcină plus câmpurile de resurse încorporate:
| Root field | Description |
|---|---|
eventId | Unique delivery identifier (good idempotency key) |
subscriptionId | Webhook subscription ID |
organizationId | Organization ID |
eventType | Event type (e.g. document:updated) |
createdAt | Event timestamp |
data | Încărcătura utilă actuală a entității (campurile de resurse trăiesc aici, nu la rădăcină) |
updatedFrom | Present on *:updated Evenimente – imaginea instantanee a entității înainte de schimbare |
platforma trimite, de asemenea, titluri HTTP, cum ar fi X-Probo-Webhook-Event, X-Probo-Webhook-Organization-Id, X-Probo-Webhook-Timestamp, X-Probo-Webhook-Signature, and X-Probo-Webhook-HostNodul de declanșare utilizează titlurile de semnătură pentru verificare; expresiile fluxului de lucru citesc de obicei câmpurile rădăcină ale corpului de mai sus. Webhooks Overview pentru referința întregului câmp header/root.
Example expressions:
{{ $json.eventType }}
{{ $json.organizationId }}
{{ $json.updatedFrom.membership.role }}
{{ $json.data.membership.role }}
Quickstart
Section titled “Quickstart”- Add the platform Trigger to a new workflow.
- Select credentials şi a stabilit Organization ID.
- Choose events, for example
Document Version Signature Signed. - Add downstream nodes that use
$json.data(and$json.updatedFromfor updates). - Activate the workflowNodul înregistrează automat abonamentul webhook de producție.
Build reliable event workflows
Section titled “Build reliable event workflows”- Filter on
eventTypebefore accessing event-specific fields underdata. - Check that optional fields exist.
updatedFromeste prezent numai pentru evenimente de actualizare. - Use
eventIdca o cheie de idempotență înainte de a crea un efect secundar extern. - Mențineți răspunsul rapid al fluxului de lucru. declanșatorul recunoaște webhook-ul înainte de executarea în aval.
- Configurați un flux de lucru de eroare n8n pentru eșecurile din aval. platforma nu retrace livrările eșuate de webhook.
Troubleshooting
Section titled “Troubleshooting”| Symptom | Check |
|---|---|
| Activation cannot create the subscription | v1:webhook domeniul de aplicare, permisiunile utilizatorului, ID-ul organizației și URL-ul webhook de producție configurat de n8n |
| the platform cannot deliver | DNS public, certificat HTTPS, proxy invers, firewall și adresa URL a punctului final al abonamentului |
Delivery returns 403 | Starea de verificare a semnăturii, ceasurile serverului și dacă abonamentul a fost recreat după o modificare |
| Workflow receives no selected event | Fluxul de lucru este activ și evenimentul aparține setului de organizare și eveniment selectat |
| Duplicate downstream action | Deduplicate with eventId și revizuirea manuală sau a retragerilor de erori ale fluxului de lucru |
Dacă n8n s-a mutat la o nouă adresă URL publică, dezactivați și reactivați fluxul de lucru, astfel încât nodul să poată înlocui vechea abonament.