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'editor | Chiave | Variabili 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_expired | nessuna |
| VK Donut: subscription cancelled (annullamento) | donut_subscription_cancelled | nessuna |
{{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.
- 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. - 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. - 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. - 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.
- Apri Progetti e trova il progetto.
- Premi Aggiungi canale nella scheda del progetto.
- Scegli Telegram, WhatsApp o VK.
- Inserisci le credenziali: token per Telegram, credenziali Meta per WhatsApp o credenziali della community per VK.
- Premi Verifica: la piattaforma controlla le credenziali presso il servizio scelto.
- 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
- WhatsApp: collegamento, webhook, finestra di sessione e modelli di messaggio.
- Progetti e canali: collegamento iniziale del bot.
- Reazioni: le basi: comportamento comune a tutti i canali.
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.