📦 Properties (Stockage persistant)

Stocker un nombre

Copierbot.setProp("total_users", 150)
bot.setProp("bot_version", 2.5)

Stocker du texte

Copierbot.setProp("welcome_msg", "Bienvenue dans notre bot ! 🎉")
bot.setProp("rules", "1. Soyez respectueux\n2. Pas de spam\n3. Amusez-vous !")

Stocker un booléen

Copier# Mettre le bot en maintenance
bot.setProp("maintenance", True)

Stocker du JSON (objet complexe)

Copierbot.setProp("config", {
    "langue": "fr",
    "actif": True,
    "admins": [123456789, 987654321],
    "limites": {"messages_par_jour": 100}
})

Stocker une liste

Copierbot.setProp("produits", [
    {"nom": "T-shirt", "prix": 25},
    {"nom": "Casquette", "prix": 15},
    {"nom": "Mug", "prix": 10}
])

Lire une valeur simple

Copiertotal = bot.getProp("total_users")
bot.sendMessage("Utilisateurs : " + str(total))

Lire du JSON

Copier# Le JSON est automatiquement parsé — vous recevez un dict Python
config = bot.getProp("config")
bot.sendMessage("Langue : " + config["langue"])
bot.sendMessage("Admins : " + str(len(config["admins"])))

Vérifier si une property existe

Copiermsg = bot.getProp("welcome_msg")
if msg:
    bot.sendMessage(msg)
else:
    bot.sendMessage("Aucun message de bienvenue configuré.")

Vérifier le mode maintenance

Copier# Au début d'une commande quelconque
if bot.getProp("maintenance"):
    bot.sendMessage("🔧 Le bot est en maintenance. Revenez plus tard !")
else:
    # Exécuter la commande normalement
    bot.sendMessage("Tout fonctionne ✅")

Copier# Supprimer une property
bot.deleteProp("old_config")

# Désactiver le mode maintenance
bot.deleteProp("maintenance")
bot.sendMessage("✅ Maintenance terminée !")

Copierconst wallet = Bot.currency(`solde_${user.id}`); // 0 par défaut
wallet.add(100); // +100
wallet.sub(20);
wallet.set(1000);
wallet.reset();
const v = wallet.value;
Bot.sendMessage(`Solde : ${wallet} coins`);

Stocker un solde

Copierbot.setUserProp("coins", 100)
bot.sendMessage("Vous avez reçu 100 🪙 de bienvenue !")

Stocker des préférences

Copierbot.setUserProp("langue", "fr")
bot.setUserProp("notifications", True)
bot.setUserProp("theme", "dark")

Stocker un panier d'achat

Copierbot.setUserProp("panier", [
    {"produit": "T-shirt", "quantite": 2, "prix": 25},
    {"produit": "Mug", "quantite": 1, "prix": 10}
])
bot.sendMessage("Panier mis à jour ✅")

Suivre la progression d'un formulaire

Copier# Enregistrer l'étape actuelle d'un formulaire multi-étapes
bot.setUserProp("form_step", "email")
bot.setUserProp("form_data", {
    "nom": u["prenom"],
    "email": "",
    "telephone": ""
})
bot.sendMessage("Entrez votre adresse email :")
bot.waitForResponse(lambda reply: handle_email(reply))

Lire le solde

Copiercoins = bot.getUserProp("coins")
if coins is not None:
    bot.sendMessage("💰 Votre solde : " + str(coins) + " 🪙")
else:
    bot.sendMessage("Vous n'avez pas encore de compte. Tapez /start !")

Afficher le profil complet

Copiercoins = bot.getUserProp("coins") or 0
niveau = bot.getUserProp("niveau") or 1
xp = bot.getUserProp("xp") or 0
langue = bot.getUserProp("langue") or "fr"

profil = "👤 Votre profil\n\n"
profil += "📛 Nom : " + u["prenom"] + "\n"
profil += "🪙 Coins : " + str(coins) + "\n"
profil += "⭐ Niveau : " + str(niveau) + "\n"
profil += "✨ XP : " + str(xp) + "\n"
profil += "🌍 Langue : " + langue

bot.sendMessage(profil)

Reprendre un formulaire en cours

