✨ Messages riches — titres, tableaux, listes, médias & streaming

Copier# Commande : /boutique
Bot.sendRichMessage([
    {"h1": "Bienvenue sur notre boutique"},
    "Voici nos offres du moment. Chaque paragraphe est bien séparé.",
    "Deuxième paragraphe, détaché du premier.",

    {"h2": "Nos forfaits"},
    {"table": [
        ["Forfait", "Prix", "Crédits"],   # 1re ligne = en-tête
        ["Free",    "0 $",   "20"],
        ["Pro",     "15 $",  "100"],
    ]},

    {"h2": "Comment démarrer"},
    {"list": ["Créer un compte", "Choisir un forfait", "Payer"], "ordered": True},

    {"quote": "Merci de votre confiance."},
    {"code": "Bot.sendMessage('Salut')", "lang": "python"},
    {"details": "Voir les conditions", "blocks": [
        "Ce contenu est replié par défaut.",
    ]},
    {"divider": True},
    {"footer": "Envoyé automatiquement."},
])

CopierBot.sendRichMessage([
    {"list": [
        "Une puce simple",
        # Une puce composée de plusieurs blocs
        [{"h3": "Une puce avec du code"},
         {"code": "Bot.sendMessage('ok')", "lang": "python"}],
    ]},

    {"details": "Détails techniques", "blocks": [
        "Replié par défaut, l'utilisateur déplie s'il veut.",
        {"table": [["Champ", "Valeur"], ["Version", "10.1"]]},
    ]},
])

CopierBot.sendRichMessage([
    {"h2": "Notre boutique"},
    # forme native : le bloc part tel quel vers Telegram
    {"type": "map",
     "location": {"latitude": 48.8584, "longitude": 2.2945},
     "zoom": 15, "width": 600, "height": 400},
])

CopierBot.sendRichMessage([
    {"h1": "Notre nouveau modèle"},
    "Disponible en boutique dès aujourd'hui.",

    {"photo": "https://exemple.com/produit.jpg",
     "caption": "Le modèle 2026, coloris nuit",
     "credit": "Photo : Studio BotStrike"},

    {"h2": "En mouvement"},
    {"video": "https://exemple.com/demo.mp4", "caption": "30 secondes de démo"},

    {"table": [["Modèle", "Prix"], ["Nuit", "129 $"], ["Jour", "119 $"]]},
], {
    "reply_markup": {"inline_keyboard": [[
        {"text": "🛒 Commander", "callback_data": "buy"},
    ]]},
})

CopierBot.sendRichMessage([
    {"h2": "L'appartement"},

    {"collage": [url_salon, url_cuisine, url_chambre],
     "caption": "3 pièces, 62 m² — la visite en images"},

    {"map": [48.8584, 2.2945], "zoom": 15, "caption": "À 400 m du métro"},

    {"pullquote": "Un coup de cœur immédiat.", "credit": "Marie, locataire"},
])

CopierBot.sendRichMessage([
    {"type": "paragraph", "text": [
        "Votre commande ",
        {"type": "bold", "text": "#1042"},
        " est ",
        {"type": "spoiler", "text": "en préparation"},
        ". Suivi : ",
        {"type": "url", "text": "ici", "url": "https://exemple.com/suivi/1042"},
    ]},
])

CopierBot.sendRichMessage([
    {"h2": "Ta commande #1042"},
    "Tout est prêt. Que veux-tu faire ?",
    {"buttons": [
        {"text": "✅ Confirmer", "style": "success", "command": "/confirmer"},
        {"text": "✖ Annuler",    "style": "danger",  "command": "/annuler"},
    ], "align": "center"},

    {"h3": "Liens utiles"},
    {"buttons": [
        {"text": "Suivre le colis", "url": "https://exemple.com/suivi/1042"},
        {"text": "Code promo", "copy": "MERCI10"},
    ]},
    {"buttons": [{"text": "Épuisé", "disabled": True}], "align": "right"},
])

