Telegram-Benachrichtigungen

Verbinde deinen Benutzer mit dem X-Sitter-Telegram-Bot und wähle, über welche Ereignisse du auf deinem Handy benachrichtigt werden möchtest.

X-Sitter kann dir wichtige Ereignisse über den Messenger Telegram direkt aufs Handy schicken – zum Beispiel fehlerhafte Aufträge, fehlgeschlagene Versandlabels, Fehlmengen bei der Kommissionierung oder neue Retouren. Du verbindest deinen X-Sitter-Benutzer einmal mit dem X-Sitter Bot und wählst dann, welche Benachrichtigungen du bekommen möchtest.

Screenshot: Seite „Telegram Einstellungen“ mit dem Telegram-Benutzernamen, dem Bot-Link, dem Status „Mit dem Bot verbunden“ und den Benachrichtigungsgruppen

Bevor du startest

Dein Benutzer hat das Recht für die Telegram-Einstellungen. Fehlt der Eintrag Telegram Einstellungen in deinen persönlichen Einstellungen, frag deinen Administrator.
Du hast die Telegram-App auf deinem Handy und einen Telegram-Benutzernamen (in Telegram unter Einstellungen; es ist der Name, der mit @ beginnen kann).

Schritt für Schritt

1. Telegram-Benutzernamen eingeben

Klicke oben rechts auf deinen Namen, dann auf Einstellungen.
Wähle im Menü links Telegram Einstellungen.
Gib deinen Telegram-Benutzername ein, und zwar als Username ohne führendes @ Zeichen. Du weißt nicht, wo du ihn findest? Klicke bei „So findest Du Deinen“ auf Benutzernamen, dann bekommst du eine kurze Bildanleitung.
Klicke auf Speichern.

Screenshot: Feld „Telegram-Benutzername“ und der Button „Benutzernamen“

warning Benutzername lässt sich später nicht ändern

Nach dem Speichern ist das Feld für den Benutzernamen gesperrt. Änderst du deinen Telegram-Benutzernamen später oder hast einen falschen eingegeben, wende dich an den X-Sitter-Support.

2. Bot starten

Unter dem Benutzernamen zeigt X-Sitter den Link zum Bot: Nun kannst Du diese URL auf deinem Handy öffnen: Öffne ihn auf deinem Handy – er öffnet den X-Sitter Bot in Telegram.
Tippe auf Start oder schick die Nachricht /start.
Der Bot begrüßt dich. Ab jetzt ist dein Telegram-Chat mit deinem X-Sitter-Benutzer verbunden.
Lade die Einstellungsseite in X-Sitter neu. Der Status wechselt auf Mit dem Bot verbunden.

3. Benachrichtigungen wählen

Setze unter Benachrichtigungen einen Haken bei jedem Ereignis, das du bekommen möchtest. Die Ereignisse sind nach Themen gruppiert (siehe Tabelle unten).
Klicke auf Speichern. X-Sitter bestätigt mit Alle Einstellungen wurden gespeichert.

Du siehst nur die Ereignisse, die zu Deiner Rolle und Deinen Rechten passen. Verlierst du später ein Recht, hören die passenden Benachrichtigungen automatisch auf.

Screenshot: Benachrichtigungsgruppen mit Checkboxen, z. B. „Aufträge & Marktplätze“ und „Lager (WMS)“

4. Verbindung testen

Klicke neben dem Verbindungsstatus auf Verbindung testen.
Bestätige mit Testnachricht senden.
X-Sitter schickt eine Testnachricht an alle deine verbundenen Chats und zeigt das Ergebnis an (siehe Tabelle zur Fehlerbehebung).

Bot-Befehle

Schick diese Befehle in Telegram an den X-Sitter Bot:

Befehl	Was er tut
`/start`	Verbindet deinen Chat mit deinem X-Sitter-Benutzer oder schaltet die Benachrichtigungen nach einer Pause wieder ein.
`/stop`	Pausiert alle Benachrichtigungen für diesen Chat. Deine Auswahl in X-Sitter bleibt erhalten. Schick `/start`, um weiterzumachen.
`/state`	Zeigt, ob die Benachrichtigungen aktiv sind und welche Ereignisse du abonniert hast.

