Documentation
Documentation technique pour connecter et configurer AI Waiter.
Démarrage rapide — tout site (script manuel)
Connecter AI Waiter à n'importe quel site web se fait en deux étapes :
- Copiez votre clé de widget et code d'intégration depuis Intégration au site dans votre panneau.
- Collez le code avant la balise fermante
</body>de votre site :
<script defer src="https://waiter24.ai/widget.js" data-key="VOTRE_CLE"></script>
C'est tout — l'apparence, les textes, le comportement linguistique et les fonctionnalités du widget se gèrent depuis le panneau, sans modification de code. Il fonctionne avec tout site, y compris les SPA (React, Vue, Next.js) et les constructeurs de sites. Après avoir changé les réglages, actualisez la page de votre site.
Ordre de configuration recommandé
- Menu — chargez vos plats. Si vous gérez une boutique en ligne, le plugin natif les synchronise automatiquement ; sinon, importez depuis une photo/PDF, téléversez un JSON ou ajoutez-les à la main. Voir Charger votre menu dans AI Waiter. L'IA ne recommande que ce qui figure à votre menu.
- Test du chat — discutez avec votre assistant dans le panneau avant la mise en ligne.
- Intégration au site — intégrez le code (ou connectez le plugin de votre boutique) et reliez l'assistant à votre site.
- Réglages du widget — choisissez le mode du widget (Assistant restaurant ou Support), puis ajustez les textes, la langue et les fonctionnalités.
- À propos de l'établissement — adresse, téléphone, horaires par jour de la semaine et règles de la maison (parking, Wi-Fi, paiement, réservations, animaux). L'assistant répond aux questions sur l'établissement uniquement à partir de ces informations.
- Connectez éventuellement les bots Telegram et WhatsApp, configurez les zones de livraison, la fidélité, les réservations et d'autres fonctionnalités depuis la barre latérale.
Charger votre menu dans AI Waiter
L'assistant ne recommande que les plats qui figurent à votre menu : le charger est donc la première chose à faire. Choisissez la méthode adaptée à la forme sous laquelle votre menu existe déjà — vous pouvez les combiner et réimporter à tout moment.
- Plugin natif de boutique — la méthode la plus simple. Si vous gérez une boutique en ligne sous WooCommerce, Shopify, Magento 2 ou Shopware, installez notre plugin/application dédié. Il transmet tout votre catalogue de produits à AI Waiter, puis le maintient synchronisé automatiquement selon un planning — nouveaux plats, changements de prix et articles épuisés arrivent sans réimport manuel. Le même plugin intègre aussi le widget de chat pour vous. Voir Intégrations e-commerce ci-dessous.
- Photo ou PDF de votre menu. Sur la page Menu, choisissez Importer depuis une photo/PDF et téléversez une image ou un PDF de votre menu papier — l'IA le lit et crée les catégories et les plats pour vous. Idéal lorsque vous n'avez pas de catalogue en ligne.
- Fichier JSON. Choisissez JSON → Importer pour téléverser un fichier de menu (téléchargez d'abord l'exemple pour voir le format), ou Exporter pour sauvegarder votre menu. Pratique pour un chargement en masse ou pour déplacer un menu entre comptes.
- À la main. Ajoutez catégories, sous-catégories et plats directement dans l'éditeur Menu — avec prix, variantes, photos, poids, tags et informations allergènes/nutritionnelles.
- Des tailles importées sous forme de simples nombres. Les boutiques nomment souvent les tailles de pizza « 24 », « 30 », « 40 » et laissent le « cm » à une photo. Définissez l'unité de mesure des tailles une seule fois — sur le plat, ou sur toute une catégorie d'un coup — et l'assistant dit « 40 cm » partout au lieu d'un « 40 » nu. Il ne devine jamais une unité de lui-même.
Chaque import vous laisse choisir Remplacer (traiter le fichier comme le menu entier) ou Upsert (mettre à jour les plats correspondants et ajouter les nouveaux). Les plats qui disparaissent d'un import sont masqués à l'assistant, jamais supprimés — réimportez-les pour les rétablir. Chaque tentative, manuelle ou automatique, apparaît dans l'historique d'import sur la page Menu.
Besoin de repartir de zéro ? Vider le menu dans la barre du menu supprime, après confirmation, tous les plats et catégories du menu sélectionné et conserve le menu lui-même — son nom, son statut de menu principal et toute page QR qui y est liée — afin que votre prochain import arrive au même endroit.
Intégrations e-commerce
Si vous gérez une boutique en ligne, installez le plugin/module natif de votre plateforme — c'est la façon la plus simple de charger votre menu et de le garder synchronisé. Il transmet automatiquement votre catalogue de produits à AI Waiter et intègre le widget de chat — aucun script manuel ni téléversement de menu nécessaire.
WordPress / WooCommerce
Installez le plugin, collez votre jeton d'import depuis la Configuration du site et cliquez sur Export Now — ce premier clic charge tout votre catalogue. Pour le maintenir à jour sans rien faire, réglez Automatic Sync sur quotidien, hebdomadaire ou mensuel ; sur une nouvelle installation, l'option est désactivée, donc rien n'est envoyé tant que vous ne le demandez pas.
Dépôt & guide d'installation : github.com/waiter24ai/waiter24-woocommerce
Shopify
Installez l'application Shopify, connectez votre boutique et le catalogue se synchronise automatiquement ; le widget est ajouté à votre vitrine.
Dépôt & guide d'installation : github.com/waiter24ai/waiter24-shopify
Magento 2
Installez le module via Composer, saisissez votre jeton d'import dans la configuration admin et cliquez sur Export Now. Réglez Automatic Sync sur Yes lorsque vous voulez que le cron quotidien garde le catalogue à jour ; sur une nouvelle installation, l'option est désactivée, donc rien n'est envoyé tant que vous ne le demandez pas.
Dépôt & guide d'installation : github.com/waiter24ai/waiter24-magento2
Shopware 6
Installez le plugin, configurez votre jeton d'import dans les paramètres du plugin et lancez l'export une fois. Activez Automatic Sync pour que la tâche planifiée quotidienne garde le catalogue à jour ; sur une nouvelle installation, l'option est désactivée, donc rien n'est envoyé tant que vous ne le demandez pas.
Dépôt & guide d'installation : github.com/waiter24ai/waiter24-shopware
Canaux de messagerie
Telegram
Créez un bot avec @BotFather, copiez son jeton et collez-le dans les paramètres Telegram de votre panneau. Le même menu, les mêmes prompts et fonctionnalités animent le bot — y compris la prise de commande.
Notifications personnelles : en haut des paramètres Telegram, vous pouvez aussi abonner votre propre Telegram aux notifications de commandes/réservations/rappels via le bot de notification de waiter24.ai — aucun bot destiné aux clients requis, ni de recherche d'ID de chat. Un clic sur le lien suffit, et cela prend le pas sur le champ manuel « ID de chat Telegram » ci-dessous.
Connectez-vous via les identifiants de l'API WhatsApp Business Cloud (ID du numéro de téléphone et jeton) dans les paramètres WhatsApp. Configurez le webhook comme décrit sur cette page pour commencer à recevoir des messages.
Facturation & abonnement
Chaque nouveau compte démarre avec un essai gratuit de 14 jours — accès complet, sans carte. À la fin, choisissez un forfait sur la page Facturation pour que votre assistant continue de fonctionner.
Les forfaits sont facturés mensuellement ou annuellement et prélevés automatiquement par notre prestataire — Paddle (cartes internationales) ou LiqPay (UAH, pour les entreprises ukrainiennes). Vous recevez un reçu par e-mail pour chaque prélèvement et pouvez résilier à tout moment, en conservant l'accès jusqu'à la fin de la période payée.
Si l'essai se termine sans abonnement, ou si un renouvellement échoue, le widget de chat et les bots se mettent en pause jusqu'au rétablissement du paiement — votre menu, vos réglages et votre historique sont conservés. Tous les détails : guide Facturation & abonnement.
Menu numérique QR
Transformez votre menu en une page publique que les clients ouvrent en scannant un QR code — sans application ni connexion. Activez-le dans Menu QR de votre panneau, définissez un logo, une brève description et la langue d'affichage, puis téléchargez l'image QR (PNG ou SVG) et imprimez-la.
La page affiche votre menu sous forme d'accordéon adapté au mobile (catégories → sous-catégories → plats) avec photos, prix, poids, valeurs nutritionnelles et allergènes. Les plats proposant des tailles ou des variantes affichent une liste déroulante. Les clients activent un interrupteur sur un plat pour le collecter dans une liste de favoris — une fenêtre en bas de l'écran montre chaque choix, la variante retenue et le total courant, et leur sélection survit à un rechargement de la page. Si vous indiquez un nombre de tables, nous générons un QR par table (table_1, table_2, …) plus un générique — ainsi un scan connaît déjà la table, et le client peut appeler un serveur ou commander via l'assistant en un geste. Le lien public est un jeton privé et révocable : si un QR imprimé fuite, régénérez-le et les anciens codes cessent de fonctionner.
Votre menu en plusieurs langues
Un menu QR peut être publié en plus d'une langue, pour qu'un client étranger lise vos plats dans la sienne. Dans le bloc Langues des réglages du menu QR, indiquez la langue dans laquelle votre menu est déjà rédigé, puis ajoutez les autres que vous souhaitez proposer — une cinquantaine sont disponibles, y compris des langues écrites de droite à gauche comme l'hébreu et l'arabe. Enregistrez : un panneau Traduction automatique apparaît, avec une ligne par langue ajoutée. Appuyez sur Traduire et les noms de plats, descriptions, catégories, étiquettes, poids et libellés de taille sont traduits en arrière-plan. Sur un grand menu cela prend quelques minutes et vous pouvez quitter la page ; la progression s'affiche sur place.
Les prix, les nombres et les photos ne sont jamais touchés. Un sélecteur de langue apparaît en haut de la page publique, et le QR imprimé continue d'ouvrir votre langue d'origine — ajouter une langue n'impose donc jamais de réimprimer. Les traductions sont stockées par plat et survivent à une réimportation du menu ou à une synchronisation depuis votre site ; réappuyer sur Traduire ne complète que le nouveau, les plats déjà faits ne coûtent donc rien. Si vous reformulez un nom traduit à la main, les exécutions suivantes conservent votre version. Considérez une traduction automatique comme un bon premier jet, pas comme un menu relu : lisez la page publique avant d'imprimer.
Plusieurs menus
Selon votre forfait, vous pouvez créer plusieurs menus — par exemple un menu principal, une carte de bar et un brunch saisonnier. Un menu est le menu principal : il alimente le widget de chat de votre site et les bots Telegram/WhatsApp. Les autres sont des menus supplémentaires vers lesquels vous pouvez pointer une page QR — et le conseiller IA de cette page QR répond à partir du menu qu'elle affiche, de sorte qu'un QR de bar ne recommande jamais des plats de la carte cuisine. Créez, dupliquez, renommez ou changez le menu principal depuis la page Menu ; le compteur y indique combien de menus votre forfait autorise.
Questions fréquentes
Dois-je installer quelque chose sur mon serveur ?
Non. Une seule ligne de code sur votre site suffit — ou un plugin natif si vous utilisez WooCommerce, Shopify, Magento ou Shopware.
Comment charger mon menu ?
Quatre méthodes : notre plugin natif de boutique le synchronise automatiquement depuis votre boutique en ligne (le plus simple), un import IA depuis photo/PDF lit votre menu papier, un import de fichier JSON gère les chargements en masse, ou vous ajoutez les plats à la main dans l'éditeur. Voir Charger votre menu dans AI Waiter.
Comment mettre à jour le menu ?
Modifiez-le dans la section Menu de votre panneau — les changements atteignent l'assistant immédiatement, sans modification de code sur votre site. Si votre menu provient d'une boutique en ligne via notre plugin, mettez simplement à jour les produits là-bas — la prochaine synchronisation transfère les changements automatiquement.
Puis-je utiliser ma propre clé de fournisseur IA ?
Oui — activez « Utiliser ma propre clé API » dans les Paramètres IA et choisissez votre fournisseur (OpenAI, Gemini, Mistral et autres, ou un point de terminaison auto-hébergé).
Que se passe-t-il lorsque ma limite quotidienne est atteinte ?
Le chat indique poliment au client qu'il est temporairement indisponible, et vous recevez une notification. Les limites se réinitialisent chaque jour dans le fuseau horaire de votre restaurant.
Comment les clients voient-ils mon menu sans le chat ?
Activez le Menu QR, imprimez le QR code généré, et les clients ouvrent en le scannant un menu numérique mobile et épuré — catégories, photos, prix, valeurs nutritionnelles et liste de favoris, dans la langue que vous choisissez. Aucune application ni connexion requise.
Puis-je avoir plusieurs menus ?
Oui, si votre forfait le permet. Le menu principal pilote l'assistant du site et les bots ; des menus supplémentaires peuvent être créés ou dupliqués sur la page Menu et liés à une page QR, dont le conseiller IA répond alors à partir de ce menu. Vous pouvez à tout moment définir n'importe quel menu comme principal.
Comment informer les clients de mes promotions en cours ?
Il y a trois endroits, selon qui applique la remise. Un prix réduit sur un seul plat se saisit dans le champ Prix promotionnel de ce plat dans l'éditeur de menu : l'assistant annonce alors le nouveau prix, et le total de la commande est calculé avec celui-ci. Un code que le client saisit lui-même se crée dans Codes promotionnels : le serveur le valide et applique la remise. Tout le reste — « deuxième pizza à moitié prix », un menu de fête, un happy hour — se décrit sur la page Promotions et planning, avec les dates, les jours de la semaine ou les heures concernés ; l'assistant n'en parle que pendant cette période. Ces promotions sont annoncées par l'assistant, pas calculées : précisez donc qui applique la remise, votre page de paiement ou votre personnel.
Besoin d'une solution sur mesure ?
Si votre plateforme n'est pas répertoriée ou si vous avez besoin d'une intégration sur mesure, contactez notre équipe de support et nous vous aiderons.