Knowledge base GetMyBot

Canali: Telegram, WhatsApp, VK

Come collegare Telegram, WhatsApp e VK a un progetto. Differenze tra i canali e destinazione delle risposte del bot.

In questa pagina

Un progetto GetMyBot può rispondere su Telegram, WhatsApp e VK. Per esempio, puoi usare la stessa regola per comunicare gli orari di un corso in tutti e tre. La risposta torna nel canale da cui la persona ha scritto.

Quando aggiungi un altro servizio di messaggistica, controlla pulsanti e azioni: le piattaforme offrono funzioni diverse. Qui trovi le differenze e i passaggi per collegarle.

Che cos'è un canale

Un canale è una piattaforma collegata per lo scambio di messaggi: uno specifico bot Telegram, un numero WhatsApp Business o una community VK. Un progetto GetMyBot può avere più canali. Le reazioni sono comuni: quando una persona scrive su WhatsApp, il messaggio segue le stesse reazioni usate per Telegram e la risposta torna su WhatsApp.

Non tutti i canali supportano gli stessi pulsanti, formati e azioni. L'editor può nascondere un'opzione non supportata o convertirla in una disponibile. Prima di avviare il bot, prova i messaggi su ciascun canale collegato.

Canale principale (primary_channel)

Ogni bot ha un canale principale (primary_channel), la piattaforma con cui è associato per prima cosa. Di solito è Telegram, ma puoi creare direttamente un bot WhatsApp o VK senza collegare Telegram. Il canale principale si definisce alla creazione ed è visibile nell'elenco dei bot; gli altri si aggiungono in seguito.

Funzioni disponibili per canale

Ecco le funzioni supportate da ciascuna piattaforma. La matrice aggiornata in formato leggibile da un programma è disponibile da GET /api/channels/capabilities.

Telegram: il canale di riferimento con tutte le funzioni: pulsanti inline e tastiera di risposta, callback (clic sul pulsante che avvia una reazione), reazioni emoji, deep link /start, modifica, eliminazione e inoltro di messaggi, risposta a un messaggio come trigger, eventi dei membri, permessi e moderazione. Le schede del carosello fotografico scorrono tramite pulsanti in un unico messaggio. Formati del testo: Plain / HTML / Markdown. Non ha modelli di messaggio, liste o finestra di sessione, che in Telegram non servono.

WhatsApp (tramite WhatsApp Cloud API): pulsanti inline, callback, reazioni emoji, deep link /start, modelli di messaggio, liste (interactive list) e finestra di sessione di 24 ore. Formati: Plain / Markdown. Non supporta la tastiera di risposta, la modifica, l'eliminazione o l'inoltro di messaggi, la risposta come trigger, gli eventi dei membri, i permessi, la moderazione o lo scorrimento del carosello in un unico messaggio. Leggi WhatsApp per i dettagli.

VK: messaggi e allegati, pulsanti inline e tastiera di risposta, callback, reazioni emoji, deep link /start, modifica, eliminazione e inoltro di messaggi, eventi dei membri, blocco e sblocco, approvazione di una domanda d'ingresso già inviata a una community chiusa ed eventi degli abbonamenti a pagamento VK Donut. Il testo è solo semplice: HTML e Markdown vengono rimossi durante la visualizzazione. VK non ha i modelli WhatsApp, le liste, lo scorrimento del carosello in un unico messaggio o la finestra di sessione.

Tutti i canali supportano pulsanti inline, callback, reazioni emoji e deep link /start. Il blocco del carosello fotografico è disponibile nei canali che supportano le foto. In Telegram le schede scorrono in un unico messaggio se tutte le foto hanno identificatori di file adatti. In WhatsApp e VK, e in Telegram se mancano questi identificatori, ogni scheda viene inviata come messaggio fotografico separato. Consulta Messaggi e pulsanti.

VK Donut

Se nella community è attivo VK Donut, il bot riceve questi eventi di sistema relativi agli abbonamenti a pagamento:

Evento nell'editorChiaveVariabili disponibili
VK Donut: subscription created (nuovo abbonamento)donut_subscription_created{{event.donut_amount}}, {{event.donut_amount_without_fee}}
VK Donut: subscription prolonged (rinnovo)donut_subscription_prolonged{{event.donut_amount}}, {{event.donut_amount_without_fee}}
VK Donut: subscription expired (scadenza)donut_subscription_expirednessuna
VK Donut: subscription cancelled (annullamento)donut_subscription_cancellednessuna

{{event.donut_amount}} è l'importo pagato; {{event.donut_amount_without_fee}} è l'importo al netto della commissione VK. Gli eventi di scadenza e annullamento non hanno importi: la fine del periodo pagato non indica una nuova transazione, quindi non va mostrato l'importo di un pagamento precedente.