Verfügbare Benachrichtigungen

Wer eine Benachrichtigung wählen kann: Alle = jeder Benutzer; Geschäft = Mandanten (Händler) und Logistiker; Lager = Logistiker und Lagerpersonal. Manche Benachrichtigungen brauchen zusätzlich das Recht für den passenden Bereich (z. B. Retouren, Packplatz, JTL).

Gruppe	Benachrichtigung	Wann du sie bekommst	Wer
Allgemein	Informationen zu neuen Funktionen	Neuigkeiten zu neuen X-Sitter-Funktionen. Immer eingeschaltet.	Alle
Aufträge & Marktplätze	Notwendiger Versand	Morgens: Marktplatz-Aufträge, die heute noch verschickt werden müssen.	Geschäft
	Tagesabschluss	Abends: neue und versendete Aufträge des Tages je Verkaufskanal.	Geschäft
	Auftrag fehlerhaft	Ein Auftrag wurde beim Import oder Abgleich als fehlerhaft markiert.	Geschäft
	Auftragsimport - Fehler	Ein CSV-/Excel-Auftragsimport ist fehlgeschlagen.	Geschäft
	JTL - Fehler	Ein Auftrag konnte nicht an JTL übertragen werden.	Geschäft
	Hood - Fehler	Ein Auftrag oder eine Versandmeldung bei Hood ist fehlgeschlagen.	Geschäft
	ManoMano - Fehler	Ein Fehler in der ManoMano-Anbindung.	Geschäft
	wooCommerce - Fehler	Ein Fehler in der wooCommerce-Anbindung.	Geschäft
	xentral - Fehler	In der Mapping-Tabelle fehlt eine Artikelnummer.	Geschäft
	weclapp - Fehler	Der Abruf von Aufträgen bei weclapp ist fehlgeschlagen.	Geschäft
	weclapp - Unbekannte Artikel	Eine Artikelnummer eines weclapp-Auftrags ist in X-Sitter unbekannt.	Geschäft
	NetSuite - Fehler	Ein Auftrag aus NetSuite ist unvollständig (z. B. Ländercode).	Geschäft
Versand	Shipcloud - Fehler	Ein Versandlabel konnte nicht über Shipcloud erstellt werden.	Lager
	Versandlabel - Fehler	Ein Versand- oder Retourenlabel ist am Packplatz fehlgeschlagen (alle Versanddienstleister).	Lager
	Versanddienstleister - Verbindungsfehler	Ein Versanddienstleister lehnt die hinterlegten Zugangsdaten ab.	Lager
	Shipcloud API Status	Der Shipcloud-Dienst ist ausgefallen oder wieder erreichbar.	Lager
Lager (WMS)	Neue Avisierung	Ein Wareneingang wurde angekündigt (manuell, per Import oder über eine Schnittstelle).	Lager
	Wareneingang eingelagert	Alle Positionen eines Avis sind eingelagert.	Alle
	Lieferschein des Kunden fehlt	Ein am Packplatz angeforderter Lieferschein (PDF) ist nach 10 Minuten noch nicht eingetroffen.	Lager
	Fehlmenge bei Kommissionierung	Ein Kommissionierer hat eine Fehlmenge gemeldet.	Alle
	Teillieferung mit Fehlmenge	Ein Auftrag wurde am Packplatz als Teillieferung abgeschlossen.	Alle
	Nachbevorratung nicht möglich	Für einen Artikel gibt es keinen passenden Quell- oder Ziel-Lagerplatz.	Lager
	MHD-Sperrbestand	Täglich: Bestand, der wegen der Mindestrestlaufzeit gesperrt ist.	Alle
	Bestandswarnung Lager	Unstimmigkeiten im Bestand, z. B. zu wenig Bestand, negative Menge, Label-Konflikt.	Lager
	Neue Retoure	Eine Retoure wurde angelegt.	Alle
	Retoure abgeschlossen	Alle Positionen einer Retoure sind geprüft.	Alle
	Workflow - Fehler	Ein Lager-Workflow konnte nicht verarbeitet werden.	Lager
