🌙
BotStrike
Introduction
Épingler
pin_silent
Désépingler
Options combinées
Exemples
Récapitulatif

📌 Épingler des Messages

Épingler, épingler silencieusement et désépingler des messages dans les chats et groupes Telegram

Introduction

L'épinglage permet de fixer un message en haut d'un chat ou d'un groupe. Telegram affiche normalement une notification « Bot a épinglé un message… » à tous les membres.

📌 pin

Épingle le message après l'envoi. Tous les membres du groupe reçoivent une notification.

🔇 pin_silent

Épingle le message sans notification. Aucune alerte n'apparaît — le message système « Bot a épinglé… » est aussi automatiquement supprimé.

📍 unpinMessage

Désépingle un message spécifique (par ID) ou le dernier message épinglé.

⚠️ Permission requise — Le bot doit être administrateur du groupe avec la permission Épingler des messages pour utiliser ces fonctions.

Épingler un message

Ajoutez pin: true dans les options de Bot.sendMessage() pour épingler automatiquement le message après l'envoi.

JavaScript
Python
// Épingler un message — notification envoyée à tous
Bot.sendMessage("📌 Annonce importante !", { pin: true })
💡 Ce qui se passe — Le bot envoie le message, puis Telegram l'épingle automatiquement. Tous les membres du groupe voient une notification « Bot a épinglé un message ».

Épingler avec du formatage HTML

// Message épinglé avec formatage
Bot.sendMessage("<b>🔔 ANNONCE</b>\n\nLe serveur sera en maintenance demain à 14h.", {
    pin: true,
    parse_mode: "HTML"
})
# Épingler un message — notification envoyée à tous
Bot.sendMessage("📌 Annonce importante !", {"pin": True})
💡 Ce qui se passe — Le bot envoie le message, puis Telegram l'épingle automatiquement. Tous les membres du groupe voient une notification « Bot a épinglé un message ».

Épingler avec du formatage HTML

# Message épinglé avec formatage
Bot.sendMessage("<b>🔔 ANNONCE</b>\n\nLe serveur sera en maintenance demain à 14h.", {
    "pin": True,
    "parse_mode": "HTML"
})

pin_silent — Épingler sans notification

Utilisez pin_silent: true avec pin: true pour épingler discrètement. Aucune notification n'est envoyée et le message système « Bot a épinglé… » est automatiquement supprimé.

JavaScript
Python
// Épingler silencieusement — aucune notification
Bot.sendMessage("📌 Mise à jour discrète", { pin: true, pin_silent: true })

Différence avec pin normal

OptionNotificationMessage système
{ pin: true }✅ Oui — tous alertés✅ « Bot a épinglé… » visible
{ pin: true, pin_silent: true }❌ Non — aucune alerte❌ Supprimé automatiquement
# Épingler silencieusement — aucune notification
Bot.sendMessage("📌 Mise à jour discrète", {"pin": True, "pin_silent": True})

Différence avec pin normal

OptionNotificationMessage système
{"pin": True}✅ Oui — tous alertés✅ « Bot a épinglé… » visible
{"pin": True, "pin_silent": True}❌ Non — aucune alerte❌ Supprimé automatiquement
✅ Idéal pour — Mises à jour fréquentes (prix, compteur, statut) où vous ne voulez pas déranger les membres à chaque épinglage.

Désépingler un message

Utilisez Bot.unpinMessage() pour retirer l'épingle d'un message.

JavaScript
Python

Désépingler le dernier message épinglé

// Désépingler le dernier message épinglé
Bot.unpinMessage()

Désépingler un message spécifique

// Désépingler par message_id
Bot.unpinMessage(12345)

Épingler puis désépingler après un délai

// Épingle un message, le supprime après 60 secondes
Bot.sendMessage("⚡ Promo flash — expire dans 1 minute !", {
    pin: true,
    pin_silent: true,
    delete_after: 60
})
💡 delete_after — Le message sera automatiquement supprimé après 60 secondes. Comme il est supprimé, l'épingle disparaît aussi.

Désépingler le dernier message épinglé

# Désépingler le dernier message épinglé
Bot.unpinMessage()

Désépingler un message spécifique

# Désépingler par message_id
Bot.unpinMessage(12345)

Épingler puis désépingler après un délai

# Épingle un message, le supprime après 60 secondes
Bot.sendMessage("⚡ Promo flash — expire dans 1 minute !", {
    "pin": True,
    "pin_silent": True,
    "delete_after": 60
})
💡 delete_after — Le message sera automatiquement supprimé après 60 secondes. Comme il est supprimé, l'épingle disparaît aussi.

