Discord-Webhooks einrichten

Deine Spedition kann ihre Meldungen direkt in euren Discord schicken: abgegebene Touren, neue Mitglieder, fertige Reparaturen, Bilanzen und mehr. Dafür legst du in Discord einen Webhook an – eine Adresse, über die Dispolotse in genau einen Kanal schreiben darf – und trägst diese Adresse bei Dispolotse ein. Einen Bot brauchst du dafür nicht.

Das brauchst du#

• einen eigenen Discord-Server – oder das Recht „Webhooks verwalten“ auf einem
• einen Textkanal für die Meldungen, z. B. #touren; für jedes Thema darf es gern ein eigener sein
• deine Spedition bei Dispolotse und den Fahrer-Bereich im Browser oder die Windows-App

Am einfachsten geht es am PC: Discord in einem Fenster, Dispolotse im anderen.

Schritt 1: Kanal wählen und „Kanal bearbeiten“ öffnen#

Lege in Discord einen Textkanal an oder nimm einen vorhandenen. Fahre mit der Maus über den Kanal und klicke auf das Zahnrad „Kanal bearbeiten“.

Schritt 2: Integrationen → Webhooks → Neuer Webhook#

1. In den Kanaleinstellungen links „Integrationen“ wählen.
2. Bei „Webhooks“ auf „Neuer Webhook“ klicken.

Fehlt dir „Integrationen“ oder lässt sich der Knopf nicht klicken, fehlt dir das Recht „Webhooks verwalten“ – frag den Besitzer des Servers. Denselben Weg gibt es auch über die Servereinstellungen › Integrationen › Webhooks; dort wählst du den Kanal dann im Webhook selbst aus.

Schritt 3: Namen geben, speichern, Webhook-URL kopieren#

1. Öffne den neuen Webhook und gib ihm einen Namen, z. B. „Dispolotse“. Unter diesem Namen erscheinen die Meldungen im Kanal. Ein Avatar ist freiwillig.
2. Prüfe, dass bei „Kanal“ der richtige Kanal steht, und klicke „Änderungen speichern“.
3. Klicke „Webhook-URL kopieren“. Die Adresse liegt jetzt in deiner Zwischenablage; sie beginnt mit https://discord.com/api/webhooks/.

Schritt 4: Die Webhook-URL bei Dispolotse eintragen#

• Im Browser: Fahrer-Bereich › „Spedition führen“ › Karte „Discord-Webhooks deiner Spedition“
• In der Windows-App: „Spedition führen“ › Reiter „Firma“ › Karte „Discord“