Questo è un evento riferito all'abbonato, non un suo messaggio. Non rende quindi disponibile la chat privata, non rimuove un blocco, non aggiorna l'ultima attività e non aumenta il contatore dei messaggi: un addebito sulla carta non equivale a un messaggio inviato dalla persona. Se la piattaforma non conosce ancora l'abbonato, crea il suo profilo per poter applicare etichette e permessi.

Esempio: un club riservato agli abbonati.

  1. Crea una reazione per VK Donut: subscription created e una uguale per VK Donut: subscription prolonged. Aggiungi l'azione Modifica etichette per assegnare «Club» con ttl_days = 31. Invia anche il link alla community privata e chiedi di presentare domanda d'ingresso.
  2. Approva la domanda solo dopo che l'abbonato l'ha inviata. L'azione Modifica permessi → Approva richiesta di ingresso accetta una domanda già inviata (groups.approveRequest); senza domanda, non c'è nulla da approvare. Metti l'azione in una reazione successiva al passo 1, per esempio sul pulsante «Ho inviato la domanda» sotto lo stesso messaggio o sul prossimo evento di rinnovo.
  3. Al trigger Label expired (label_expired), aggiungi Modifica permessi → Espelli. La persona esce dal club alla scadenza dell'etichetta, indipendentemente dall'arrivo dell'evento VK «subscription expired». Vedi Trigger → Etichetta scaduta.
  4. Per VK Donut: subscription cancelled e VK Donut: subscription expired, aggiungi Modifica etichette → rimuovi «Club» e, se serve, Espelli immediatamente.

Il campo Chat (chat_id) delle azioni di gestione dei permessi VK deve contenere l'ID della community collegata, lo stesso numero mostrato nella scheda del canale VK. VK può gestire i membri solo di quella community. Un altro ID viene rifiutato prima dell'invio a VK. Per gestire un'altra community, collegala come canale distinto.

Come attivare gli eventi:

  • Long Poll: il bot si iscrive da sé agli eventi quando colleghi il canale e a ogni avvio della piattaforma. Non devi intervenire sulle community già collegate.
  • Callback API: nelle impostazioni della community VK apri Работа с API → Callback API → Типы событий → VK Donut e abilita tutti e quattro gli eventi della tabella.

Collegare un canale

I canali si aggiungono dalla pagina Progetti.

  1. Apri Progetti e trova il progetto.
  2. Premi Aggiungi canale nella scheda del progetto.
  3. Scegli Telegram, WhatsApp o VK.
  4. Inserisci le credenziali: token per Telegram, credenziali Meta per WhatsApp o credenziali della community per VK.
  5. Premi Verifica: la piattaforma controlla le credenziali presso il servizio scelto.
  6. Premi Connetti.

Per WhatsApp e VK, dopo il collegamento compare un indirizzo webhook (icona 🔗). Devi registrarlo sulla piattaforma esterna, nell'app Meta per WhatsApp o nelle impostazioni della community per VK, così gli eventi in arrivo raggiungono il bot. Per WhatsApp, consulta Configurazione del webhook.

Prossimi passi

Credenziali del canale

Telegram usa il token completo di BotFather. Per VK servono il token e l'ID numerico della community; per Callback API servono anche la stringa segreta e il codice di conferma. Per WhatsApp servono Phone Number ID, ID dell'account WhatsApp Business, token con accesso all'account, Verify Token del webhook e App Secret dell'app Meta.

Controlla questi dati prima del collegamento. Quando cambi una chiave, aggiorna anche l'impostazione corrispondente presso il provider: Verify Token conferma l'indirizzo del webhook; App Secret verifica la firma degli eventi in arrivo. Nessuno dei due sostituisce il token di accesso API.

Eventi in arrivo e indirizzi webhook

Per VK Callback API, registra l'indirizzo mostrato da MyBot nelle impostazioni del server della community e inserisci gli stessi valori per segreto e codice di conferma. Long Poll non richiede un indirizzo pubblico né quei due valori. Per WhatsApp, registra l'indirizzo nell'app Meta, inserisci lo stesso Verify Token e iscriviti agli eventi dei messaggi necessari. Le sole credenziali per l'invio non bastano a ricevere i messaggi.

Autorizzazione di Instagram e Messenger

La procedura guidata di collegamento apre l'autorizzazione Meta. Accedi con l'account che gestisce la pagina Facebook o l'account Instagram professionale, concedi i permessi richiesti e scegli gli account da collegare al progetto. La procedura controlla i permessi, l'iscrizione al webhook e la disponibilità all'invio; risolvi i controlli falliti prima di usare il canale. Puoi rivedere gli account selezionati anche dopo il collegamento.