Copierstep = bot.getUserProp("form_step")
if step:
    bot.sendMessage("Vous avez un formulaire en cours (étape : " + step + ")")
    bot.sendMessage("Tapez /cancel pour annuler ou continuez :")
else:
    bot.sendMessage("Aucun formulaire en cours.")

Copier# Vider le panier
bot.deleteUserProp("panier")
bot.sendMessage("🛒 Panier vidé !")

# Annuler un formulaire
bot.deleteUserProp("form_step")
bot.deleteUserProp("form_data")
bot.sendMessage("Formulaire annulé.")

# Réinitialiser le compte d'un utilisateur
bot.deleteUserProp("coins")
bot.deleteUserProp("niveau")
bot.deleteUserProp("xp")
bot.sendMessage("Compte réinitialisé.")

Lire les données d'un autre user

Copier# Lire les coins de l'utilisateur 987654321
other_coins = bot.getUserProp("coins", user_id=987654321)
if other_coins is not None:
    bot.sendMessage("Cet utilisateur a " + str(other_coins) + " 🪙")
else:
    bot.sendMessage("Cet utilisateur n'a pas de compte.")

Exemple : commande /check <user_id>

Copier# L'admin tape : /check 987654321
if params:
    target_id = int(params)
    coins = bot.getUserProp("coins", user_id=target_id) or 0
    niveau = bot.getUserProp("niveau", user_id=target_id) or 1

    bot.sendMessage(
        "📊 Profil #" + str(target_id) + "\n"
        "🪙 Coins : " + str(coins) + "\n"
        "⭐ Niveau : " + str(niveau)
    )
else:
    bot.sendMessage("Usage : /check <user_id>")

Ajouter +3 points à un autre utilisateur

Copier# L'admin tape : /add_pt 987654321
target_id = int(params)  # ID de l'autre utilisateur

# 1. Lire sa valeur actuelle
pts = bot.getUserProp("points", user_id=target_id) or 0

# 2. Ajouter 3
pts = pts + 3

# 3. Réécrire pour cet utilisateur
bot.setUserProp("points", pts, user_id=target_id)

bot.sendMessage("✅ +3 points donnés ! Il en a maintenant : " + str(pts))

Commande admin /add_pt <user_id> <montant>

Copier# Usage : /add_pt 987654321 50
if params:
    parts = params.split()
    if len(parts) == 2:
        target_id = int(parts[0])
        montant   = int(parts[1])

        solde = bot.getUserProp("coins", user_id=target_id) or 0
        solde = solde + montant
        bot.setUserProp("coins", solde, user_id=target_id)

        bot.sendMessage("✅ +" + str(montant) + " 🪙 donné à #" + str(target_id) + " — nouveau solde : " + str(solde))
    else:
        bot.sendMessage("Usage : /add_pt <user_id> <montant>")
else:
    bot.sendMessage("Usage : /add_pt <user_id> <montant>")

Ajouter des coins

Copiercoins = bot.getUserProp("coins") or 0
coins = coins + 50
bot.setUserProp("coins", coins)
bot.sendMessage("+ 50 🪙 ! Total : " + str(coins))

Retirer des coins (avec vérification)

Copierprix = 30
coins = bot.getUserProp("coins") or 0

if coins >= prix:
    coins = coins - prix
    bot.setUserProp("coins", coins)
    bot.sendMessage("Achat effectué ! Reste : " + str(coins) + " 🪙")
else:
    bot.sendMessage("❌ Solde insuffisant ! Vous avez " + str(coins) + " 🪙, il en faut " + str(prix))

Compteur global (ex : nombre de /start)

Copiertotal = bot.getProp("total_starts") or 0
total = total + 1
bot.setProp("total_starts", total)
bot.sendMessage("Bienvenue ! Vous êtes le visiteur n°" + str(total) + " 🎉")

Ajouter un élément à une liste

Copier# Ajouter un produit au panier
panier = bot.getUserProp("panier") or []
panier.append({"produit": "Casquette", "prix": 15})
bot.setUserProp("panier", panier)
bot.sendMessage("Casquette ajoutée au panier (" + str(len(panier)) + " articles)")

Modifier un champ dans un objet JSON