Schnittstellen	JTL-FFN - Fehler	Das JTL-FFN-Token ist abgelaufen oder der Abruf von Aufträgen/Avisen ist fehlgeschlagen.	Lager
	Shopify - Fehler	Die Übertragung eines Auftrags oder die Tracking-Rückmeldung ist fehlgeschlagen, oder die App wurde deinstalliert.	Geschäft
	Shopware 6 - Fehler	Der Abruf von Aufträgen aus Shopware 6 ist fehlgeschlagen, ein Auftrag lässt sich nicht übernehmen oder ein Artikel ist unbekannt.	Geschäft
	Wix - Fehler	Der Abruf von Aufträgen oder die Statusmeldung an Wix ist fehlgeschlagen.	Geschäft
	Saleschannels - Fehler	Der Abruf von Aufträgen eines Marktplatzes oder die Versandmeldung ist fehlgeschlagen.	Geschäft
	Plenty - Fehler	Eine geprüfte Retoure oder Reklamation konnte nicht an Plenty gemeldet werden.	Geschäft
	myfactory - Fehler	Der Abruf von Aufträgen, die Versandmeldung (Shop-Status, Rechnung, Versandmail) oder die Bestandsmeldung an myfactory ist fehlgeschlagen.	Geschäft
Buchhaltung	DATEV - Fehler	DATEV hat eine Übertragung abgelehnt oder die Verbindung ist abgelaufen. Siehe DATEV.	Geschäft
	SnelStart - Fehler	Die Übertragung von Aufträgen oder Artikeln an SnelStart ist fehlgeschlagen. Siehe SnelStart.	Geschäft

Wiederholte gleiche Meldungen werden gedrosselt, damit ein wiederkehrender Fehler nicht dein Handy flutet.

Gut zu wissen / Fehlerbehebung

Meldung	Ursache	Lösung
Verbindung aktiv	Die Testnachricht wurde zugestellt. Hat sie einzelne Chats nicht erreicht, steht der Grund daneben.	–
Nicht mit dem Bot verbunden	Du hast dem Bot noch nicht `/start` geschickt oder du hast den Bot blockiert.	Öffne den Bot-Link und schick `/start`.
Keine aktive Verbindung	Es ist kein Chat verbunden, oder Telegram meldet, dass der Bot blockiert oder der Chat gelöscht wurde. Die Verbindung wurde dann abgeschaltet.	Öffne den Bot und schick `/start`, um dich wieder zu verbinden.
Bot nicht eingerichtet, oder oben auf der Seite der Hinweis „Auf diesem System ist kein Schlüssel für den X-Sitter Bot hinterlegt …“	Der X-Sitter Bot ist auf diesem System nicht eingerichtet.	Wende dich an den X-Sitter-Support.
„Telegram bremst den Bot gerade …“ / „Telegram hat gerade selbst eine Störung …“ / „Unser Server erreicht Telegram nicht …“	Vorübergehendes Problem bei Telegram oder im Netzwerk.	Führe den Test später noch einmal aus. Bleibt das Problem, wende dich an den X-Sitter-Support.
Der Telegram-Benutzername ist ungültig (5-32 Zeichen, nur Buchstaben, Ziffern und Unterstrich).	Der Benutzername entspricht nicht den Regeln von Telegram.	Gib ihn genau so ein, wie er in Telegram steht, ohne @.
Dieser Telegram-Benutzername ist bereits einem anderen Benutzer zugeordnet. Bitte wende Dich an unseren Support.	Ein anderer X-Sitter-Benutzer verwendet diesen Telegram-Benutzernamen schon.	Wende dich an den X-Sitter-Support.
Der Bot antwortet, dass dein Telegram-Benutzername nicht bekannt ist	Du hast `/start` geschickt, bevor du den Benutzernamen in X-Sitter gespeichert hast, oder der Benutzername weicht ab.	Speichere zuerst den Benutzernamen in X-Sitter und schick dann noch einmal `/start`.