Documentation officielle

Administrer le bot Cookiz, simplement.

Chaque action est expliquée pas à pas, avec son effet côté client et les erreurs à éviter.

Version active : CloudflareAdministration : TelegramAccès : admins uniquement

Démarrage rapide

Les commandes et réflexes indispensables.

Gérer la boutique

/manage

À envoyer en privé au bot principal. Ouvre le catalogue, les livraisons, les commandes, les promotions et les statistiques.

Demander de l’aide

/aide votre question

À envoyer à @helprhinobot en privé ou dans les sujets 1 et 195 du groupe admin.

Quitter une action commencée

Si le bot attend un nom, un prix, une quantité, un horaire, un code promo ou un message client, envoyez /cancel. Le formulaire est annulé et le menu revient.

Accès refusé ?Votre identifiant Telegram doit être présent dans la liste des administrateurs. Un simple ajout au groupe ne suffit pas.

Catalogue & stock

Tout ce qui détermine les produits visibles et commandables.

Créer une catégorie

1
/manage → Catalogue & Produits → Catégories.
2
Touchez Ajouter une catégorie.
3
Envoyez son nom. Elle apparaît immédiatement dans le catalogue.

Renommer ou supprimer une catégorie

Utilisez les boutons Renommer une catégorie ou Supprimer une catégorie, puis choisissez la catégorie. Une catégorie qui contient encore des produits ne peut pas être supprimée : déplacez ou supprimez d’abord ses produits.

Ajouter un produit

1
/manage → Catalogue & Produits → Produits.
2
Touchez Ajouter un produit et choisissez sa catégorie.
3
Envoyez son nom, puis son prix en euros, par exemple 4.50.

Modifier un produit existant

Ouvrez Produits, puis touchez la ligne « catégorie · produit ». Vous pouvez modifier :

VisibilitéMasque ou affiche le produit dans la Mini App.

État du stockBascule rapidement entre disponible et rupture.

Quantité0 = rupture, -1 = illimité.

Nom et prixLes nouvelles valeurs s’appliquent aux prochaines commandes.

SupprimerRetire définitivement le produit du catalogue.

Visibilité ≠ stockUn produit invisible est caché. Un produit en rupture peut rester affiché mais ne peut pas être commandé.

Livraisons & créneaux

Choisir où et quand les clients peuvent commander.

Activer un mode de livraison

1
/manage → Livraison & Créneaux.
2
Ouvrez Types de livraison.
3
Touchez Livraison à domicile ou Point relais pour l’activer ou le désactiver.

Ajouter une plage horaire

1
Ouvrez Jours & Horaires, puis choisissez le jour.
2
Touchez Ajouter une plage.
3
Envoyez la plage au format 14:00-18:00. L’heure de fin doit être après l’heure de début.

Supprimer une plage

Ouvrez le jour concerné puis touchez directement la plage existante. Elle est supprimée après l’action.

Régler le délai minimum

Dans Délai minimum de commande, envoyez un nombre de minutes entre 0 et 1440. Exemple : 120 empêche une commande moins de deux heures avant le créneau.

Avant de désactiver un modeVérifiez les commandes déjà enregistrées : leur mode de livraison ne change pas automatiquement.

Gérer les commandes

Suivre une commande de sa réception jusqu’à sa clôture.

Reçue→En préparation→Prête→En livraison→Terminée

Faire avancer une commande

1
/manage → Commandes en cours.
2
Ouvrez la commande. Vérifiez le client, les articles, le total, le créneau et l’adresse ou le relais.
3
Touchez le bouton du statut suivant. Le client reçoit automatiquement une notification.
4
Après Terminée, le client reçoit une demande d’avis.

Contacter rapidement le client

Retard 15 minEnvoie le message de retard prévu.

Retard 30 minInforme d’un retard plus long.

Je suis arrivéPrévient que le livreur est sur place.

Client injoignableDemande au client de reprendre contact.

Message personnaliséLe prochain texte envoyé est transmis au client.

Annuler une commande

Ouvrez la commande puis touchez Annuler cette commande. Le statut devient final, le client est informé et le stock réservé est restauré lorsque les règles de stock le permettent.

Action définitiveUne commande terminée ou annulée ne peut plus changer de statut depuis le menu.

Codes promotionnels

Créer une réduction, la limiter puis l’activer ou la couper.

1
/manage → Codes Promo → Créer un code promo.
2
Envoyez les six valeurs sur une seule ligne.