Copier# Changer la langue de l'utilisateur
settings = bot.getUserProp("settings") or {}
settings["langue"] = "en"
bot.setUserProp("settings", settings)
bot.sendMessage("Language changed to English 🇬🇧")

String → entier (int)

Copier# L'utilisateur envoie "42" — c'est un texte, pas un nombre
texte = message          # "42" (string)
nombre = int(texte)      # 42  (entier)
nombre = int(params)     # pratique pour les paramètres de commande

String → décimal (float)

Copierprix = float("3.99")    # 3.99
montant = float(params)  # si l'utilisateur tape "1.5"

Nombre → string (pour concatener)

Copiercoins = 150
bot.sendMessage("Vous avez " + str(coins) + " 🪙")
# Sans str() → TypeError: can only concatenate str (not "int") to str

Vérifier que c'est bien un nombre avant de convertir

Copierif params and params.isdigit():
    montant = int(params)
    coins = bot.getUserProp("coins") or 0
    coins = coins + montant
    bot.setUserProp("coins", coins)
    bot.sendMessage("+" + str(montant) + " ajouté ! Total : " + str(coins))
else:
    bot.sendMessage("❌ Entrez un nombre valide.")

Tableau de conversions Python

Copier# Lister toutes les props du bot
props = bot.listProps()
for p in props:
    bot.sendMessage(p["name"] + " = " + str(p["value"]))

# Lister seulement celles commençant par "config_"
config_props = bot.listProps(prefix="config_")

# Même nom qu'en JavaScript : Bot.getProps ou Props.getProps
scores = Props.getProps({"prefix": "score_"})

Commande /daily — Bonus quotidien

Copier# Vérifier le dernier bonus
last_daily = bot.getUserProp("last_daily") or 0
now = int(time.time())

# 86400 secondes = 24 heures
if now - last_daily < 86400:
    restant = 86400 - (now - last_daily)
    heures = restant // 3600
    minutes = (restant % 3600) // 60
    bot.sendMessage("⏰ Prochain bonus dans " + str(heures) + "h " + str(minutes) + "min")
else:
    bonus = 50
    coins = bot.getUserProp("coins") or 0
    coins = coins + bonus
    bot.setUserProp("coins", coins)
    bot.setUserProp("last_daily", now)
    bot.sendMessage("🎁 Bonus quotidien : +" + str(bonus) + " 🪙\nSolde : " + str(coins))

Commande /send — Transfert de coins

Copier# Usage : /send 987654321 50
if not params or " " not in params:
    bot.sendMessage("Usage : /send <user_id> <montant>")
else:
    parts = params.split(" ")
    target_id = int(parts[0])
    montant = int(parts[1])

    mes_coins = bot.getUserProp("coins") or 0

    if montant <= 0:
        bot.sendMessage("❌ Montant invalide.")
    elif mes_coins < montant:
        bot.sendMessage("❌ Solde insuffisant (" + str(mes_coins) + " 🪙)")
    else:
        # Retirer de l'expéditeur
        mes_coins = mes_coins - montant
        bot.setUserProp("coins", mes_coins)

        # Ajouter au destinataire
        ses_coins = bot.getUserProp("coins", user_id=target_id) or 0
        # Note : setProp pour un autre user n'existe pas
        # On stocke un "pending" que le destinataire récupérera

        bot.sendMessage("✅ " + str(montant) + " 🪙 envoyés ! Reste : " + str(mes_coins))

Donner de l'XP à chaque message (commande *)

Copier# Cette commande s'exécute sur CHAQUE message (wildcard *)
xp = bot.getUserProp("xp") or 0
niveau = bot.getUserProp("niveau") or 1

# Gagner 10 XP par message
xp = xp + 10

# Calculer le seuil pour le prochain niveau
seuil = niveau * 100  # Niveau 1 = 100 XP, Niveau 2 = 200 XP, etc.

# Level up ?
if xp >= seuil:
    niveau = niveau + 1
    xp = xp - seuil
    bot.setUserProp("niveau", niveau)
    bot.sendMessage(
        "🎊 LEVEL UP !\n\n"
        "⭐ Niveau " + str(niveau) + " atteint !\n"
        "Prochain palier : " + str(niveau * 100) + " XP"
    )

