platforma Trigger pentrun8nƐZebraByteDocumentare

The the platform Trigger Node lansează un flux de lucrun8natunci 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

credențialele platformeiAPIcu 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 înn8n, mai ales atunci cândn8nrulează în spatele unui proxy invers.

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.
platforma livrează solicitările semnate POST către URL-ul 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

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)	Refuzați livrările în afara acestei ferestre trecute sau viitoare; în mod implicit `300`. Setați la `0` numai pentru a dezactiva verificarea prospețimii.

Credentials use the same the platform API credentials Ca un nod de acțiune.

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

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`	Prezent pe `*:updated` evenimente — imaginea instantanee a entității înainte de modificare

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, și X-Probo-Webhook-Host. Nodul Trigger 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

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 care utilizează $json.data (și $json.updatedFrom pentru actualizări).
Activate the workflowNodul înregistrează automat abonamentul webhook de producție.

Build reliable event workflows

Filtrați pe eventType înainte de a accesa câmpurile specifice evenimentului sub data.
Verificați dacă există câmpuri opționale. updatedFrom este prezent numai pentru evenimentele de actualizare.
Utilizați eventId ca cheie idempotency î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 eroaren8npentru eșecurile din aval. platforma nu retrace livrările eșuate de webhook.

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 den8n
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	Deduplicați cu `eventId` și revizuiți manual sau retriptarea fluxului de lucru

Dacăn8ns-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.

Webhook overview Revizuirea plicului, a titlurilor și a comportamentului de livrare

Event types Verificați câmpurile de sarcină pentru fiecare eveniment acceptat