CopierApi.sendRichMessage({
    "rich_message": {"blocks": [
        {"type": "heading", "text": "Ta commande #1042", "size": 2},
        {"type": "paragraph", "text": "Tout est prêt. Que veux-tu faire ?"},
        {"type": "buttons", "align": "center", "buttons": [
            {"text": "✅ Confirmer", "style": "success", "callback_data": "/confirmer"},
            {"text": "✖ Annuler", "style": "danger", "callback_data": "/annuler"},
        ]},
        {"type": "buttons", "buttons": [
            {"text": "Mini App", "web_app": {"url": "https://exemple.com/app"}},
            {"text": "Code promo", "copy_text": {"text": "MERCI10"}},
            {"text": "Mon profil", "url": "tg://user?id=123456789"},
            {"text": "Épuisé", "disabled": {}},
        ]},
    ]},
    "protect_content": True,
})

Copiermulti = round(1 + random.random() * 9, 2)
blocs = [
    {"photo": Props.get("media_crash", "") or "https://exemple.com/crash.png"},
    {"h2": "🚀 Lucky Jet"},
    {"table": [["", "Multiplicateur"], ["Ce tour", f"x{multi:.2f}"]]},
    {"buttons": [
        {"text": "🔄 Rejouer", "style": "primary", "command": "/luckyjet"},
    ], "align": "center"},
]

if request and request.get("callback_query"):
    Bot.editRichMessage(blocs)               # appui sur « Rejouer »
else:
    r = Bot.sendRichMessage(blocs)           # commande tapée
    p = (((r or {}).get("result") or {}).get("rich_message") or {}).get("blocks", [{}])[0].get("photo")
    if p and not Props.get("media_crash", ""):
        Props.set("media_crash", p[-1]["file_id"])   # plus de retéléchargement

CopierBot.sendRichMessage([
    {"h2": "Votre commande #1042"},
    {"table": [["Article", "Qté", "Prix"], ["T-shirt", "2", "30 $"]]},
], {
    "silent": True,
    "reply_markup": {
        "inline_keyboard": [[
            {"text": "✅ Confirmer", "callback_data": "confirm_1042"},
            {"text": "❌ Annuler",   "callback_data": "cancel_1042"},
        ]],
    },
})

Copier# Simple
Bot.streamText("Voici une réponse longue qui va s'afficher mot à mot…")

# Avec une phase de réflexion affichée avant la réponse
Bot.streamText(reponse, {
    "thinking": "Je consulte les données…",
    "chunk": 4,        # mots ajoutés à chaque étape (défaut 5)
    "delay": 0.5,      # SECONDES entre deux étapes (défaut 0.6)
    "blocks": [        # blocs ajoutés sous le texte, dans le message final
        {"code": "resultat = 42", "lang": "python"},
    ],
})

Copier# Commande : /chat ou tout message texte
reply = BsAI.chat(message, history=True)

Bot.streamText(reply, {
    "thinking": "Je réfléchis…",
    "chunk": 6,
})

Copierdid = 12345                                       # entier non nul, stable

Bot.sendRichMessageDraft([{"thinking": "Je cherche…"}], did)
Bot.sendRichMessageDraft([{"p": "Voici le"}], did)
Bot.sendRichMessageDraft([{"p": "Voici le résultat :"}], did)

# Obligatoire : sans ceci, rien ne reste dans le chat.
Bot.sendRichMessage([{"p": "Voici le résultat : 42"}])

Copier# ❌ Écrire le format Telegram brut — inutilement verbeux
Bot.sendRichMessage([{"type": "table", "cells": [[{"text": "A"}]]}])
# ✅ Le raccourci fait la conversion
Bot.sendRichMessage([{"table": [["A"]]}])

# ❌ thinking dans un message définitif → refusé par Telegram
Bot.sendRichMessage([{"thinking": "…"}])
# ✅ seulement dans un brouillon
Bot.sendRichMessageDraft([{"thinking": "…"}], 1)

# ❌ Oublier la finalisation → l'utilisateur ne voit rien après 30 s
Bot.sendRichMessageDraft([{"p": "fini"}], 1)
# ✅ Ou plus simplement :
Bot.streamText("fini")

# ❌ Markdown à l'intérieur d'un bloc riche
Bot.sendRichMessage(["*gras*"])       # affiche les astérisques
# ✅ La structure remplace le formatage : titres, citations, listes
Bot.sendRichMessage([{"h2": "Gras"}])
# ✅ Ou la mise en forme en ligne (§3.5)
Bot.sendRichMessage([
    {"type": "paragraph", "text": [{"type": "bold", "text": "gras"}]},
])

# ❌ Un fichier local dans un bloc média → jamais téléversé
Bot.sendRichMessage([{"photo": "/tmp/recu.png"}])
# ✅ URL publique, file_id… ou l'envoi média classique
Bot.sendPhoto("/tmp/recu.png", "Votre reçu")

