Messages et boutons
Composez les réponses du bot avec texte, photos, boutons sous le message et questions dont la réponse est enregistrée.
Sur cette page
Pour que le bot envoie du texte, une photo et un bouton « Choisir », ajoutez l'action Envoyer un message. La réponse est composée de parties appelées blocs : par exemple la photo d'un produit, puis sa description avec des boutons. Les boutons placés sous le message sont aussi appelés boutons inline.
La même action peut poser une question et attendre la réponse, par exemple demander un téléphone et l'enregistrer dans la fiche client. Voici les blocs, les boutons et les réglages d'un dialogue.
Blocs de message
Cliquez sur Ajouter un bloc et choisissez ce qu'il faut envoyer. Vous pouvez combiner un texte d'accueil, une photo et le fichier d'un programme de cours.
- Texte : texte mis en forme, jusqu'à 4 096 caractères, avec substitutions et boutons.
- Photo : image avec légende.
- Fichier : document avec légende.
- Message vocal : audio OGG/OPUS, MP3 ou M4A, jusqu'à 50 Mo, affiché par Telegram comme un vocal (
sendVoice). - GIF : animation ou MP4 sans son, jusqu'à 50 Mo (
sendAnimation). - Message vidéo rond : MP4 carré de 60 secondes maximum (
sendVideoNote), sans légende. À chaque envoi, le fichier de la médiathèque est de nouveau téléversé : Telegram n'accepte pas danssendVoice,sendAnimationousendVideoNoteunfile_idobtenu par un autre moyen. - Carrousel : de 2 à 10 cartes avec chacune photo, légende et boutons. Dans Telegram, elles défilent avec « ‹ › » dans un même message via
editMessageMediasi chaque photo dispose d'unfile_idutilisable, fourni dans la carte ou obtenu depuis la médiathèque. Si l'ID d'une seule photo ne peut pas être obtenu, toutes les cartes partent comme des messages photo séparés. Il en va de même sur d'autres canaux, comme VK. La légende et les boutons de chaque carte sont conservés. - Pause : attente en secondes avant le bloc suivant.
- IA : réponse générée par un modèle à partir d'un prompt.
- Réaction : lance une autre réaction, avec attente facultative de sa fin.
Les vocaux, GIF, vidéos rondes et carrousels fonctionnent comme les autres blocs dans les réactions et dans leur diffusion rapide (voir Diffusions).
Réordonnez les blocs par glisser-déposer. Choisissez l'affichage Dans l'ordre ou Au hasard pour varier les réponses. Le menu principal du bot peut rester inchangé, être défini ou masqué.
Options d'un bloc
Les blocs texte et média peuvent être épinglés, envoyés sans son, protégés contre le transfert, marqués comme spoiler, envoyés sans aperçu des liens ou supprimés automatiquement après N secondes.
Boutons inline
Dans un bloc, définissez le Texte du bouton et son Type :
- Texte : envoie le libellé comme réponse de l'utilisateur. Dans Telegram et VK, c'est un clavier de réponse ; le clic peut répondre à une question ou lancer une réaction fondée sur le texte. WhatsApp, Instagram, Messenger et le widget web utilisent un bouton de réponse sans clavier permanent.
- Lien : ouvre une URL.
- Application web : ouvre une Telegram Mini App. Voir Mini App.
- Appeler une réaction : lance une autre réaction au clic.
- Requête inline : place « @bot requête » dans le champ de saisie du chat courant ou propose de choisir un autre chat (
switch_inline_query/switch_inline_query_current_chat). Fonctionne seulement dans Telegram après activation du mode inline via/setinlinechez @BotFather. GetMyBot ne répond pas à ces requêtes (answerInlineQueryn'est pas implémenté) : le bouton prépare le texte, sans effectuer de recherche. - Texte prérempli : lien
https://t.me/<bot>?text=…ouvrant le chat avec le bot et plaçant le texte dans la saisie, sans l'envoyer (prefill). - Lien de paiement : ouvre une URL de paiement obligatoire. Le paiement est créé par l'action Émettre une facture. Il s'agit d'une page externe, pas d'une facture Telegram native.
- Notification : affiche du texte au clic sans lancer de réaction ni transmettre les données Carry. Dans Telegram, c'est une notification brève ou une fenêtre de 200 caractères maximum ; dans VK, un bandeau bref de 90 caractères maximum, sans fenêtre.
Texte ou texte prérempli
| Objectif | Type et réglage | Résultat du clic |
|---|---|---|
| Choisir « Oui » dans un formulaire | Texte, libellé « Oui » ; le message doit attendre une réponse | « Oui » est remis à l'étape du dialogue |
| Préparer une demande | Texte prérempli, libellé « Écrire », texte « Je souhaite commander » | Un brouillon apparaît dans la saisie du chat ; la personne peut le modifier et l'envoyer |
Le libellé du bouton et son texte prérempli sont deux champs distincts. Ce dernier n'envoie rien et ne lance pas de réaction à lui seul.
Un clic sur Appeler une réaction arrive au bot comme un événement distinct, appelé callback. Les boutons Requête inline et Texte prérempli agissent dans Telegram et ne produisent pas cet événement : ils ne prennent donc en charge ni answerCallbackQuery ni Carry.
Icône et couleur du bouton
Vous pouvez afficher un emoji Premium avant le texte. Indiquez son ID dans icon_custom_emoji_id : un entier positif de 64 bits. Par exemple, 007 est lu comme 7. Les lettres, zéro, les valeurs négatives ou trop grandes sont rejetées ; le bouton est enregistré sans icône.
Telegram ne montre l'icône que si le bot a les droits nécessaires : nom supplémentaire obtenu par Fragment, ou Telegram Premium chez le propriétaire pour un envoi direct en privé ou dans un groupe. Sinon Telegram ignore l'icône sans la remplacer par un emoji ordinaire.
Le style définit la couleur : Normal sans couleur, Principal bleu, Succès vert, Danger rouge. Le champ technique s'appelle style.
Usage unique (single_use) permet d'utiliser une seule fois les données gardées par le bouton, par exemple pour confirmer un choix. Le changement de libellé et la suppression du message se règlent séparément dans le comportement au clic.
Options des boutons
Une option est un réglage à cocher ou décocher :
- Nouvelle ligne : place le bouton sur la ligne suivante.
- Toute la largeur : lui réserve une ligne ; le bouton suivant commence aussi sur une nouvelle ligne.
Schéma approximatif (les crochets représentent les boutons) :
Une ligne : [Catalogue] [Aide]
Nouvelle ligne : [Catalogue]
[Aide]
Toute la largeur : [ Aide ]
Les lignes et couleurs sont disponibles dans Telegram et VK. Leur disposition est conservée après réouverture et modification. Les emojis Premium Telegram exigent un bot compatible. Il n'existe pas d'option « Ouvrir dans Telegram » : la Bot API ne permet pas de contrôler ce comportement par ce type de réglage.
Limites selon le canal
Choisissez un canal pour le bloc ou le bouton. Avec Tous les canaux, l'éditeur ne propose que les capacités communes. Un type non pris en charge ne peut pas être enregistré.
- Telegram : URL, Mini App, réaction, notification/alerte, lignes, couleurs et emoji personnalisé si le bot possède les droits.
- VK : URL, réaction, snackbar, lignes et couleurs. VK Mini App et VK Pay nécessitent la sélection d'un canal VK compatible.
- WhatsApp : un seul bouton URL CTA, sans autres boutons dans le message. Jusqu'à trois boutons de réponse ordinaires ; de quatre à dix, ils apparaissent en liste. Libellé de 20 caractères maximum. Pas de lignes, couleurs, Mini App ou notifications.
- Instagram / Messenger : l'adaptateur actuel ne transmet que les boutons de réponse rapide (quick replies), avec un libellé de 20 caractères maximum. URL, Mini App, notifications, lignes et couleurs ne sont pas pris en charge.
- Widget web : URL et boutons de réponse, sans lignes, couleurs ou notifications.
- Email : liens, y compris de paiement ; pas de boutons de réponse ni de notifications.
Pour des boutons créés depuis une liste, le nombre de colonnes n'est réglable que si le canal gère les lignes. Sinon, le canal choisit la disposition. Les limites du nombre de boutons et de longueur des libellés sont contrôlées à l'envoi.
Comportement au clic
Pour un bouton qui transmet le clic au bot, vous pouvez remplacer le message par du texte ou le contenu d'une autre réaction, supprimer le message, attribuer une étiquette ou enregistrer un paramètre si le canal prend en charge l'opération. Modifier le libellé du bouton lui-même après le clic n'est possible que dans Telegram, par exemple de « S'inscrire » à « Sélectionné ». La modification des messages dans VK ne permet pas celle du libellé du bouton.
Telegram attend que le bot confirme le clic avec answerCallbackQuery. GetMyBot le fait normalement et enlève l'indicateur de chargement. Ignorer answerCallbackQuery désactive cette confirmation.
Dans Texte au clic d'un bouton Réaction, saisissez une confirmation comme « Cours choisi » (200 caractères maximum dans Telegram, 90 dans VK ; les substitutions fonctionnent). Telegram l'affiche généralement brièvement au-dessus du chat. Afficher en fenêtre contextuelle, réservé à Telegram, utilise answerCallbackQuery avec show_alert. Si le texte est vide, le bot retire seulement l'indicateur. Quand Ignorer answerCallbackQuery est activé, ni texte ni fenêtre ne sont envoyés.
Données du bouton (Carry)
Carry aide le bouton à se souvenir de l'objet auquel il se rapporte. Un manteau et une robe peuvent porter le même bouton « Acheter » : stockez product_id=101 sur le premier et product_id=102 sur le second. Au clic sur la robe, la réaction suivante reçoit {{ctx.product_id}} avec la valeur 102.
Dans l'éditeur, ce réglage s'appelle Données au clic. La clé nomme la valeur, qui peut être un nombre, du texte ou une substitution. Le bot l'enregistre lors de l'envoi du message et la place dans les données temporaires de la réaction (ctx) au clic. Chaque bouton possède ses propres valeurs.
La durée de validité (ttl_seconds, TTL) se donne en secondes : 3600 représente une heure. 0 prend la valeur par défaut de 30 jours. Après expiration, les données ne sont plus disponibles. Usage unique (single_use) les efface au premier clic. Un prix enregistré ne suit pas automatiquement le catalogue : vérifiez le prix actuel à l'aide de l'ID produit avant le paiement.
Réglage pas à pas et différence avec les paramètres permanents : Boutons dynamiques et paramètres.
Boutons dynamiques
Si les produits ou cours figurent déjà dans une liste, n'ajoutez pas les boutons un à un. Boutons dynamiques depuis une liste crée un bouton par élément. Indiquez la liste dans ctx, l'alias d'un élément, le nombre de boutons par ligne et le modèle du libellé. {{item.name}} insère par exemple le nom du produit courant. Voir Boutons dynamiques et paramètres.
Emoji Premium dans le texte
Dans un bloc texte, le bouton de mise en forme Emoji Premium insère <tg-emoji emoji-id="…">🙂</tg-emoji>. Les destinataires Telegram Premium voient l'emoji personnalisé à la place de l'emoji de repli ; les autres voient celui de repli. Le balisage fonctionne dans un bloc HTML ou Markdown. L'ID compte au plus 32 chiffres ; vous pouvez l'obtenir via getCustomEmojiStickers ou en transférant un message à @idstickerbot, par exemple.
Lien vers le bot et texte prérempli
t.me/<bot>?start=<parametre> lance /start <parametre> dans Telegram. Il n'est pas possible d'ouvrir le chat avec ce paramètre sans lancer /start. Choisissez la solution adaptée :
- /start silencieux : pour une réaction au déclencheur Commande /start avec la bonne Identifiant du lien de démarrage, laissez Envoyer un message sans bloc. Le bot ne répond pas visiblement au
/start, mais l'étiquette est disponible dans le contexte de l'événement pour les conditions et actions de cette réaction. - Texte prérempli :
https://t.me/<bot>?text=<texte>, via le bouton dédié ou un lien ordinaire, ouvre le chat et place le texte dans la saisie sans l'envoyer./startne se déclenche pas ; la personne envoie elle-même le message. - Message automatique « au nom de l'utilisateur » à l'ouverture : la Bot API ne le permet pas. Le bot ne peut pas écrire au nom de la personne. L'alternative la plus proche est un deep link
?start=et une réaction qui envoie le texte voulu au nom du bot.
Réponse attendue (étapes de dialogue)
Un bloc texte peut attendre la réponse de la personne. Le message devient alors une étape de dialogue et le scénario est en pause jusqu'à la réponse. Plusieurs étapes successives constituent un questionnaire ou un assistant dans le chat.
Type de contenu attendu
Le bot peut attendre du texte, un choix parmi des options (boutons), une photo, une vidéo, une note vidéo, un audio, un document, un vocal, un emplacement, un contact, un calendrier ou un dé. Un autre type de contenu est jugé inadapté.
Vérifier le texte
Vous pouvez vérifier que le texte est un téléphone, une adresse e-mail, un lien, une date, une heure ou qu'il correspond à une formule. Si vous attendez un téléphone, un texte quelconque sera refusé et le bot montrera un message d'erreur. La vérification par formule étendue doit renvoyer un texte vide en cas de réussite et un message d'erreur en cas de refus.
Enregistrer la réponse
La réponse peut être enregistrée dans un paramètre. Elle est ensuite accessible par {{param.cle}} et dans les conditions. Les étapes du dialogue remplissent ainsi un petit profil client.
Erreurs, rappel et expiration
- Message en cas d'erreur de validation : texte affiché si la réponse est refusée.
- Rappel : message envoyé si la personne ne répond pas.
- Fin de l'attente après un délai : indique quand le bot cesse d'attendre. À l'expiration, vous pouvez lancer une réaction pour clore doucement le questionnaire. Dans les liens entre réactions, elle apparaît comme « Délai de la réponse attendue », et la réaction à la réponse comme « Réponse attendue ».
Quitter une étape avec une commande
/cancel ou le mot russe « отмена » arrêtent l'attente et répondent « Отменено. », ou lancent la réaction d'annulation configurée. Les autres commandes sont normalement traitées comme toute réponse et vérifiées ; l'étape peut ainsi retenir la personne jusqu'à une réponse valide. Avec Les commandes du bot (comme /start) interrompent l'attente (escape_on_command), toute commande, y compris /start au milieu du questionnaire, arrête silencieusement l'attente et s'exécute normalement.
Substitutions
Le bouton Substitutions insère les données de l'expéditeur ({{first_name}}, {{username}}, {{user_id}}), de l'événement ({{text}}, {{chat_id}}, {{datetime}}) et des paramètres ({{param.cle}}). Liste complète et formules : Substitutions et formules.
Bouton de menu du bot
L'action Menu button choisit le menu ordinaire, les commandes ou un bouton Mini App avec texte et URL. Sa portée est le chat actuel ou le réglage général du bot. Vous pouvez, par exemple, donner une Mini App personnelle au client actuel. La disponibilité dépend des capacités du canal.
Pour aller plus loin
- Substitutions et formules : valeurs dans les textes et boutons.
- Actions : autres actions des réactions.
- Mini App : bouton d'application web.