Integracje ViaVeg

Wysyłaj dane z transportów do swoich systemów w czasie rzeczywistym. REST API do wypełniania formularzy i ankiet, webhooki do każdego CRM-a, ERP czy arkusza.

Zapier Gotowe

Podepnij webhooka ViaVeg do 5000+ aplikacji bez kodu. Każde zdarzenie (utworzenie wysyłki, zmiana statusu, raport QC) trafia do Twojego Zapa w sekundę.

Pokaż jak skonfigurować →

Make (Integromat) Gotowe

Bardziej zaawansowane scenariusze niż Zapier, z routingiem warunkowym i transformacją payloadu. Webhooki ViaVeg działają natywnie w Make.

Pokaż jak skonfigurować →

Google Sheets Gotowe

Gotowy skrypt Google Apps Script — wklej, autoryzuj, dostajesz arkusz, który sam dopisuje wiersz dla każdej nowej wysyłki, statusu i raportu QC.

Pokaż jak skonfigurować →

n8n Gotowe

Self-hosted automatyzacja dla zespołów, które chcą trzymać dane u siebie. Webhook trigger w n8n + nasz HMAC-SHA256 podpis = pełna kontrola.

Pokaż jak skonfigurować →

Microsoft Excel Online Via Zapier / Make

Przez Zapier lub Make — webhook ViaVeg → akcja "Add row to Excel Online (Microsoft 365)". Bez własnego rejestrowania aplikacji w Azure.

Pokaż jak skonfigurować →

Salesforce / HubSpot Via Zapier / Make

Przez Zapier/Make — webhook → "Create Record / Update Record" w Salesforce. Mapowanie pól ViaVeg → obiekty SF w UI Zapa.

Pokaż jak skonfigurować →

Webhooki — fundament integracji

ViaVeg wysyła HTTP POST z JSON-em za każdym razem, gdy coś dzieje się z Twoim transportem. Podpis HMAC-SHA256 w nagłówku gwarantuje, że dane naprawdę pochodzą od nas.

Zarejestruj URL endpointa POST-em na /api/v1/webhooks (Sanctum token). W odpowiedzi dostajesz secret do weryfikacji podpisu.

Wybierz zdarzenia, które chcesz odbierać (możesz wybrać wszystkie — wildcard "*").

Twój serwer otrzymuje POST z nagłówkami X-Webhook-Event i X-Webhook-Signature. Zweryfikuj podpis i przetwórz payload.

Wspierane zdarzenia

shipment.created

shipment.status_changed

shipment.completed

phase.completed

phase_entry.submitted

qc_report.submitted

participant.assigned

Rejestracja webhooka

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"]
  }'

Przykładowy 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"
  }
}

Podpis HMAC liczony jako sha256(secret + raw_body) — wstawiany w nagłówek X-Webhook-Signature.

Google Sheets — kompletny szablon

Najszybsza droga do integracji ze swoim własnym arkuszem. Trzy kroki, ~3 minuty, zero kodowania.

Otwórz nowy arkusz Google → menu Rozszerzenia → Apps Script.

Wklej kod poniżej, zapisz, kliknij "Wdróż" → "Nowe wdrożenie" → typ "Aplikacja sieci Web", dostęp: "Każdy". Skopiuj wygenerowany URL.

Zarejestruj ten URL jako webhook ViaVeg (patrz wyżej). Każde nowe zdarzenie dopisze wiersz w arkuszu.

Skrypt do wklejenia (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);
}

Wypełnianie formularzy i ankiet przez API

API ViaVeg nie tylko czyta — pozwala też tworzyć wpisy (checklisty, raporty QC, notatki, potwierdzenia, zdjęcia) z poziomu Twojej aplikacji mobilnej, bota lub backendowego skryptu.

Endpoint publiczny (token uczestnika)

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"
  }'

Endpoint uwierzytelniony (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"
  }'

Potrzebujesz innej integracji?

Napisz na hello@viaveg.com — jeśli czegoś brakuje, zwykle dodajemy w ciągu 48h. Sprawdź też dokumentację techniczną w README projektu.