Telegram-Integration

Verbinden Sie OrderNow mit Telegram, um sofortige Benachrichtigungen über neue Bestellungen, Statusänderungen und wichtige Ereignisse direkt in Ihrer Messaging-App zu erhalten. Ideal, um Mitarbeiter zu informieren, ohne ständig das Dashboard überprüfen zu müssen.

::: note Was ist Telegram? Telegram ist eine kostenlose Messaging-App, die auf Smartphones und Computern verfügbar ist. Wenn Sie sie noch nicht haben, laden Sie sie von telegram.org oder dem App-Store Ihres Geräts herunter. :::

So funktioniert es

Die Integration verbindet Ihren OrderNow-Standort mit einem Telegram-Gruppenchat:

1. Erstellen Sie eine Telegram-Gruppe für Ihre Mitarbeiter
2. Fügen Sie den OrderNow-Bot zur Gruppe hinzu
3. Legen Sie den Gruppennamen in einem bestimmten Format fest, das Ihren API-Schlüssel enthält
4. OrderNow erkennt die Gruppe automatisch und sendet Benachrichtigungen

Voraussetzungen

• Telegram-App auf Ihrem Gerät installiert
• Ein aktiver OrderNow-Standort mit API-Zugriff
• Administratorzugriff auf Ihre OrderNow-Lizenz

Einrichtungsschritte

Schritt 1: API-Schlüssel abrufen

Sie benötigen einen API-Schlüssel, um Telegram mit Ihrem Standort zu verbinden:

1. Melden Sie sich als Administrator bei OrderNow an
2. Navigieren Sie zu Admin → API-Schlüssel
3. Suchen Sie einen vorhandenen Schlüssel oder erstellen Sie einen neuen für Ihren Standort
4. Kopieren Sie den API-Schlüssel (er sieht aus wie eine lange Zeichenfolge aus Buchstaben und Zahlen)

Beispiel API-Schlüssel:
d2a7a6a8-a52e-4a48-a2e5-4129d135a37b

WARNING

Sicherheit: Behandeln Sie API-Schlüssel wie Passwörter. Geben Sie sie nur an vertrauenswürdige Mitarbeiter weiter.

Schritt 2: Telegram-Gruppe erstellen

1. Öffnen Sie Telegram auf Ihrem Telefon oder Computer
2. Tippen Sie auf das Neue Nachricht Symbol, dann auf Neue Gruppe
3. Fügen Sie die Mitarbeiter hinzu, die Benachrichtigungen erhalten sollen
4. Geben Sie der Gruppe einen temporären Namen (Sie ändern ihn in Schritt 3)
5. Tippen Sie auf Erstellen

Schritt 3: OrderNow-Bot hinzufügen

1. Tippen Sie in Ihrer neuen Telegram-Gruppe oben auf den Gruppennamen
2. Tippen Sie auf Mitglieder hinzufügen
3. Suchen Sie nach dem Benutzernamen des OrderNow-Bots (von Ihrem Administrator bereitgestellt)
4. Wählen Sie den Bot aus und tippen Sie auf Hinzufügen
5. Der Bot wird der Gruppe beitreten

Schritt 4: Gruppentitel festlegen

Dies ist der entscheidende Schritt, der Telegram mit Ihrem Standort verbindet:

1. Tippen Sie in Telegram auf den Gruppennamen, um die Gruppeninfo zu öffnen
2. Tippen Sie auf den aktuellen Namen, um ihn zu bearbeiten
3. Geben Sie den Gruppentitel in diesem genauen Format ein:

Gruppenname|APISchlüssel

• Gruppenname: Ein beliebiger beschreibender Name (z.B. "Küchenbenachrichtigungen", "Hauptstr. Bestellungen")
• | (Pipe-Zeichen): Erforderliches Trennzeichen
• APISchlüssel: Der API-Schlüssel aus Schritt 1

Beispiele:
Hauptstr. Cafe|d2a7a6a8-a52e-4a48-a2e5-4129d135a37b
Küchenbestellungen|f1c4e2b3-a8d9-4e5f-9b6c-1e2d3f4a5b6c

TIP

Wichtig: Das Pipe-Zeichen (|) ist zwischen Name und API-Schlüssel erforderlich. Fügen Sie keine Leerzeichen darum herum ein.

Schritt 5: Überprüfung

Sobald der Gruppentitel korrekt festgelegt ist:

1. Der OrderNow-Bot sendet eine Bestätigungsnachricht in der Gruppe
2. Sie erhalten sofort Benachrichtigungen
3. Testen Sie, indem Sie eine Testbestellung in OrderNow aufgeben