Combiner pin avec d'autres options

Vous pouvez combiner pin avec toutes les autres options de Bot.sendMessage().

JavaScript
Python

Silencieux + Épinglé + Supprimé automatiquement

// Tout en un : silencieux + épinglé + auto-supprimé
Bot.sendMessage("⚡ Promo flash !", {
    silent: true,
    pin: true,
    pin_silent: true,
    delete_after: 60
})

Épingler avec des boutons

// Message épinglé avec boutons inline
Bot.sendButtons("📌 Sondage épinglé :", [
    { text: "👍 Oui", data: "vote_oui" },
    { text: "👎 Non", data: "vote_non" }
], { pin: true, pin_silent: true })

Épingler avec du Markdown

// Annonce formatée en Markdown
Bot.sendMessage("*📌 RÈGLES DU GROUPE*\n\n1\\. Respect mutuel\n2\\. Pas de spam\n3\\. Français uniquement", {
    pin: true,
    pin_silent: true,
    parse_mode: "Markdown"
})

Silencieux + Épinglé + Supprimé automatiquement

# Tout en un : silencieux + épinglé + auto-supprimé
Bot.sendMessage("⚡ Promo flash !", {
    "silent": True,
    "pin": True,
    "pin_silent": True,
    "delete_after": 60
})

Épingler avec des boutons

# Message épinglé avec boutons inline
Bot.sendButtons("📌 Sondage épinglé :", [
    {"text": "👍 Oui", "data": "vote_oui"},
    {"text": "👎 Non", "data": "vote_non"}
], {"pin": True, "pin_silent": True})

Épingler avec du Markdown

# Annonce formatée en Markdown
Bot.sendMessage("*📌 RÈGLES DU GROUPE*\n\n1\\. Respect mutuel\n2\\. Pas de spam\n3\\. Français uniquement", {
    "pin": True,
    "pin_silent": True,
    "parse_mode": "Markdown"
})

Exemples pratiques

JavaScript
Python

📢 Commande /annonce — Épingler une annonce

// Commande /annonce — l'admin envoie un texte après la commande
if (!params) return Bot.sendMessage("❌ Utilisation : /annonce <votre texte>")

Bot.sendMessage("📢 " + params, { pin: true })

📋 Commande /regles — Épingler les règles du groupe

// Remplacer les règles épinglées
// D'abord désépingler l'ancien message
Bot.unpinMessage()

// Puis épingler les nouvelles règles
Bot.sendMessage("📋 <b>RÈGLES</b>\n\n✅ Respect\n✅ Pas de spam\n✅ Pas de pub\n❌ Insultes = ban", {
    pin: true,
    pin_silent: true,
    parse_mode: "HTML"
})

🔄 Commande /unpin — Désépingler

// Commande simple pour désépingler
Bot.unpinMessage()
Bot.sendMessage("✅ Message désépinglé.")

📢 Commande /annonce — Épingler une annonce

# Commande /annonce — l'admin envoie un texte après la commande
if not params:
    Bot.sendMessage("❌ Utilisation : /annonce <votre texte>")
    return

Bot.sendMessage("📢 " + params, {"pin": True})

📋 Commande /regles — Épingler les règles du groupe

# Remplacer les règles épinglées
# D'abord désépingler l'ancien message
Bot.unpinMessage()

# Puis épingler les nouvelles règles
Bot.sendMessage("📋 <b>RÈGLES</b>\n\n✅ Respect\n✅ Pas de spam\n✅ Pas de pub\n❌ Insultes = ban", {
    "pin": True,
    "pin_silent": True,
    "parse_mode": "HTML"
})

🔄 Commande /unpin — Désépingler

# Commande simple pour désépingler
Bot.unpinMessage()
Bot.sendMessage("✅ Message désépinglé.")

Récapitulatif

Option JavaScript Python Effet
Épingler { pin: true } {"pin": True} Épingle avec notification
Épingler silencieux { pin: true, pin_silent: true } {"pin": True, "pin_silent": True} Épingle sans notif, supprime le message système
Désépingler (dernier) Bot.unpinMessage() Bot.unpinMessage() Retire l'épingle du dernier message épinglé
Désépingler (par ID) Bot.unpinMessage(id) Bot.unpinMessage(id) Retire l'épingle d'un message spécifique
Épingler + supprimer { pin: true, delete_after: 60 } {"pin": True, "delete_after": 60} Épingle puis supprime après N secondes
⚠️ Rappel — Le bot doit être administrateur du groupe avec la permission « Épingler des messages » pour que ces fonctions marchent. Dans un chat privé, ça fonctionne toujours.