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](/account/images/telegram-notifications-overview.png)

## 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
1. Klicke oben rechts auf deinen Namen, dann auf **Einstellungen**.
2. Wähle im Menü links **Telegram Einstellungen**.
3. 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.
4. Klicke auf **Speichern**.

![Screenshot: Feld „Telegram-Benutzername“ und der Button „Benutzernamen“](/account/images/telegram-notifications-username.png)

!!! 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
1. 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.
2. Tippe auf **Start** oder schick die Nachricht `/start`.
3. Der Bot begrüßt dich. Ab jetzt ist dein Telegram-Chat mit deinem X-Sitter-Benutzer verbunden.
4. Lade die Einstellungsseite in X-Sitter neu. Der Status wechselt auf **Mit dem Bot verbunden**.

### 3. Benachrichtigungen wählen
1. Setze unter **Benachrichtigungen** einen Haken bei jedem Ereignis, das du bekommen möchtest. Die Ereignisse sind nach Themen gruppiert (siehe Tabelle unten).
2. 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)“](/account/images/telegram-notifications-checkboxes.png)

### 4. Verbindung testen
1. Klicke neben dem Verbindungsstatus auf **Verbindung testen**.
2. Bestätige mit **Testnachricht senden**.
3. 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](/accounting/datev.md). | Geschäft |
| | **SnelStart - Fehler** | Die Übertragung von Aufträgen oder Artikeln an SnelStart ist fehlgeschlagen. Siehe [SnelStart](/accounting/snelstart.md). | 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`. |