Knowledge base GetMyBot

Messaggi e pulsanti

Comporre le risposte del bot con testo, foto e pulsanti e porre domande salvando le risposte.

In questa pagina

Per far inviare al bot un testo, una foto e il pulsante «Scegli», aggiungi l'azione Invia messaggio. La risposta è fatta di parti separate, chiamate blocchi: per esempio, prima la foto di un prodotto e poi una descrizione con pulsanti. I pulsanti sotto al messaggio sono detti anche pulsanti inline.

La stessa azione può fare una domanda e attendere la risposta, per esempio chiedere un telefono e salvarlo nella scheda del cliente. Qui trovi blocchi, pulsanti e domande.

Blocchi del messaggio

Premi Aggiungi blocco e scegli cosa inviare. Puoi combinare testo di benvenuto, foto e un file con il programma di una lezione.

  • Testo: testo formattato fino a 4096 caratteri, con sostituzioni e pulsanti.
  • Foto: immagine con didascalia.
  • File: documento con didascalia.
  • Voice (vocale): audio OGG/OPUS, MP3 o M4A fino a 50 MB, mostrato da Telegram come messaggio vocale (sendVoice).
  • GIF: animazione o MP4 senza audio fino a 50 MB (sendAnimation).
  • Video note (videomessaggio circolare): MP4 quadrato fino a 60 secondi, senza didascalia (sendVideoNote). A ogni invio il file della libreria media viene caricato di nuovo: per sendVoice, sendAnimation o sendVideoNote Telegram non accetta un file_id ottenuto con un metodo diverso.
  • Carousel (carosello): da 2 a 10 schede, ciascuna con foto, didascalia e pulsanti propri. In Telegram si scorrono con «‹ ›» nello stesso messaggio tramite editMessageMedia solo se ogni foto ha un file_id utilizzabile, indicato nella scheda o ottenuto dalla libreria media. Se ne manca anche uno, tutte le schede partono come messaggi fotografici separati. Succede lo stesso negli altri canali, come VK. Didascalia e pulsanti di ogni scheda restano disponibili.
  • Ritardo: pausa in secondi prima del blocco successivo.
  • IA: risposta generata da un modello a partire da un prompt.
  • Reazione: avvia un'altra reazione, con l'opzione di attendere che finisca.

Vocale, GIF, videomessaggio e carosello funzionano nelle reazioni come gli altri blocchi e sono compresi nell'invio rapido di una reazione; vedi Invii massivi.

Puoi trascinare i blocchi per riordinarli. La modalità è In ordine o Casuale per risposte variabili. Il menu principale del bot può essere lasciato invariato, impostato o nascosto.

Opzioni del blocco

Per testo e media puoi attivare: fissa in alto, senza suono, proteggi dall'inoltro, spoiler, senza anteprima dei link, elimina automaticamente dopo N secondi.

Pulsanti inline

Per ogni blocco scegli Testo del pulsante e Tipo di pulsante:

  • Testo: invia la scritta come risposta dell'utente. In Telegram e VK appare come tastiera di risposta e può rispondere a una domanda o avviare una reazione testuale. WhatsApp, Instagram, Messenger e widget web usano un pulsante di risposta senza tastiera permanente.
  • Link: apre un URL.
  • Web app: apre una Telegram Mini App. Vedi Mini App.
  • Reazione: avvia un'altra reazione quando viene premuto.
  • Inline query: inserisce «@bot query» nel campo di testo della chat corrente o propone di scegliere un'altra chat (switch_inline_query/switch_inline_query_current_chat). È disponibile solo in Telegram dopo l'attivazione della modalità inline con /setinline in @BotFather. GetMyBot non risponde a queste query (answerInlineQuery non è implementato): il pulsante prepara il testo, ma non esegue la ricerca.
  • Prefilled text: link https://t.me/<bot>?text=… che apre la chat del bot e inserisce il testo nel campo, senza inviarlo (prefill).
  • Payment link: apre un URL di pagamento obbligatorio. Il pagamento viene creato prima con l'azione «Crea pagamento». È una pagina esterna, non una fattura nativa di Telegram.
  • Notifica: mostra un testo al clic senza avviare reazioni né trasferire i dati Carry. In Telegram è un breve avviso o una finestra fino a 200 caratteri; in VK una notifica breve fino a 90 caratteri, senza finestra.

Risposta testuale o testo preparato

ObiettivoTipo e impostazioneRisultato del clic
Scegliere «Sì» in un questionarioTesto, etichetta «Sì», mentre il messaggio attende una risposta«Sì» arriva al passo del dialogo
Preparare una richiestaPrefilled text, etichetta «Scrivi», testo «Vorrei ordinare»La bozza compare nella chat del bot; la persona può modificarla e inviarla

Il testo sul pulsante e quello preparato sono campi diversi. La bozza non invia un messaggio né avvia una reazione da sola.

Reazione invia al bot un evento separato quando premi il pulsante: è un callback. Inline query e Prefilled text agiscono invece nell'app Telegram e non generano quel callback. Non supportano quindi answerCallbackQuery o dati Carry.

Icona e colore del pulsante

