Tarev kann Lifecycle-Events automatisch an deine eigene Software senden — ERP, CRM, Slack, Zapier, n8n, was auch immer.
So legst du eine Subscription an
- Gehe auf /dashboard/admin/webhooks
- "+ Webhook" klicken
- URL eingeben (z.B. https://api.example.com/tarev-hook)
- Events auswählen — komma-getrennt oder
*für alle - Beim Anlegen wird ein HMAC-Secret generiert — kopier es sofort, du
brauchst es zur Signatur-Validierung beim Empfänger.
Verfügbare Events (17 Stück)
- service-ticket.{created,stage-changed,resolved}
- production-job.{created,status-changed,completed}
- sales-order.{confirmed,delivered,cancelled}
- customer-invoice.{issued,paid,overdue}
- sales-quote.{sent,accepted,rejected}
- signature-request.completed
- delivery-note.delivered
Request-Format
POST /your-url HTTP/1.1
Content-Type: application/json
X-Tarev-Event: service-ticket.stage-changed
X-Tarev-Delivery: <uuid>
X-Tarev-Signature: sha256=<hex-digest>
{"event":"service-ticket.stage-changed","timestamp":"...","tenantId":"...",...}Signatur-Validierung (Node.js Beispiel)
const crypto = require('crypto');
const sig = req.headers['x-tarev-signature']; // "sha256=abc..."
const expected = 'sha256=' + crypto.createHmac('sha256', SECRET)
.update(JSON.stringify(req.body)).digest('hex');
if (sig !== expected) return res.status(401).end();Retry-Verhalten
Bei nicht-2xx-Response retried Tarev mit Exponential-Backoff: 30s, 1m, 2m, 5m, 15m, 30m, 1h, 2h. Nach 8 Versuchen verworfen. Im Admin-UI siehst du das Delivery-Log mit Status pro Versuch.
Test-Send-Button
Im Admin-UI gibt's pro Subscription einen "Test"-Button — feuert ein test.ping Event mit Fake-Payload, damit du beim Empfänger sehen kannst ob das Setup richtig ist.