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éphones et e-mails (autant que nécessaire), 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.
- Visibilité IA — publiez votre établissement sous la forme que lisent les moteurs de recherche et les assistants IA, et ouvrez éventuellement votre propre adresse depuis laquelle l'assistant d'un client (Claude, ChatGPT, un agent) lira votre carte. Voir Être trouvé par Google et les assistants IA et Laisser l'assistant IA d'un client lire votre carte.
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.
Être trouvé par Google et les assistants IA
De plus en plus de clients n'ouvrent jamais de page de résultats : ils demandent à ChatGPT, Gemini ou Perplexity où manger à proximité, et l'assistant répond à partir des informations structurées qu'il trouve sur vous. La page Visibilité IA de votre panneau transforme ce que vous avez déjà saisi — nom, adresse, téléphone, horaires, carte avec les prix et vos réponses rapides — en balisage standard Schema.org (données structurées) que ces systèmes et les résultats enrichis de Google savent lire. Rien n'est inventé : un champ laissé vide est simplement omis, et les calories n'apparaissent que pour les plats où elles ont réellement été renseignées.
Deux façons de le publier, qui ne s'excluent pas. La première est un bloc de code que vous copiez depuis le panneau et collez une fois dans le <head> de votre propre site. C'est la plus utile, car l'information vit alors sur votre domaine, là où se construit votre référencement. Attention : c'est un instantané — après avoir modifié la carte, revenez le copier à nouveau. La seconde est une page publique prête à l'emploi sur waiter24.ai avec les mêmes informations : elle fonctionne immédiatement et se met à jour toute seule ; activez-la si vous ne pouvez pas modifier votre site. Cette page reste désactivée tant que vous ne l'activez pas — votre adresse, votre téléphone et votre carte ne sont publiés que là où vous le décidez.
Une précision technique utile : les robots de ChatGPT, Claude et Perplexity n'exécutent pas JavaScript. Ils lisent uniquement le HTML envoyé par votre serveur — c'est pourquoi ces informations doivent figurer dans la page elle-même, et non être ajoutées par un script après le chargement.
Laisser l'assistant IA d'un client lire votre carte
Sur la même page se trouve un second interrupteur, facultatif. Activez-le et votre établissement obtient sa propre adresse à laquelle l'assistant IA personnel d'un client — Claude, ChatGPT ou un agent — peut se connecter et lire directement : toute la carte avec les prix et les allergènes, si vous êtes ouvert en ce moment, les offres en cours, où et à quel tarif vous livrez. L'adresse apparaît sur la page une fois l'interrupteur activé ; elle figure aussi sur votre page publique pour qu'un client puisse la copier.
Deux points à dire clairement. Il répond uniquement à partir de ce que vous avez saisi : il ne peut inventer ni un prix ni un horaire, et là où un champ est vide, il le dit et propose votre numéro. Et il se contente de lire tant que vous n'en décidez pas autrement. La prise de commande et les demandes de table sont deux interrupteurs supplémentaires sur la même page, désactivés tant que vous ne les activez pas. Avec les commandes activées, l'assistant chiffre le panier d'après votre carte, annonce ce total au client et ne peut envoyer que ce montant exact — si un prix a bougé depuis le chiffrage, la commande s'arrête au lieu de changer en silence — et elle vous parvient comme une commande venue de votre site, non confirmée tant que vous ne l'avez pas confirmée. Vous pouvez aussi plafonner le montant qu'un assistant peut commander. Une table demandée ainsi est une demande : rien ne vérifie qu'une table est libre, et le client est prévenu que vous confirmerez. Sur la même page, sous les interrupteurs, vous voyez si quelqu'un s'est effectivement connecté : requêtes, outils demandés, quels assistants et ce qui a échoué, sur les 30 derniers jours. N'attendez pas beaucoup de trafic la première année : l'intérêt est qu'être joignable au démarrage ne vous coûte qu'un interrupteur.
Ce qu’un client fait concrètement de cette adresse, en trois étapes : dans son assistant, il ouvre les paramètres et trouve la section Connecteurs, ajoute un connecteur personnalisé et y colle votre adresse, puis demande avec ses propres mots — ce qui est végétarien, si vous êtes ouverts, le prix de la livraison chez lui. Une chose mérite d’être dite franchement, car c’est là que ça coince : les connecteurs personnalisés sont réservés aux formules payantes dans la plupart des assistants aujourd’hui. Ces trois étapes figurent aussi sur votre page publique, sous l’adresse : il suffit d’y envoyer le client. Et sur votre propre page, un bouton « Tester la connexion » : un clic et vous voyez exactement ce qu’un assistant reçoit à cet instant — avec quels outils il peut lire, et avec lesquels il peut agir. Ce test vous appartient, ce n’est pas du trafic : il n’entre pas dans les chiffres d’activité en dessous.
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.
Comment savoir si la notification de commande est bien arrivée ?
Chaque commande le consigne. Ouvrez-la dans la section Commandes : la ligne en dessous indique l'origine — chat du site, Telegram, WhatsApp — et si la notification a été envoyée. Si elle affiche Échec de l'envoi ou Aucun destinataire configuré, la commande est bien enregistrée dans le panneau mais personne n'a été prévenu : vérifiez l'e-mail ou le chat Telegram de destination dans les réglages du canal concerné. Si rien n'est configuré, nous écrivons à l'e-mail du propriétaire du compte, pour qu'aucune commande ne disparaisse en silence.
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.