Puoi mostrare un'emoji Premium prima del testo, inserendo il suo ID (icon_custom_emoji_id), un intero positivo a 64 bit. 007 viene letto come 7. Lettere, zero, numeri negativi o troppo grandi vengono ignorati: il pulsante si salva senza icona.

Telegram mostra l'icona soltanto se il bot ha i permessi richiesti: un nome utente aggiuntivo ottenuto tramite Fragment oppure Telegram Premium del proprietario per l'invio diretto in chat privata o gruppo. Negli altri casi Telegram ignora l'icona senza sostituirla con un'emoji normale.

Lo Stile del pulsante (style) determina il colore: Normale senza colore, Principale blu, Successo verde, Pericoloso rosso.

Monouso (brucia dopo la pressione) (single_use) permette di usare i dati salvati nel pulsante una sola volta, per esempio per confermare una scelta. Il cambio dell'etichetta e l'eliminazione del messaggio si configurano separatamente nel comportamento al clic.

Opzioni dei pulsanti

I flag sono opzioni da attivare nell'editor:

  • Su nuova riga: sposta il pulsante nella riga successiva.
  • Estendi a tutta la larghezza: lo mette da solo in una riga; anche il pulsante seguente inizia una nuova riga.

Le parentesi quadre qui indicano pulsanti:

Una riga:          [Catalogo] [Aiuto]

Nuova riga:        [Catalogo]
                   [Aiuto]

Tutta larghezza:   [         Aiuto         ]

Righe e colori sono disponibili in Telegram e VK. La disposizione resta memorizzata dopo la riapertura e la modifica. Le emoji Premium funzionano solo con un collegamento Telegram adatto. Non esiste un'impostazione efficace per «Apri all'interno di Telegram»: la Bot API non consente di controllarlo con questo flag.

Limiti dei canali

Seleziona il collegamento del blocco o del singolo pulsante. Con «Tutti i canali» l'editor usa solo le capacità comuni; non puoi salvare un tipo non supportato.

  • Telegram: URL, Mini App, reazioni, notifiche o alert, righe, colori e emoji personalizzate se il bot ha i permessi.
  • VK: URL, reazioni, notifiche brevi (snackbar), righe e colori. VK Mini App e VK Pay richiedono un collegamento VK compatibile.
  • WhatsApp: un solo pulsante CTA con URL, senza altri pulsanti nello stesso messaggio. Fino a 3 normali pulsanti di risposta; da 4 a 10 appaiono come elenco. Testo fino a 20 caratteri. Niente righe, colori, Mini App o notifiche.
  • Instagram / Messenger: l'adattatore attuale invia solo pulsanti di risposta (quick replies), con testo fino a 20 caratteri. Non supporta URL, Mini App, notifiche, righe o colori.
  • Widget web: URL e pulsanti di risposta, senza righe, colori o notifiche.
  • Email: link, compresi quelli di pagamento; niente pulsanti di risposta o notifiche.

Per i pulsanti generati da una lista puoi scegliere le colonne solo nei canali che supportano le righe. Negli altri decide il canale. Quantità di pulsanti e lunghezza delle etichette vengono controllate all'invio.

Comportamento al clic

Per i pulsanti che inviano il clic al bot, puoi sostituire il messaggio con testo o con quello di un'altra reazione, eliminarlo, aggiungere un'etichetta o salvare un parametro, se il canale lo permette. Solo Telegram può modificare il testo del pulsante premuto, per esempio da «Iscriviti» a «Selezionato». Il supporto di VK per la modifica dei messaggi non include il testo del pulsante.

Telegram attende una conferma dal bot, answerCallbackQuery. Di solito GetMyBot la invia da solo e toglie l'indicatore di caricamento. Salta answerCallbackQuery disattiva questa conferma.

Nel campo Text on press (notification) di un pulsante Reazione puoi inserire una conferma breve, come «Corso selezionato» (Telegram: massimo 200 caratteri; VK: 90; le sostituzioni funzionano). Telegram la mostra per poco sopra la chat. Show as a popup (alert) è disponibile solo in Telegram e apre una finestra usando show_alert in answerCallbackQuery. Se il campo è vuoto, il bot toglie soltanto l'indicatore. Se salti answerCallbackQuery, non vengono inviati né testo né finestra.

Dati del pulsante (Carry)

Carry permette al pulsante di ricordare a quale oggetto si riferisce. Un cappotto e un vestito possono avere entrambi il pulsante «Compra». Salva product_id=101 per il cappotto e product_id=102 per il vestito. Premendo il secondo, la reazione successiva riceve {{ctx.product_id}} con valore 102.

Nell'editor la sezione si chiama Dati inviati al clic. La chiave dà un nome al valore, che può essere numero, testo o sostituzione. Il bot lo registra quando invia il messaggio e lo mette nel contesto temporaneo (ctx) al clic. Ogni pulsante conserva i propri dati.

La validità (ttl_seconds, TTL) si misura in secondi: 3600 è un'ora. 0 usa i 30 giorni predefiniti. Dopo la scadenza i dati non sono più disponibili. Monouso (brucia dopo la pressione) (single_use) li rimuove già al primo clic. Un prezzo salvato non cambia quando aggiorni il catalogo: prima di incassare controlla il prezzo corrente tramite l'ID prodotto.

