Place-Busyness-Webhooks sind eine kostenpflichtige Erweiterung. Wende dich an deinen MotionTools-Account-Manager, um sie freischalten zu lassen.
Überblick
Was ist Busyness?
Busyness (Auslastung) zeigt, wie hoch der aktuelle Nachfrage-Druck auf deine Belegschaft ist. Wenn die Busyness hoch ist, sind Fahrer stark ausgelastet und können neue Aufträge möglicherweise nicht ohne Verzögerungen erfüllen. Du kannst Busyness live in der Analytics Split View beobachten.
Wie Busyness berechnet wird
MotionTools berechnet Busyness anhand des Backlog-Verhältnisses – dem Verhältnis von offenen Touren zu aktiven Fahrern in einem Geschäftsgebiet. Es wird als Zahl zwischen 0 und 100 angegeben, in 10er-Schritten:
Das Backlog-Verhältnis wird abgerundet auf den nächsten 10er-Wert: z. B. werden 12% als
10und 29% als20gemeldetEin Backlog-Verhältnis von 100% oder höher wird auf
100gedeckeltEin Webhook wird nur gesendet, wenn sich der 10er-Stufenwert ändert: bewegt sich das Backlog-Verhältnis innerhalb derselben 10er-Stufe, wird kein Webhook gesendet
Das Backlog-Verhältnis wird pro Geschäftsgebiet nach einem konfigurierbaren Zeitplan ausgewertet. Das aktuelle Backlog-Verhältnis eines Geschäftsgebiets kannst du in der Analytics Split View prüfen.
Was sind Place-Busyness-Webhooks?
Place-Busyness-Webhooks benachrichtigen dein System immer dann, wenn sich das Busyness-Level der Belegschaft für einen bestimmten Ort ändert (z. B. für einen einzelnen Store). So kannst du automatisierte Throttling-Aktionen auslösen, etwa einen Store temporär offline nehmen oder den Liefer-Radius reduzieren, wenn der Betreiber in einem Geschäftsgebiet unter hohem Nachfrage-Druck steht.
Anders als klassische eventgetriebene Webhooks werden Busyness-Webhooks nach einem wiederkehrenden Zeitplan ausgewertet und nur dann ausgeliefert, wenn das Busyness-Level eines Geschäftsgebiets eine relevante Schwelle überschreitet. Dein System wird also nur benachrichtigt, wenn sich wirklich etwas ändert.
Webhook-Payload
Jeder Webhook bezieht sich auf genau einen Ort und wird unter dem Event busyness.place_changed in der Webhook-Gruppe Busyness Signals (busyness.*) ausgeliefert.
Beispiel-Payload:
{
"id": "db76ba31-96f8-4c95-b71d-85ade5c7a640",
"timestamp": "2020-11-09T10:19:07Z",
"resource_type": "busyness",
"event": "place_changed",
"data": {
"place_id": "db76ba31-96f8-4c95-b71d-85ade5c7a640",
"service_area_id": "db76ba31-96f8-4c95-b71d-85ade5c7a640",
"customer_id": "db76ba31-96f8-4c95-b71d-85ade5c7a640",
"external_id": "string",
"busyness": 10,
"changed_at": "2020-11-09T10:19:07Z"
}
}Field | Description |
| Interne MotionTools-ID des Ortes |
| ID des Geschäftsgebietes, dem die Busyness-Änderung zugeordnet ist |
| ID des Kunden, zu dem der Ort gehört |
| Deine externe Referenz-ID für den Ort |
| Aktueller Busyness-Stufenwert (0–100 in 10er-Schritten) |
| Zeitstempel, wann sich die Stufe geändert hat. Nutze diesen, um bei Retries/Reordering veraltete Zustellungen zu verwerfen. |
Wenn ein Ort zu mehr als einem Geschäftsgebiet gehört, erhältst du einen separaten Webhook pro Geschäftsgebiet. Jeder Webhook enthält die service_area_id des Gebiets, dessen Busyness sich geändert hat.
Welche Orte Webhooks erhalten
Ein Ort muss alle folgenden Kriterien erfüllen, um berücksichtigt zu werden:
Aktiv: nicht archiviert
Kürzlich aktiv: mindestens eine Buchung in den letzten 7 Tagen
Passender Kunde: gehört zur
customer_id, die in dem Webhook-Subscription gesetzt ist
Pro Abonnement werden bis zu 5.000 Orte berücksichtigt. Wenn es mehr passende Orte gibt, werden die ältesten (nach Erstellungsdatum) priorisiert und neuere ausgeschlossen. Wird dieses Limit erreicht, wird eine Benachrichtigung an deinen konfigurierten Benachrichtigungskanal gesendet.
Auswertungsfrequenz
Busyness wird für alle relevanten Geschäftsgebiete nach einem konfigurierten Zeitplan neu ausgewertet. Standardmäßig passiert das alle 10 Minuten, mindestens jedoch alle 5 Minuten. Wende dich an deinen MotionTools-Account-Manager oder an den Support, um die Auswertungsfrequenz anzupassen.
Webhooks werden nur gesendet, wenn sich der Busyness-Stufenwert ändert – nicht bei jedem Auswertungszyklus.
Webhook-Subscription einrichten und testen
Für weitere Details lies bitte den Artikel „Place-Busyness-Webhooks einrichten und testen“.