Webhooki umożliwiają automatyczne wywoływanie akcji w innych systemach na podstawie zdarzeń w systemie monitorowania pojazdów.
Na przykład możesz automatycznie wysłać klientowi e-mail, gdy jego dostawa dotrze, lub zaktualizować system rozliczeniowy po zakończeniu zlecenia.
Jak skonfigurować webhooki
Skonfigurowanie webhooka obejmuje cztery proste kroki:
Utwórz endpoint webhooka – Jest to adres internetowy (URL), na który będziemy wysyłać dane powiadomień. Musisz skonfigurować serwer lub usługę, która je odbierze i przetworzy.
Skonfiguruj webhook w systemie monitorowania – Wybierz zdarzenia, które mają uruchamiać webhook, i podaj adres URL endpointa.
Napisz kod obsługujący dane – Gdy zdarzenie wystąpi, wyślemy dane do Twojego endpointa. Twój kod musi je odebrać i wykonać odpowiednią akcję.
Przetestuj działanie – Ręcznie wywołaj zdarzenie, aby upewnić się, że webhook odbiera dane i wykonuje oczekiwane działanie.
Webhooki to potężne narzędzie do automatyzacji zadań i integracji systemu monitorowania pojazdów z innymi systemami. Dzięki niewielkiej konfiguracji możesz usprawnić przepływ pracy i zwiększyć wydajność.
Przykłady zastosowań
Oto kilka praktycznych sposobów, w jakie firmy korzystają z webhooków:
Powiadomienia klientów – Automatycznie powiadamiaj klientów, gdy pojazd dotrze na miejsce dostawy. Skonfiguruj webhook, aby uruchamiał się po osiągnięciu określonego adresu.
Automatyzacja rozliczeń – Aktualizuj konto klienta po zakończeniu dostawy. Webhook uruchamia się, gdy pojazd pozostaje w miejscu docelowym przez określony czas, co oznacza zakończenie pracy.
Alerty prędkości – Wysyłaj alerty do zespołu zarządzającego, gdy pojazdy przekraczają limity prędkości. Skonfiguruj webhook, aby uruchamiał się po przekroczeniu ustalonego progu (np. 130 km/h).
Monitorowanie tras – Powiadamiaj dyspozytorów, gdy pojazdy zbaczają z zaplanowanej trasy. Webhook uruchamia się, gdy pojazd odchyli się o więcej niż określoną odległość od przewidzianej trasy.
Jakie dane są wysyłane?
Po uruchomieniu webhooka wysyłamy informacje o pojeździe w formacie JSON, w tym:
Numer rejestracyjny i ID pojazdu
Nazwisko kierowcy
Typ zdarzenia (np. „JAZDA” lub „POSTÓJ”)
Data i godzina
Dokładna lokalizacja z adresem
Współrzędne GPS (szerokość i długość geograficzna)
Prędkość w km/h i mph
Odczyty napięcia
Stan licznika kilometrów
Przykład danych:
{"accountId":3,"vehicleRegistration":"7567453451","vehicleId":345934,"vehicleEvent":"DRIVING","driverName":"NW","dateTime":"2023-01-10 11:56:09","location":"M1, London, England, NW7 3","latitude":51.6289668131,"longitude":-0.2625989914,"speedKph":57,"speedMph":35,"geofenceName":null,"congestionZone":null,"externalVoltage":14.5,"internalVoltage":null,"odometer":72185.0}Bezpieczeństwo
Możesz dodać zabezpieczenia do wywołań webhooków, konfigurując token uwierzytelniający w systemie RAM Tracking. Przejdź do ekranu konfiguracji w menu po lewej stronie, aby go dodać.
Po dodaniu tokena dołączymy nagłówek HTTP o nazwie „Auth” z podaną wartością do każdego żądania webhook. Dzięki temu możesz zweryfikować, że żądanie faktycznie pochodzi z RAM Tracking.