bot.setUserProp("xp", xp)

Commande /rank — Voir son rang

Copierxp = bot.getUserProp("xp") or 0
niveau = bot.getUserProp("niveau") or 1
seuil = niveau * 100

# Barre de progression visuelle
progression = int((xp / seuil) * 10)
barre = "█" * progression + "░" * (10 - progression)

bot.sendMessage(
    "📊 Votre progression\n\n"
    "⭐ Niveau : " + str(niveau) + "\n"
    "✨ XP : " + str(xp) + " / " + str(seuil) + "\n"
    "[" + barre + "] " + str(int(xp / seuil * 100)) + "%"
)

Commande /start — Détecter le parrainage

Copier# Si l'utilisateur arrive via un lien : /start 123456789
# params contient l'ID du parrain

deja_inscrit = bot.getUserProp("inscrit")
if not deja_inscrit:
    bot.setUserProp("inscrit", True)
    bot.setUserProp("coins", 50)  # Bonus de bienvenue

    # Si parrainé par quelqu'un
    if params:
        parrain_id = int(params)
        # Enregistrer qui l'a parrainé
        bot.setUserProp("parrain", parrain_id)

        # Compter les filleuls du parrain (prop globale)
        key = "referrals_" + str(parrain_id)
        count = bot.getProp(key) or 0
        bot.setProp(key, count + 1)

        bot.sendMessage("🎉 Bienvenue ! Vous avez été parrainé.\n+50 🪙 de bienvenue !")
    else:
        bot.sendMessage("🎉 Bienvenue !\n+50 🪙 de bienvenue !")
else:
    bot.sendMessage("Re-bonjour " + u["prenom"] + " ! 👋")

Commande /invite — Obtenir son lien

Copiermy_id = u["id"]
# Récupérer le username du bot via l'objet bot
lien = "https://t.me/VOTRE_BOT?start=" + str(my_id)

count = bot.getProp("referrals_" + str(my_id)) or 0

bot.sendMessage(
    "🔗 Votre lien de parrainage :\n\n"
    + lien + "\n\n"
    "👥 Filleuls : " + str(count) + "\n"
    "🪙 Bonus par filleul : +25 coins"
)

CopierBot.set("step_" + str(chat_id), "awaiting_email")
step = Bot.get_data("step_" + str(chat_id), "start")  # 2e arg = défaut
Bot.delete("step_" + str(chat_id))

# Vérifier l'utilisation
stats = Bot.storage()  # {used: 0.05, remaining: 499.95}  (en Ko, plafond 500 Ko)

Copierwallet = Bot.currency(f"solde_{user['id']}")
wallet.add(100)        # +100
wallet.sub(20)         # -20
wallet.set(1000)       # définir = 1000
wallet.reset()         # = 0
Bot.sendMessage(f"💰 Solde : {wallet.value} coins")

Une commande réservée au propriétaire

Copierif not Bot.isOwner():
    Bot.sendMessage("Commande réservée au propriétaire.")
else:
    commandes = Props.get("commandes", [])
    Bot.sendMessage(f"{len(commandes)} commande(s) reçue(s).")

Prévenir le propriétaire

Copierif Bot.ownerId:
    Bot.sendMessage("🔔 Nouvelle réservation", {"chat_id": Bot.ownerId})

Un dialogue à plusieurs questions, par client

Copier# /reserver
User.setProp("resa", {})
Bot.sendMessage("Ton nom ? (ou « annuler »)")
Bot.waitForResponse({"runCommand": "/resa_nom"})

# /resa_nom — `message` contient la réponse
rep = (message or "").strip()
if rep.lower() == "annuler":
    User.deleteProp("resa")
    Bot.sendMessage("Annulé 👍")
elif len(rep) < 2:
    Bot.sendMessage("Écris ton nom 🙂")
    Bot.waitForResponse({"runCommand": "/resa_nom"})   # on redemande
else:
    resa = User.getProp("resa", {}); resa["nom"] = rep; User.setProp("resa", resa)
    Bot.sendMessage("Pour combien de personnes ?")
    Bot.waitForResponse({"runCommand": "/resa_nb"})