ViaVeg Integrationen
Senden Sie Transportdaten in Echtzeit an Ihre Systeme. REST API für Formulare und Umfragen, Webhooks für jedes CRM, ERP oder Tabellenblatt.
Zapier Bereit
Verbinden Sie einen ViaVeg-Webhook mit über 5000 Apps ohne Code. Jedes Ereignis (Sendung erstellt, Statusänderung, QC-Bericht) trifft Ihren Zap in Sekunden.
Einrichtung anzeigen →Make (Integromat) Bereit
Fortgeschrittenere Szenarien als Zapier, mit bedingtem Routing und Payload-Transformation. ViaVeg-Webhooks funktionieren nativ in Make.
Einrichtung anzeigen →Google Sheets Bereit
Fertiges Google Apps Script — einfügen, autorisieren, und Sie haben ein Sheet, das für jede neue Sendung, jeden Status und jeden QC-Bericht eine Zeile anfügt.
Einrichtung anzeigen →n8n Bereit
Self-hosted Automatisierung für Teams, die ihre Daten intern halten möchten. Webhook-Trigger in n8n + unsere HMAC-SHA256-Signatur = volle Kontrolle.
Einrichtung anzeigen →Microsoft Excel Online Über Zapier / Make
Über Zapier oder Make — ViaVeg-Webhook → Aktion "Add row to Excel Online (Microsoft 365)". Keine eigene Azure-App-Registrierung nötig.
Einrichtung anzeigen →Salesforce / HubSpot Über Zapier / Make
Über Zapier/Make — Webhook → "Create Record / Update Record" in Salesforce. ViaVeg-Felder auf SF-Objekte in der Zap-UI mappen.
Einrichtung anzeigen →Webhooks — das Fundament der Integration
ViaVeg sendet einen HTTP POST mit JSON, sobald etwas mit Ihrer Sendung passiert. Die HMAC-SHA256-Signatur im Header garantiert, dass die Daten wirklich von uns stammen.
Registrieren Sie eine Endpoint-URL per POST an /api/v1/webhooks (Sanctum-Token). Die Antwort enthält ein Secret zur Signaturprüfung.
Wählen Sie die Ereignisse, die Sie empfangen möchten (oder wählen Sie alle — Wildcard "*").
Ihr Server empfängt einen POST mit den Headern X-Webhook-Event und X-Webhook-Signature. Signatur prüfen und Payload verarbeiten.
Unterstützte Ereignisse
Webhook registrieren
curl -X POST https://viaveg.com/api/v1/webhooks \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"url": "https://hooks.zapier.com/hooks/catch/...",
"events": ["shipment.created", "shipment.completed", "phase_entry.submitted"]
}'Beispiel-Payload
{
"event": "phase_entry.submitted",
"timestamp": "2026-05-22T10:15:30+00:00",
"data": {
"shipment_id": 1234,
"uuid": "ship_abc...",
"phase": "unloading",
"entry_type": "qc_report",
"data": { "temperature": -2.4, "rejected_kg": 14.3 },
"filled_by": "Anna Nowak",
"gps": { "lat": 52.2297, "lng": 21.0122 },
"submitted_at": "2026-05-22T10:15:30+00:00"
}
}HMAC-Signatur wird als sha256(secret + raw_body) berechnet — gesendet im Header X-Webhook-Signature.
Google Sheets — vollständige Vorlage
Der schnellste Weg zur Integration mit Ihrer eigenen Tabelle. Drei Schritte, ~3 Minuten, kein Code.
Öffnen Sie ein neues Google Sheet → Menü Erweiterungen → Apps Script.
Fügen Sie den Code unten ein, speichern Sie, klicken Sie "Bereitstellen" → "Neue Bereitstellung" → Typ "Webanwendung", Zugriff: "Jeder". Kopieren Sie die generierte URL.
Registrieren Sie diese URL als ViaVeg-Webhook (siehe oben). Jedes neue Ereignis fügt eine Zeile im Sheet hinzu.
Script zum Einfügen (Google Apps Script)
// ViaVeg → Google Sheets append-row receiver.
// Paste into Apps Script (Extensions → Apps Script) inside your Sheet,
// then Deploy → New deployment → Web app → "Anyone" → copy the URL into ViaVeg.
const SHEET_NAME = 'ViaVeg'; // tab name; auto-created if missing.
function doPost(e) {
const payload = JSON.parse(e.postData.contents);
const event = payload.event || 'unknown';
const data = payload.data || {};
const ss = SpreadsheetApp.getActiveSpreadsheet();
let sheet = ss.getSheetByName(SHEET_NAME);
if (!sheet) {
sheet = ss.insertSheet(SHEET_NAME);
sheet.appendRow(['Timestamp', 'Event', 'Shipment UUID', 'Cargo', 'Phase', 'Filled by', 'Data (JSON)']);
}
sheet.appendRow([
new Date(),
event,
data.uuid || '',
data.cargo_type || data.cargo_name || '',
data.phase || '',
data.filled_by || '',
JSON.stringify(data),
]);
return ContentService.createTextOutput(JSON.stringify({ok: true}))
.setMimeType(ContentService.MimeType.JSON);
}Formulare und Umfragen über API ausfüllen
Die ViaVeg API liest nicht nur — sie erlaubt auch das Erstellen von Einträgen (Checklisten, QC-Berichte, Notizen, Bestätigungen, Fotos) aus Ihrer Mobile App, Ihrem Bot oder Backend-Skript.
Öffentlicher Endpoint (Teilnehmer-Token)
curl -X POST https://viaveg.com/api/v1/participants/PARTICIPANT_TOKEN/entries \
-H "Content-Type: application/json" \
-d '{
"type": "checklist",
"data_json": { "temp_at_load": -2.0, "seal_ok": true, "pallets": 24 },
"gps_lat": 52.2297,
"gps_lng": 21.0122,
"status": "completed"
}'Authentifizierter Endpoint (Sanctum)
curl -X POST https://viaveg.com/api/v1/phases/PHASE_ID/entries \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"type": "qc_report",
"data_json": { "overall_score": 9, "defects": [] },
"status": "completed"
}'Brauchen Sie eine andere Integration?
Schreiben Sie an hello@viaveg.com — wenn etwas fehlt, ergänzen wir es normalerweise innerhalb von 48h. Siehe auch die technische Doku im Projekt-README.