1. Bei der Welt (ETS2 oder ATS) auf „Webhook hinzufügen“ klicken. Im Browser erscheint eine Welt erst, wenn du sie freigeschaltet hast.
2. „Name (nur für dich)“ – ein Name, an dem du den Webhook wiedererkennst, z. B. „Touren-Kanal“.
3. „Webhook-URL“ – hier die kopierte Adresse einfügen (Strg + V).
4. Unter „Was gemeldet wird“ die Ereignisse anhaken (siehe unten).
5. Unter „Was eine Nachricht zeigt“ festlegen, was in den Meldungen stehen darf, dazu die „Sprache im Kanal“.
6. „Speichern“. Danach zeigt Dispolotse die Adresse nur noch gekürzt an, etwa …/webhooks/1234…/****ab12.

In der Windows-App heißen einige Stellen etwas anders:

Was gemeldet werden kann#

Bei einem neuen Webhook sind schon angehakt: Tour abgegeben, Tanken, Neues Mitglied, Werkstattauftrag erteilt, Reparatur fertig, Fahrprüfung bestanden und Ziel erreicht. Steht hinter einem Ereignis „(folgt)“, kommt es später dazu – etwa „Werkstatt verspätet sich (folgt)“.

„Teile da, Reparatur läuft“ meldet, dass die bestellten Ersatzteile angekommen sind und die Reparatur begonnen hat – im Kanal steht dann „Reparatur läuft“.

Wann die App einen Unfall erkennt („Unfall gemeldet“), steht unter Unfälle in der Statistik.

Was eine Nachricht zeigt#

• „Geld zeigen (Erlös, Kosten)“ und „Kennzeichen zeigen“ sind aus, bis du sie einschaltest. Ohne „Geld zeigen“ steht in keiner Meldung ein Betrag.
• „Fahrzeug zeigen“, „Fahrernamen zeigen (sonst „Ein Fahrer“)“ und „Fahrzeit und Ø Tempo zeigen“ sind an.
• Nur der Inhaber hat zusätzlich „Nur für mich (interner Kanal)“: Diesen Webhook sieht und verwaltet dann nur er. Wer den Discord-Kanal lesen darf, stellst du in Discord ein.
• Fahrer können unter „Einstellungen“ › Karte „Discord deiner Spedition“ den Schalter „Nicht im Discord nennen“ setzen – im Browser und in der App. Dann stehen sie in allen Meldungen nur als „Ein Fahrer“. Mehr dazu: Discord-Status.
• Die Meldungen erwähnen niemanden: kein @everyone, keine Rollen, keine Personen.

Schritt 5: Testnachricht senden#

Klicke beim gespeicherten Webhook auf „Testnachricht senden“ – das geht nur, wenn „Webhook ist aktiv“ angehakt ist. Dispolotse antwortet: „Die Testnachricht ist unterwegs und erscheint spätestens in 5 Minuten im Kanal.“ Im Kanal steht dann: „Dispolotse ist mit diesem Kanal verbunden (ETS2).“ – bei einem ATS-Webhook mit „(ATS)“.

Eine Testnachricht geht höchstens alle 5 Minuten; bis dahin zeigt der Knopf „Test wieder ab …“.

Sicherheit: Die Webhook-URL ist wie ein Passwort#

• Poste die Webhook-URL nie öffentlich – nicht im Chat, nicht auf einem Screenshot, nicht im Stream. Wer sie hat, kann unter dem Namen des Webhooks in euren Kanal schreiben.
• Dispolotse zeigt sie nach dem Speichern nur noch gekürzt an. Zum Ändern trägst du einfach eine neue ein.
• Ist sie doch nach draußen gelangt: In Discord den Webhook löschen (Kanal bearbeiten › Integrationen › Webhooks › den Webhook öffnen › „Webhook löschen“), einen neuen anlegen, dann bei Dispolotse „Bearbeiten“ und die neue Adresse ins Feld „Neue Webhook-URL (leer lassen = bleibt wie sie ist)“ einfügen und speichern. Die alte Adresse funktioniert danach nicht mehr.
• Pause: „Webhook ist aktiv“ abhaken und speichern. Ganz weg: „Löschen“ und „Wirklich löschen?“ bestätigen.

Wenn nichts ankommt#

• Der Webhook steht auf „Abgelehnt“: Discord kennt die Adresse nicht mehr – der Webhook oder der Kanal wurde in Discord gelöscht. Dispolotse schaltet ihn dann aus, und der Inhaber bekommt eine Nachricht ins Postfach. So geht es wieder: In Discord einen neuen Webhook anlegen (Kanal bearbeiten › Integrationen › Webhooks) und „Webhook-URL kopieren“ · bei Dispolotse „Bearbeiten“ und die neue Adresse ins Feld „Neue Webhook-URL“ einfügen · prüfe, dass „Webhook ist aktiv“ angehakt ist (in der Windows-App: „Kanal eingeschaltet“), sonst bleibt der Webhook aus · „Speichern“. Meldungen aus der Zeit dazwischen sind verworfen.
• „Das ist keine Discord-Webhook-URL …“ – Eingefügt wurde etwas anderes, oft der Einladungslink des Servers. In Discord noch einmal „Webhook-URL kopieren“.
• Der Webhook ist aus oder das Ereignis nicht angehakt: Prüfe „Webhook ist aktiv“ und die Haken unter „Was gemeldet wird“.
• Falsche Welt: Eine ATS-Tour erscheint nur in einem ATS-Webhook, eine ETS2-Tour nur in einem ETS2-Webhook.
• Noch warten: Meldungen kommen gesammelt, die Testnachricht spätestens nach 5 Minuten.
• „Discord hat um eine Pause gebeten — die Nachrichten gehen etwas später hinaus.“ – Discord bremst kurz. Es geht nichts verloren, Dispolotse schickt die Nachrichten später von selbst.
• „Discord war zuletzt nicht erreichbar“ oder „hat zuletzt nicht rechtzeitig geantwortet“ – Dispolotse versucht es automatisch erneut.
• „… ältere Nachrichten wurden verworfen, weil zu viele warteten.“ – Es hatte sich zu viel angestaut, die ältesten Meldungen sind weggefallen. Die neuen kommen wieder normal.
• Die Mitglieder sehen die Meldungen nicht: Wer einen Kanal sehen darf, legst du in Discord bei den Berechtigungen des Kanals fest – Dispolotse ändert daran nichts.
• „Discord ist gerade zentral ausgeschaltet. Deine Einstellungen bleiben erhalten und gelten wieder, sobald es eingeschaltet ist.“ – Dann sendet gerade keine Spedition. Du musst nichts tun.
• Du siehst die Karte gar nicht: Dir fehlt das Recht – nur der Inhaber und wer „Steckbrief, Logo und Bild ändern“ darf, sieht sie.