# ❌ En forme native, une légende posée sur l'objet média → ignorée
Bot.sendRichMessage([
    {"type": "photo", "photo": {"type": "photo", "media": url,
                                "caption": "Perdue"}},
])
# ✅ La légende se met sur le bloc — ou passez par le raccourci
Bot.sendRichMessage([{"photo": url, "caption": "Affichée"}])

# ❌ delay en millisecondes (c'est du JavaScript, pas du Python)
Bot.streamText(txt, {"delay": 500})   # 500 SECONDES d'attente !
# ✅ en secondes
Bot.streamText(txt, {"delay": 0.5})

Copier# Commande : /prix
Bot.sendRichMessage([
    {"h1": "💰 Nos tarifs"},
    {"table": [
        ["Forfait",    "Prix",  "Inclus"],
        ["Découverte", "0 $",   "20 crédits"],
        ["Standard",   "15 $",  "100 crédits"],
        ["Illimité",   "49 $",  "Sans limite"],
    ]},
    {"quote": "Changement de forfait possible à tout moment."},
    {"footer": "Tarifs mis à jour le 01/01."},
], {
    "reply_markup": {
        "inline_keyboard": [[{"text": "🛒 Souscrire", "callback_data": "buy"}]],
    },
})

Copier# Commande : /macommande
panier = [["T-shirt", "2", "30 $"], ["Casquette", "1", "12 $"]]

Bot.sendRichMessage([
    {"h2": "🧾 Commande #1042"},
    {"table": [["Article", "Qté", "Prix"]] + panier},
    {"p": "Total : 42 $"},
    {"details": "Conditions de livraison", "blocks": [
        "Livraison sous 3 à 5 jours ouvrés.",
        {"list": ["Retour gratuit sous 14 jours", "Suivi par e-mail"]},
    ]},
    {"divider": True},
    {"footer": "Merci pour votre achat !"},
])

Copier# Commande : /rapport
did = 777

Bot.sendRichMessageDraft([{"thinking": "Récupération des données…"}], did)
data = HTTP.get("https://api.exemple.com/stats")

Bot.sendRichMessageDraft([{"p": "Calcul en cours…"}], did)

Bot.sendRichMessage([
    {"h2": "📊 Rapport du jour"},
    {"table": [["Indicateur", "Valeur"], ["Utilisateurs", str(data["users"])]]},
    {"footer": "Généré automatiquement."},
])

CopierApi.sendRichMessage({
    "rich_message": {
        "blocks": [
            {"type": "heading", "text": "Facture #1042", "size": 2},
            {"type": "photo",
             "photo": {"type": "photo", "media": "https://exemple.com/produit.jpg"},
             "caption": {"text": "Article commandé"}},
            {"type": "paragraph", "text": "Merci de votre achat."},
        ],
    },
    "protect_content": True,          # pas de transfert ni de copie
    "message_effect_id": "5104841245755180586",
    "reply_parameters": {"message_id": message_id},
})

CopierApi.sendRichMessage({
    "rich_message": {
        "html": ("<h1>Nouveau modèle</h1>"
                 "<p>Disponible <b>aujourd'hui</b>.</p>"
                 "<img src='tg://photo?id=produit'>"),
        "media": [
            {"id": "produit",
             "media": {"type": "photo",
                       "media": "https://exemple.com/produit.jpg"}},
        ],
    },
})

Copier# Brouillon animé — conversations privées, draft_id non nul
Api.sendRichMessageDraft({
    "draft_id": 777,
    "rich_message": {"blocks": [{"type": "thinking", "text": "Je cherche…"}]},
})

# Transformer un message déjà envoyé en message riche
Api.editMessageText({
    "message_id": msg_id,
    "rich_message": {"blocks": [{"type": "paragraph", "text": "Terminé ✅"}]},
})

Copier# Légende simple : la voie classique, Markdown accepté
Bot.sendPhoto("https://exemple.com/produit.jpg", "*Nouveau* modèle — 129 $")

# En brut, même chose avec toutes les options Telegram
Api.sendPhoto({
    "photo": "https://exemple.com/produit.jpg",
    "caption": "*Nouveau* modèle — 129 $",
    "parse_mode": "Markdown",
    "show_caption_above_media": True,
    "has_spoiler": False,
})