Configurazione guidata e differenza dai parametri permanenti: Pulsanti dinamici e parametri.

Pulsanti dinamici

Se prodotti o lezioni sono in un elenco, non creare i pulsanti a mano. Pulsanti dinamici da lista ne genera uno per elemento. Indica la lista in ctx, l'alias di un elemento, il numero di pulsanti per riga e il modello del testo. Per esempio, {{item.name}} inserisce il nome del prodotto corrente. Vedi Pulsanti dinamici e parametri.

Emoji Premium nel testo

Nel blocco di testo, il pulsante di formattazione Emoji Premium inserisce <tg-emoji emoji-id="…">🙂</tg-emoji>. Chi ha Telegram Premium vede l'emoji personalizzata, gli altri vedono l'emoji normale all'interno del tag. Funziona sia nei blocchi HTML sia in quelli Markdown. L'ID dell'emoji è un numero di massimo 32 cifre: puoi ottenerlo con getCustomEmojiStickers oppure inoltrando un messaggio con quell'emoji a un bot come @idstickerbot.

Il link t.me/<bot>?start=<parametro> avvia il comando /start <parametro> in Telegram. Non permette di aprire la chat con un parametro senza eseguire /start. Scegli l'opzione adatta:

  • Un /start silenzioso: nella reazione con trigger Comando /start e il valore desiderato in Etichetta nel link di avvio, puoi lasciare senza blocchi l'azione Invia messaggio. L'utente non riceve una risposta visibile a /start, mentre il valore dell'etichetta è già nel contesto dell'evento e può essere usato nelle condizioni e nelle altre azioni della stessa reazione.
  • Testo precompilato: il link https://t.me/<bot>?text=<testo> (pulsante Prefilled text o normale pulsante con link) apre la chat e inserisce il testo nel campo di scrittura, senza inviarlo. /start non viene eseguito: è l'utente a inviare il messaggio.
  • Messaggio automatico a nome dell'utente: la Bot API non lo consente. Il bot non può inviare messaggi a nome di una persona. La soluzione più vicina è un deep link con ?start= e una reazione che risponde con un messaggio del bot.

Risposta attesa (passi della conversazione)

Un blocco di testo può attendere la risposta dell'utente. Il messaggio diventa così un passo della conversazione e il percorso si ferma finché arriva la risposta. Più passi consecutivi formano un questionario direttamente in chat.

Tipo di contenuto atteso

Il bot può aspettare un tipo preciso: testo, scelta fra opzioni (pulsanti), foto, video, videomessaggio circolare, audio, documento, messaggio vocale, posizione, contatto, calendario o dado. Se la persona invia un altro tipo di contenuto, la risposta non viene accettata per quel passo.

Verifica del testo

Per una risposta testuale puoi richiedere un numero di telefono, un indirizzo email, un link, una data, un'ora oppure la verifica tramite formula. Per esempio, se attendi un numero di telefono, un testo qualsiasi viene respinto con un messaggio di errore. La verifica usa una formula estesa: deve restituire un testo vuoto quando la risposta è valida, oppure il testo dell'errore quando non lo è.

Salvataggio della risposta

Puoi salvare la risposta in un parametro. In seguito sarà disponibile nelle sostituzioni come {{param.chiave}} e nelle condizioni. In questo modo, i passi della conversazione raccolgono i dati del cliente.

Errori, promemoria e scadenza dell'attesa

  • Messaggio di errore: cosa mostrare se la risposta non supera la verifica.
  • Promemoria: cosa inviare se l'utente non risponde.
  • Scadenza dell'attesa: dopo quanto tempo smettere di attendere. Alla scadenza puoi avviare una reazione, per esempio per chiudere il questionario. Nei collegamenti tra reazioni questa appare come «Scadenza dell'attesa», mentre la reazione avviata dalla risposta appare come «Risposta attesa».

Uscita dal passo con un comando

/cancel o la parola «отмена» annullano l'attesa e rispondono «Отменено.»; se è configurata una reazione di annullamento, viene avviata quella. Gli altri comandi, per impostazione predefinita, vengono trattati come normali risposte e sottoposti alla verifica. Se attivi I comandi del bot (per esempio /start) interrompono l'attesa (escape_on_command), qualsiasi comando, per esempio /start durante un questionario, interrompe l'attesa senza un messaggio e viene eseguito normalmente.

Sostituzioni

Il pulsante Sostituzioni inserisce i valori nei messaggi: dati del mittente ({{first_name}}, {{username}}, {{user_id}}), dell'evento ({{text}}, {{chat_id}}, {{datetime}}) e parametri ({{param.chiave}}). Elenco completo e formule: Sostituzioni e formule.

Pulsante del menu del bot

L'azione Menu button permette di scegliere il normale menu del bot, i comandi oppure un pulsante Mini App con testo e URL. Puoi applicarla solo alla chat corrente oppure all'impostazione generale del bot. Per esempio, puoi mostrare una Mini App personalizzata a un solo cliente. La disponibilità dipende dal canale.

Passi successivi