FormatCODE TYPE VALEUR MINIMUM MAX EXPIRATIONExempleBIENVENUE10 percent 10 20.00 100 2026-12-31

Type	Effet	Valeur
`percent`	Réduction en pourcentage	`10` = −10 %
`fixed`	Montant fixe en euros	`5.00` = −5 €
`shipping`	Livraison offerte	Valeur ignorée

MINIMUM : montant minimum du panier en euros.
MAX : nombre total d’utilisations ; 0 = illimité.
EXPIRATION : YYYY-MM-DD ou - sans date limite.

Pour couper ou réactiver un code, ouvrez Codes Promo puis touchez sa ligne. ✅ signifie actif, ❌ signifie inactif.

Statistiques & avis

Lire rapidement l’activité de la boutique.

/manage → Statistiques affiche :

Aujourd’huiNombre de commandes non annulées et chiffre généré depuis minuit, heure de Paris.

Cette semaineCommandes et chiffre depuis lundi.

AvisNote moyenne sur 5 et nombre total d’évaluations.

Calcul du chiffreLes commandes annulées sont exclues. Les autres statuts sont inclus.

Tickets conseiller

Répondre aux clients depuis un sujet Telegram dédié.

Quand un client demande de l’aide

1
Le client ouvre Parler à un conseiller dans la Mini App.
2
Le bot crée un sujet dédié dans le groupe conseiller.
3
Répondez dans ce sujet : texte et pièces jointes sont relayés au client en privé.
4
Les réponses du client reviennent dans le même sujet.

Fermer le ticket

Dans le sujet du client, envoyez /close ou utilisez le bouton de fermeture disponible. Le client est prévenu, la conversation est archivée, un résumé est envoyé dans les journaux puis le sujet est supprimé.

Ne changez pas de sujetChaque sujet correspond à un seul client. Répondre ailleurs ne transmet pas le message au bon client.

Assistant IA

Obtenir une réponse courte fondée sur le projet actif.

En privé

Ouvrez @helprhinobot et posez directement votre question, ou utilisez /aide.

Dans le groupe admin

Dans les sujets 1 et 195, utilisez obligatoirement /aide votre question.

Exemples efficaces

/aide Comment passer une commande en préparation ?
/aide Comment mettre un produit en rupture ?
/aide Quel format pour une promo de 10 % ?

Seuls les administrateurs enregistrés peuvent l’utiliser. Dans les autres sujets, les groupes non autorisés ou avec un compte non-admin, il ne répond pas.

Sécurité & bonnes pratiques

Les règles qui évitent les erreurs et les fuites de données.

N’envoyez jamais un token Telegram, une clé API ou un mot de passe dans un groupe.
Vérifiez le nom du produit, le prix et la quantité avant de confirmer.
Vérifiez l’adresse, le créneau et le contenu avant de changer le statut d’une commande.
Utilisez /cancel si vous avez ouvert le mauvais formulaire.
N’utilisez /clear que si vous êtes le super-admin et savez quels messages seront supprimés.
Ne lancez pas de déploiement depuis ce guide : les mises à jour techniques restent réservées à la maintenance.

Deux systèmes séparésLe bot boutique actif tourne sur Cloudflare. @helprhinobot tourne indépendamment sur le VPS. Une panne de l’assistant ne doit pas empêcher les commandes clients.

Dépannage rapide

Les contrôles à faire avant de signaler un problème.

Le menu /manage refuse mon accès

Vérifiez que vous utilisez le bon compte Telegram. Relevez votre identifiant affiché dans le message de refus et demandez son ajout à la liste des admins.

Un produit n’apparaît pas dans la Mini App

Ouvrez sa fiche et vérifiez sa visibilité, son état de stock et sa quantité. Vérifiez aussi qu’il appartient à la bonne catégorie.

Aucun créneau n’est proposé

Vérifiez que le jour possède une plage horaire, que le mode de livraison est actif et que le délai minimum n’exclut pas les créneaux proches.

Une commande n’est plus dans la liste

La liste ne montre que les commandes reçues, en préparation, prêtes ou en livraison. Une commande terminée ou annulée quitte la liste active.

Le client ne reçoit pas mon message

Pour une commande, utilisez le menu de contact de sa fiche. Pour un ticket, répondez dans le sujet exact du client. Vérifiez que le client n’a pas bloqué le bot.

L’assistant IA ne répond pas dans le groupe

Utilisez /aide dans le sujet 1 ou 195, avec un compte administrateur. Les messages ordinaires et les autres sujets sont volontairement ignorés.