Dokumentation
Technische Dokumentation zur Anbindung und Konfiguration von AI Waiter.
Schnellstart — beliebige Website (manuelles Skript)
Die Anbindung von AI Waiter an eine beliebige Website erfolgt in zwei Schritten:
- Kopieren Sie Ihren Widget-Schlüssel und Einbettungscode aus Website-Anbindung in Ihrem Panel.
- Fügen Sie den Code vor dem schließenden
</body>-Tag Ihrer Website ein:
<script defer src="https://waiter24.ai/widget.js" data-key="IHR_SCHLUESSEL"></script>
Das ist alles — Aussehen, Texte, Sprachverhalten und Funktionen des Widgets werden im Panel verwaltet, ohne Codeänderungen. Es funktioniert mit jeder Website, auch mit SPAs (React, Vue, Next.js) und Website-Baukästen. Aktualisieren Sie nach Einstellungsänderungen Ihre Website-Seite.
Empfohlene Einrichtungsreihenfolge
- Speisekarte — laden Sie Ihre Gerichte. Wenn Sie einen Online-Shop betreiben, synchronisiert das native Plugin sie automatisch; andernfalls aus Foto/PDF importieren, JSON hochladen oder von Hand hinzufügen. Siehe Ihre Speisekarte in AI Waiter laden. Die KI empfiehlt nur, was auf Ihrer Speisekarte steht.
- Chat-Test — sprechen Sie mit Ihrem Assistenten im Panel, bevor Sie live gehen.
- Website-Anbindung — betten Sie den Code ein (oder verbinden Sie Ihr Shop-Plugin) und richten Sie den Assistenten auf Ihre Website aus.
- Widget-Einstellungen — wählen Sie den Widget-Modus (Restaurant-Assistent oder Support-Desk) und passen Sie Texte, Sprache und Funktionen an.
- Über das Lokal — Adresse, Telefon, Öffnungszeiten je Wochentag und Hausregeln (Parkplatz, WLAN, Zahlung, Reservierungen, Haustiere). Der Assistent beantwortet Fragen zum Lokal ausschließlich aus diesen Angaben.
- Optional Telegram- und WhatsApp-Bots verbinden, Lieferzonen, Treueprogramm, Reservierungen und weitere Funktionen aus der Seitenleiste konfigurieren.
Ihre Speisekarte in AI Waiter laden
Der Assistent empfiehlt nur Gerichte, die auf Ihrer Speisekarte stehen — sie zu laden ist also das Erste. Wählen Sie den Weg, der dazu passt, in welcher Form Ihre Speisekarte bereits vorliegt — Sie können sie kombinieren und jederzeit erneut importieren.
- Natives Shop-Plugin — der einfachste Weg. Wenn Sie einen Online-Shop mit WooCommerce, Shopify, Magento 2 oder Shopware betreiben, installieren Sie unser Plugin/App dafür. Es überträgt Ihren gesamten Produktkatalog an AI Waiter und hält ihn danach automatisch synchron nach Zeitplan — neue Gerichte, Preisänderungen und ausverkaufte Artikel fließen ohne manuellen Re-Import ein. Dasselbe Plugin bettet auch das Chat-Widget für Sie ein. Siehe E-Commerce-Integrationen unten.
- Foto oder PDF Ihrer Speisekarte. Wählen Sie auf der Seite Speisekarte die Option Aus Foto/PDF importieren und laden Sie ein Bild oder PDF Ihrer Papierkarte hoch — die KI liest es und erstellt die Kategorien und Gerichte für Sie. Ideal, wenn Sie keinen Online-Katalog haben.
- JSON-Datei. Wählen Sie JSON → Importieren, um eine Speisekarten-Datei hochzuladen (laden Sie zuerst die Vorlage herunter, um das Format zu sehen), oder Exportieren, um Ihre Speisekarte zu sichern. Praktisch für einen Massen-Upload oder das Verschieben einer Karte zwischen Konten.
- Von Hand. Fügen Sie Kategorien, Unterkategorien und Gerichte direkt im Speisekarten-Editor hinzu — mit Preisen, Varianten, Fotos, Gewicht, Tags und Allergen-/Nährwertangaben.
- Größen, die als reine Zahlen importiert werden. Shops benennen Pizzagrößen oft „24“, „30“, „40“ und überlassen das „cm“ einem Foto. Legen Sie die Maßeinheit der Größen einmal fest — am Gericht oder für eine ganze Kategorie auf einmal — und der Assistent sagt überall „40 cm“ statt eines nackten „40“. Er rät niemals selbst eine Einheit.
Bei jedem Import können Sie Ersetzen (die Datei als gesamte Speisekarte behandeln) oder Upsert (passende Gerichte aktualisieren und neue hinzufügen) wählen. Gerichte, die aus einem Import verschwinden, werden vor dem Assistenten verborgen, nie gelöscht — erneut importieren, um sie zurückzuholen. Jeder Versuch, manuell oder automatisch, erscheint im Import-Verlauf auf der Seite Speisekarte.
Sie möchten ganz neu anfangen? Menü leeren in der Menüleiste löscht nach einer Bestätigung alle Gerichte und Kategorien des ausgewählten Menüs und behält das Menü selbst — seinen Namen, die Hauptmenü-Markierung und eine daran gebundene QR-Seite —, sodass Ihr nächster Import an derselben Stelle landet.
E-Commerce-Integrationen
Wenn Sie einen Online-Shop betreiben, installieren Sie das native Plugin/Modul für Ihre Plattform — das ist der einfachste Weg, Ihre Speisekarte zu laden und synchron zu halten. Es überträgt Ihren Produktkatalog automatisch an AI Waiter und bettet das Chat-Widget ein — kein manuelles Skript und kein manueller Speisekarten-Upload nötig.
WordPress / WooCommerce
Installieren Sie das Plugin, fügen Sie Ihren Import-Token aus der Website-Konfiguration ein und klicken Sie auf Export Now — dieser erste Klick lädt Ihren gesamten Katalog. Damit er ohne Ihr Zutun aktuell bleibt, stellen Sie Automatic Sync auf täglich, wöchentlich oder monatlich; bei einer Neuinstallation ist die Option aus, es wird also nichts gesendet, solange Sie es nicht verlangen.
Repository & Installationsanleitung: github.com/waiter24ai/waiter24-woocommerce
Shopify
Installieren Sie die Shopify-App, verbinden Sie Ihren Shop, und der Katalog wird automatisch synchronisiert; das Widget wird in Ihren Storefront eingefügt.
Repository & Installationsanleitung: github.com/waiter24ai/waiter24-shopify
Magento 2
Installieren Sie das Modul per Composer, geben Sie Ihren Import-Token in der Admin-Konfiguration ein und klicken Sie auf Export Now. Setzen Sie Automatic Sync auf Yes, wenn der tägliche Cron den Katalog aktuell halten soll — bei einer Neuinstallation ist die Option aus, es wird also nichts gesendet, solange Sie es nicht verlangen.
Repository & Installationsanleitung: github.com/waiter24ai/waiter24-magento2
Shopware 6
Installieren Sie das Plugin, konfigurieren Sie Ihren Import-Token in den Plugin-Einstellungen und führen Sie den Export einmal aus. Aktivieren Sie Automatic Sync, damit die tägliche geplante Aufgabe den Katalog aktuell hält — bei einer Neuinstallation ist die Option aus, es wird also nichts gesendet, solange Sie es nicht verlangen.
Repository & Installationsanleitung: github.com/waiter24ai/waiter24-shopware
Messaging-Kanäle
Telegram
Erstellen Sie einen Bot mit @BotFather, kopieren Sie dessen Token und fügen Sie ihn in den Telegram-Einstellungen in Ihrem Panel ein. Dieselbe Speisekarte, dieselben Prompts und Funktionen betreiben den Bot — einschließlich Bestellannahme.
Persönliche Benachrichtigungen: Oben in den Telegram-Einstellungen können Sie Ihr eigenes Telegram auch für Bestell-/Reservierungs-/Rückruf-Benachrichtigungen über den eigenen Benachrichtigungsbot von waiter24.ai abonnieren — kein kundenseitiger Bot nötig, keine Chat-ID-Suche. Ein Klick auf den Link genügt, und das hat Vorrang vor dem manuellen Feld „Telegram-Chat-ID" darunter.
Verbinden Sie sich über die Zugangsdaten der WhatsApp Business Cloud API (Telefonnummern-ID und Token) in den WhatsApp-Einstellungen. Konfigurieren Sie den Webhook wie auf dieser Seite beschrieben, um Nachrichten zu empfangen.
Abrechnung & Abonnement
Jedes neue Konto startet mit einer 14-tägigen kostenlosen Testphase — voller Zugriff, keine Karte nötig. Wenn sie endet, wählen Sie auf der Seite Abrechnung einen Tarif, damit Ihr Assistent weiterläuft.
Tarife werden monatlich oder jährlich abgerechnet und automatisch von unserem Zahlungsanbieter eingezogen — Paddle (internationale Karten) oder LiqPay (UAH, für ukrainische Unternehmen). Sie erhalten für jede Abbuchung eine E-Mail-Quittung und können jederzeit kündigen, mit Zugriff bis zum Ende des bezahlten Zeitraums.
Endet die Testphase ohne Abonnement oder schlägt eine Verlängerung fehl, pausieren Chat-Widget und Bots bis zur Wiederherstellung der Zahlung — Menü, Einstellungen und Verlauf bleiben erhalten. Alle Details: Leitfaden Abrechnung & Abonnement.
Digitale QR-Speisekarte
Verwandeln Sie Ihre Speisekarte in eine öffentliche Seite, die Gäste durch Scannen eines QR-Codes öffnen — ohne App, ohne Anmeldung. Aktivieren Sie sie unter QR-Speisekarte in Ihrem Panel, legen Sie Logo, eine kurze Beschreibung und die Anzeigesprache fest, laden Sie dann das QR-Bild (PNG oder SVG) herunter und drucken Sie es.
Die Seite zeigt Ihre Speisekarte als mobilfreundliches Akkordeon (Kategorien → Unterkategorien → Gerichte) mit Fotos, Preisen, Gewicht, Nährwerten und Allergenen. Gerichte mit Größen oder Varianten erhalten eine Auswahlliste. Gäste schalten bei einem Gericht einen Schalter um und sammeln es so in einer Favoritenliste — ein Fenster vom unteren Bildschirmrand zeigt jede Auswahl, die gewählte Variante und die laufende Summe, und die Auswahl übersteht ein Neuladen der Seite. Geben Sie eine Tischanzahl an, erzeugen wir einen QR pro Tisch (table_1, table_2, …) plus einen allgemeinen — so kennt ein Scan bereits den Tisch, und Gäste können mit einem Tippen den Kellner rufen oder über den Assistenten bestellen. Der öffentliche Link ist ein privates, widerrufbares Token: Sollte ein gedruckter QR durchsickern, erzeugen Sie ihn neu und die alten Codes funktionieren nicht mehr.
Ihre Speisekarte in mehreren Sprachen
Eine QR-Speisekarte kann in mehr als einer Sprache veröffentlicht werden, damit ein ausländischer Gast Ihre Gerichte in seiner eigenen liest. Geben Sie im Block Sprachen der QR-Einstellungen an, in welcher Sprache Ihre Karte bereits geschrieben ist, und fügen Sie die weiteren hinzu, die Sie anbieten möchten — rund fünfzig stehen zur Verfügung, auch von rechts nach links geschriebene wie Hebräisch und Arabisch. Nach dem Speichern erscheint das Feld Maschinelle Übersetzung mit einer Zeile pro hinzugefügter Sprache: Drücken Sie Übersetzen, und Gerichtsnamen, Beschreibungen, Kategorien, Tags, Gewichte und Größenangaben werden im Hintergrund übersetzt. Bei einer großen Karte dauert das einige Minuten und Sie können die Seite verlassen; der Fortschritt wird dort angezeigt.
Preise, Zahlen und Fotos werden nie angetastet. Oben auf der öffentlichen Seite erscheint ein Sprachumschalter, und der gedruckte QR-Code öffnet weiterhin Ihre Originalsprache — eine zusätzliche Sprache bedeutet also nie einen Neudruck. Übersetzungen werden pro Gericht gespeichert und überleben einen erneuten Menü-Import oder eine Synchronisierung von Ihrer Website; ein weiterer Klick auf Übersetzen ergänzt nur das Neue, die bereits fertigen Gerichte kosten also nichts. Formulieren Sie einen übersetzten Namen von Hand um, behalten spätere Durchläufe Ihre Fassung. Betrachten Sie eine maschinelle Übersetzung als guten ersten Entwurf, nicht als lektorierte Speisekarte: Lesen Sie die öffentliche Seite, bevor Sie drucken.
Mehrere Speisekarten
Je nach Tarif können Sie mehrere Speisekarten anlegen — etwa eine Hauptkarte, eine Getränkekarte und einen saisonalen Brunch. Eine Karte ist die Hauptkarte: Sie versorgt das Chat-Widget auf Ihrer Website und die Telegram-/WhatsApp-Bots. Die übrigen sind Zusatzkarten, auf die Sie eine QR-Seite richten können — und der KI-Berater auf dieser QR-Seite antwortet aus der Karte, die die Seite zeigt, sodass ein Bar-QR nie Gerichte der Küchenkarte empfiehlt. Erstellen, duplizieren, umbenennen oder die Hauptkarte wechseln Sie auf der Seite Speisekarte; der Zähler dort zeigt, wie viele Karten Ihr Tarif erlaubt.
Häufig gestellte Fragen
Muss ich etwas auf meinem Server installieren?
Nein. Eine Codezeile auf Ihrer Website genügt — oder ein natives Plugin, wenn Sie WooCommerce, Shopify, Magento oder Shopware verwenden.
Wie lade ich meine Speisekarte?
Vier Wege: unser natives Shop-Plugin synchronisiert sie automatisch aus Ihrem Online-Shop (am einfachsten), ein KI-Import aus Foto/PDF liest Ihre Papierkarte, ein JSON-Datei-Import erledigt Massen-Uploads, oder Sie fügen Gerichte von Hand im Editor hinzu. Siehe Ihre Speisekarte in AI Waiter laden.
Wie aktualisiere ich die Speisekarte?
Bearbeiten Sie sie im Bereich Speisekarte Ihres Panels — Änderungen erreichen den Assistenten sofort, ohne Codeänderungen auf Ihrer Website. Wenn Ihre Speisekarte über unser Plugin aus einem Online-Shop stammt, aktualisieren Sie einfach die Produkte dort — die nächste Synchronisierung überträgt die Änderungen automatisch.
Kann ich meinen eigenen KI-Anbieter-Schlüssel verwenden?
Ja — aktivieren Sie «Eigenen API-Schlüssel verwenden» in den KI-Einstellungen und wählen Sie Ihren Anbieter (OpenAI, Gemini, Mistral u. a. oder einen selbst gehosteten Endpunkt).
Was passiert, wenn mein Tageslimit erreicht ist?
Der Chat teilt dem Gast höflich mit, dass er vorübergehend nicht verfügbar ist, und Sie erhalten eine Benachrichtigung. Limits werden täglich in der Zeitzone Ihres Restaurants zurückgesetzt.
Wie sehen Gäste meine Speisekarte ohne den Chat?
Aktivieren Sie die QR-Speisekarte, drucken Sie den erzeugten QR-Code, und Gäste öffnen durch Scannen eine schlanke, mobile digitale Speisekarte — Kategorien, Fotos, Preise, Nährwerte und eine Favoritenliste, in der von Ihnen gewählten Sprache. Keine App und keine Anmeldung nötig.
Kann ich mehr als eine Speisekarte haben?
Ja, wenn Ihr Tarif es erlaubt. Die Hauptkarte steuert den Assistenten auf der Website und die Bots; Zusatzkarten lassen sich auf der Seite Speisekarte erstellen oder duplizieren und an eine QR-Seite binden, deren eigener KI-Berater dann aus dieser Karte antwortet. Sie können jederzeit jede Karte zur Hauptkarte machen.
Wie erfahren Gäste von meinen laufenden Aktionen?
Es gibt drei Stellen — je nachdem, wer den Rabatt anwendet. Ein reduzierter Preis für ein einzelnes Gericht gehört in das Feld Aktionspreis dieses Gerichts im Speisekarten-Editor: Der Assistent nennt dann den neuen Preis, und die Bestellsumme wird damit berechnet. Ein Code, den der Gast selbst eingibt, gehört unter Aktionscodes: Der Server prüft ihn und wendet den Rabatt an. Alles andere — „zweite Pizza zum halben Preis“, eine Feiertagskarte, Happy Hour — wird auf der Seite Aktionen & Zeitplan beschrieben, samt Daten, Wochentagen oder Uhrzeiten; der Assistent erwähnt es nur in diesem Zeitraum. Solche Aktionen kündigt der Assistent an, er berechnet sie nicht — geben Sie also an, wer den Rabatt anwendet: Ihr Checkout oder Ihr Personal.
Brauchen Sie etwas Individuelles?
Wenn Ihre Plattform nicht aufgeführt ist oder Sie eine maßgeschneiderte Integration benötigen, kontaktieren Sie unser Support-Team und wir helfen Ihnen.