Benachrichtigungstypen

OrderNow kann verschiedene Benachrichtigungen an Ihre Telegram-Gruppe senden:

Benachrichtigung	Beschreibung	Zeitpunkt
Neue Bestellung	Bestellnummer, Tisch, Artikelübersicht	Kunde gibt Bestellung auf (erreicht Status PLACED)
Fehlgeschlagene Bestellung	Bestellung konnte nicht an POS gesendet werden	Bestellung erreicht Status FAILED
Dringende Bestellung	Hochprioritätsbenachrichtigung für Sonderwünsche	Kunde fügt Notiz oder Sonderanweisung hinzu

::: note POS-Bezogene Status: OrderNow verfolgt Bestellungen nur bis zur Übergabe an Ihr POS-System. Benachrichtigungen über die Küchenzubereitung, "bereit zum Abholen" oder Lieferung werden von Ihrem POS-System verwaltet, nicht von OrderNow. :::

Benachrichtigungen verwalten

Aktivieren/Deaktivieren pro Standort

Sie können steuern, ob Benachrichtigungen gesendet werden:

1. Gehen Sie zur Bestellübersicht
2. Finden Sie Ihren Standort in der Liste
3. Verwenden Sie den Telegram-Schalter in dieser Zeile
4. Grün = Benachrichtigungen aktiviert, Grau = deaktiviert

Mehrere Gruppen

Sie können mehrere Telegram-Gruppen für verschiedene Zwecke erstellen:

• Eine Gruppe für das Küchenpersonal (alle Bestellungen)
• Eine Gruppe für Manager (nur Zusammenfassung)
• Eine Gruppe für das Barpersonal (nur Getränkebestellungen)

::: note Tipp: Verwenden Sie verschiedene API-Schlüssel für verschiedene Gruppen, um zu steuern, was jede Gruppe erhält, oder verwenden Sie denselben Schlüssel und lassen Sie die Mitarbeiter Benachrichtigungen stummschalten, die sie nicht benötigen. :::

Vollständiges Beispiel

So richten Sie Benachrichtigungen für "Café Hauptstraße" ein:

1. API-Schlüssel abrufen: d2a7a6a8-a52e-4a48-a2e5-4129d135a37b
2. Telegram-Gruppe "Cafe-Bestellungen" erstellen
3. Manager, Küchenchef und Barkeeper zur Gruppe hinzufügen
4. OrderNow-Bot zur Gruppe hinzufügen
5. Gruppennamen ändern in: Café Hauptstraße|d2a7a6a8-a52e-4a48-a2e5-4129d135a37b
6. Bestätigungsnachricht vom Bot erhalten
7. Testbestellung aufgeben, um die Funktion der Benachrichtigungen zu überprüfen

Fehlerbehebung

Problem	Lösung
Keine Benachrichtigungen erhalten	API-Schlüssel im Gruppentitel überprüfen; Bot in Gruppe prüfen; Schalter in Bestellübersicht eingeschaltet?
Bot bestätigt Einrichtung nicht	Pipe-Zeichen (|) vorhanden? Keine Leerzeichen um das Pipe-Zeichen?
Funktioniert nach Umbenennung nicht mehr	Beim Umbenennen immer den API-Schlüssel angeben; Format muss Name|APISchlüssel bleiben
Benachrichtigungen vom falschen Standort	Stellen Sie sicher, dass Sie den richtigen API-Schlüssel für Ihren Standort verwenden
Bot reagiert nicht	Entfernen und erneutes Hinzufügen des Bots zur Gruppe versuchen

Bewährte Verfahren

• Gruppenbenennung: Verwenden Sie beschreibende Namen, damit Mitarbeiter wissen, für welchen Standort die Gruppe ist
• Mitarbeiterschulung: Stellen Sie sicher, dass alle Gruppenmitglieder wissen, wie Telegram-Benachrichtigungen funktionieren
• Benachrichtigungstöne: Legen Sie markante Töne für Telegram fest, damit Mitarbeiter Bestellhinweise erkennen
• Notfallplan: Verlassen Sie sich nicht ausschließlich auf Telegram; halten Sie das OrderNow-Dashboard zugänglich
• Datenschutz: Fügen Sie nur Mitarbeiter hinzu, die Bestellinformationen benötigen; entfernen Sie ausgeschiedene Mitarbeiter umgehend

TIP

Profitipp: Heften Sie wichtige Nachrichten in der Telegram-Gruppe an (wie Tagesangebote oder Öffnungsabläufe), damit sie für Mitarbeiter immer sichtbar sind.