Canaux : Telegram, WhatsApp, VK
Connectez Telegram, WhatsApp et VK à un même projet. Découvrez les fonctions propres à chaque canal et le trajet des réponses.
Sur cette page
Un projet GetMyBot peut répondre dans Telegram, WhatsApp et VK. Par exemple, une même réaction présentant les horaires des cours peut fonctionner dans les trois messageries. La réponse repart dans celle où la personne a écrit.
Les plateformes n'acceptent pas toutes les mêmes boutons et actions. Vérifiez ces différences avant de lancer votre bot sur un autre canal.
Qu'est-ce qu'un canal ?
Un canal est une connexion à un lieu d'échange précis : un bot Telegram, un numéro WhatsApp Business ou une communauté VK. Un projet GetMyBot peut réunir plusieurs canaux. Les réactions sont communes : si une personne écrit sur WhatsApp, son message est traité par les mêmes règles que sur Telegram, puis la réponse est envoyée sur WhatsApp.
Les boutons, la mise en forme et les actions varient selon la plateforme. L'éditeur peut masquer un réglage non pris en charge ou utiliser une autre présentation possible. Vérifiez le message dans chaque canal connecté avant sa mise en service.
Canal principal (primary_channel)
Chaque bot possède un canal principal (primary_channel), celui auquel il est d'abord associé. C'est souvent Telegram, mais vous pouvez créer directement un projet pour WhatsApp ou VK, sans Telegram. Le canal principal est défini à la création et apparaît dans la liste des projets ; vous pouvez ajouter d'autres canaux ensuite.
Fonctions disponibles selon le canal
La liste technique à jour est disponible via GET /api/channels/capabilities.
Telegram offre les boutons intégrés au message et le clavier de réponse, les clics qui déclenchent une réaction (callback), les réactions par emoji, les liens de démarrage /start, la modification, la suppression et le transfert de messages, la réponse à un message comme déclencheur, les événements des membres, les droits et la modération. Les cartes d'un carrousel photo se parcourent avec des boutons dans un même message. Mise en forme : Plain, HTML et Markdown. Les modèles WhatsApp, listes et fenêtres de session ne s'y appliquent pas.
WhatsApp, via WhatsApp Cloud API, offre les boutons intégrés au message, les callbacks, les réactions par emoji, les liens /start, les modèles de messages, les listes interactives et une fenêtre de conversation de 24 heures. Mise en forme : Plain ou Markdown. Pas de clavier de réponse, de modification, suppression ou transfert des messages, de réponse comme déclencheur, d'événements des membres, de modération ni de carrousel parcouru dans un même message. Consultez WhatsApp.
VK prend en charge les messages et pièces jointes, les boutons intégrés et le clavier de réponse, les callbacks, les réactions par emoji, les liens /start, la modification, la suppression et le transfert de messages, ainsi que les événements des membres. On peut bannir ou débannir une personne et approuver une demande d'adhésion déjà déposée dans une communauté privée. Les abonnements payants VK Donut produisent aussi des événements. Seul le texte brut est conservé : HTML et Markdown sont supprimés lors de l'affichage. VK n'a ni modèles WhatsApp, ni listes, carrousel parcouru dans un même message ou fenêtre de session.
Tous les canaux ont en commun les boutons intégrés au message, les callbacks, les réactions par emoji et les liens /start. Le bloc de carrousel photo est disponible sur les canaux qui acceptent les photos. Sur Telegram, ses cartes se parcourent dans un même message si chaque photo dispose d'un identifiant de fichier utilisable. Sur WhatsApp et VK, ainsi que sur Telegram si ces identifiants ne peuvent pas être obtenus, les cartes sont envoyées comme des photos séparées. Consultez Messages et boutons.
VK Donut
Si une communauté utilise VK Donut, le bot reçoit les événements de ses abonnements payants :
| Événement dans l'éditeur | Clé | Variables disponibles |
|---|---|---|
| VK Donut: subscription created | donut_subscription_created | {{event.donut_amount}}, {{event.donut_amount_without_fee}} |
| VK Donut: subscription prolonged | donut_subscription_prolonged | {{event.donut_amount}}, {{event.donut_amount_without_fee}} |
| VK Donut: subscription expired | donut_subscription_expired | Aucune |
| VK Donut: subscription cancelled | donut_subscription_cancelled | Aucune |
{{event.donut_amount}} indique le montant payé ; {{event.donut_amount_without_fee}}, le montant hors commission VK. Les événements d'expiration et d'annulation ne donnent aucun montant. La fin d'une période payée ne constitue pas un nouveau paiement : y ajouter le montant précédent serait trompeur.
Ces événements concernent l'abonné, pas un message qu'il a envoyé. Ils n'ouvrent donc pas un dialogue pour des messages privés, ne lèvent pas un blocage, ne modifient pas sa dernière activité et n'augmentent pas le compteur de messages. Si cet abonné n'existe pas encore dans GetMyBot, il est créé pour que ses étiquettes et ses droits puissent être gérés.
Exemple de club réservé aux abonnés :
- Sur VK Donut: subscription created, et de même sur subscription prolonged, ajoutez l'action Modifier les étiquettes pour attribuer « Club » avec
ttl_days= 31. Envoyez aussi le lien vers la communauté privée et invitez la personne à demander son adhésion. - Approuvez la demande après qu'elle a été déposée. Modifier les droits → Approuver la demande d’adhésion accepte une demande déjà existante (
groups.approveRequest). Créez une réaction ultérieure, par exemple sur un bouton « J'ai envoyé ma demande » ou sur le prochain événement subscription prolonged. Sans demande, rien ne peut être approuvé. - Sur Label expired (
label_expired), utilisez Modifier les droits → Exclure. La personne quitte alors le club quand l'étiquette expire, même si VK n'envoie pas d'événement d'expiration de l'abonnement. Consultez Déclencheurs → Étiquette expirée. - Sur VK Donut: subscription cancelled ou subscription expired, utilisez Modifier les étiquettes pour retirer « Club » et, si nécessaire, Exclure immédiatement.
Pour VK, le champ Chat (chat_id) d'une action qui modifie les droits doit contenir l'ID numérique de la communauté connectée, celui qu'affiche la liste des canaux. VK ne peut gérer que les membres de cette communauté. Si vous indiquez un autre ID, l'action est rejetée avant l'envoi à VK. Connectez l'autre communauté comme canal distinct si vous devez aussi la gérer.
Pour recevoir ces événements :
- Long Poll : le bot s'y abonne automatiquement à la connexion du canal et à chaque démarrage de la plateforme. Une communauté déjà connectée n'a rien à modifier.
- Callback API : dans les réglages de la communauté, ouvrez Travail avec l'API → Callback API → Types d'événements → VK Donut et activez les quatre événements du tableau.
Connecter un canal
Les canaux s'ajoutent depuis Projets.
- Ouvrez Projets et trouvez le projet concerné.
- Cliquez sur Ajouter un canal dans sa fiche.
- Choisissez Telegram, WhatsApp ou VK.
- Saisissez les informations demandées : token pour Telegram, identifiants Meta pour WhatsApp ou identifiants de la communauté pour VK.
- Cliquez sur Valider : GetMyBot vérifie les informations auprès de la plateforme.
- Cliquez sur Connecter.
Une fois un canal WhatsApp ou VK connecté, l'icône 🔗 permet d'afficher son adresse de webhook. Enregistrez cette adresse auprès de Meta pour WhatsApp ou dans les réglages de la communauté pour VK, afin que les événements arrivent au bot. Pour WhatsApp, consultez Configuration du webhook.
Pour continuer
- WhatsApp : connexion, webhook, fenêtre de conversation et modèles de messages.
- Projets et canaux : première connexion d'un bot.
- Réactions : les bases : règles communes à tous les canaux.
Identifiants du canal
Telegram utilise le token complet fourni par BotFather. Pour VK, il faut le token et l'ID numérique de la communauté ; Callback API demande aussi une chaîne secrète et un code de confirmation. Pour WhatsApp, indiquez le Phone Number ID, l'ID du compte WhatsApp Business, un token autorisé à utiliser ce compte, le Verify Token du webhook et l'App Secret de l'application Meta.
Vérifiez les valeurs avant de connecter le canal. Si vous changez une clé, modifiez aussi la configuration correspondante chez le fournisseur. Le Verify Token valide l'adresse du webhook et l'App Secret vérifie la signature des événements reçus ; aucun ne remplace le token d'accès à l'API.
Événements entrants et adresses de webhook
Pour VK Callback API, enregistrez l'adresse affichée par MyBot dans les réglages du serveur de la communauté et utilisez la même chaîne secrète et le même code de confirmation. Long Poll n'a besoin ni d'adresse publique ni de ces deux valeurs. Pour WhatsApp, enregistrez l'adresse dans votre application Meta, utilisez le même Verify Token et abonnez-vous aux événements de messages nécessaires. Des identifiants permettant d'envoyer des messages ne suffisent pas à recevoir les événements.
Autoriser Instagram et Messenger
L'assistant de connexion ouvre l'autorisation Meta. Connectez-vous avec un compte qui administre la Page Facebook ou le compte Instagram professionnel souhaité, accordez les droits demandés, puis choisissez les comptes à ajouter au projet. L'assistant vérifie les droits, l'abonnement au webhook et la disponibilité des messages ; corrigez toute vérification en échec avant d'utiliser le canal. Vous pouvez revoir la sélection des comptes dans une connexion existante.