Ein Bot für das Portal des Paketdienstes, der Reklamationen einreicht und verfolgt

Geht ein Paket verloren oder kommt beschädigt an, eröffnet der 3PL eine Nachforschung beim Paketdienst. Bei einem Paketdienst-Partner heißt das: ein Ticket in einem Freshdesk-Kundenportal. Paketdienst wählen, Reklamationsgrund wählen, Verkaufsrechnung anhängen und eine Erklärung über den Nichterhalt ausfüllen. Für nichts davon gibt es eine API.

Die Nachverfolgung kostete noch mehr Zeit. Jede offene Nachforschung musste auf neue Antworten geprüft werden, und Antworten mussten mit Anhängen zurückgeschrieben werden. Die Nachforschungsplattform des 3PL brauchte diese Daten automatisch, aber der einzige Zugang war dasselbe Webportal, das auch ein Mensch nutzt.

Eine erste Browser-Version funktionierte, war aber langsam und schwer. Jede Prüfung startete Firefox, und neun offene Nachforschungen im 15-Minuten-Takt bedeuteten etwa 960 Browserstarts am Tag. Die meisten lasen Tickets, die sich gar nicht geändert hatten.

Der Bot ist ein Python-FastAPI-Dienst, der das Portal mit Playwright über Camoufox steuert, einen gehärteten Firefox-Build. Er füllt das Reklamationsformular aus, einschließlich der Choices.js-Dropdowns für Paketdienst und Reklamationsgrund, lädt Dateien hoch und gibt die neue Ticket-ID zurück. Leitet das Portal statt zum neuen Ticket zur Ticketliste weiter, findet der Bot das Ticket über den Betreff.

Sitzungs-Cookies werden nach dem Login gespeichert und wiederverwendet, sodass die meisten Anfragen den Login überspringen. Eine abgelaufene Sitzung erkennt der Bot an der Weiterleitung zur Login-Seite und repariert sie mit einem neuen Login. Eine globale Sperre erlaubt nur einen Browser gleichzeitig, weil parallele Sitzungen das Single Sign-on des Portals überlastet haben.

Lesevorgänge nehmen einen schnelleren Weg. Das Portal liefert Tickets als einfaches HTML aus. Die Ticketliste und ein Änderungs-Fingerprint (Status, Anzahl der Kommentare, Zeit des neuesten Kommentars) werden daher mit den gespeicherten Cookies über HTTP in etwa einer halben Sekunde abgerufen statt in 20 bis 30 Sekunden. Der Browser startet nur, wenn sich etwas geändert hat. Das Docker-Image installiert nur die Bibliotheken, die Firefox braucht, nicht das komplette Browser-Paket von Playwright mit etwa 2 GB.