Documentation publique

Construisez des bots no-code pour Telegram, WhatsApp et vos parcours clients. Un Studio Canvas généraliste, avec IA, paiements et templates métier.

Guide complet pour comprendre JoinGate : Studio Canvas multi-canaux, templates métier, Telegram stable, WhatsApp GoWA beta, API officielle Meta, paiements Mobile Money, crédits IA, quotas, webhooks et bonnes pratiques de publication.

9
types de blocs canvas
2
canaux actifs : Telegram, WhatsApp
FR/EN
messages bilingues
24/7
bots automatisés
Bot flow preview
Live
Message
Bienvenue {{client_name}}
Menu
buy_subscription · faq · support
Tag
lead → vip
Webhook
POST /payment.validated

Studio Canvas no-code

Canvas drag-and-drop, prévisualisation par canal, versioning et publication progressive.

Marketplace templates

Templates gratuits ou premium pour e-commerce, coaching, formation, restaurant, support, communauté VIP ou services.

Canaux Telegram & WhatsApp

Telegram reste stable ; WhatsApp GoWA et Meta officiel sont branchés derrière feature flags.

IA à l’usage

Crédits IA pour analyse reçus, génération de parcours, FAQ, support assisté et contenus métier.

Vue d’ensemble

Ce que JoinGate automatise

La base produit pour comprendre les bots no-code, canaux, parcours, paiements, accès et support.

3 min

JoinGate transforme vos canaux de messagerie en assistants no-code capables de vendre, qualifier, supporter, encaisser et automatiser. Telegram est le canal stable historique ; WhatsApp est disponible progressivement via GoWA beta et l’API officielle Meta ; le modèle est pensé pour devenir multi-canaux.

  • Bot / assistant généraliste créé dans le Studio Canvas sans code.
  • Canaux actifs : Telegram stable, WhatsApp GoWA beta et WhatsApp API officielle Meta. Webchat est reporté.
  • Templates métier pour e-commerce, coaching, formation, restaurant, support client, communauté VIP ou agence.
  • Paiements Mobile Money, cartes, virements et instructions de paiement par canal selon vos providers.
  • CRM, conversations, support, abonnements, quotas, add-ons et crédits IA centralisés.

La documentation publique explique le produit et les conventions. La documentation dashboard reste réservée aux utilisateurs connectés.

Fonctionnalités

Tout ce que JoinGate couvre

Vue simple des modules disponibles pour créer, vendre, automatiser et gérer plusieurs canaux.

6 min

JoinGate ne se limite plus à un bot Telegram. La plateforme couvre le cycle complet : création d’assistants no-code, choix du canal, parcours canvas, paiement, accès, support, relance, CRM, quotas et pilotage SaaS.

Module
Bots / Assistants
Utilité
Créer un bot no-code généraliste
Exemple d’usage
Assistant e-commerce, coach, support, communauté ou agence
Module
Canaux
Utilité
Connecter Telegram ou WhatsApp
Exemple d’usage
Telegram stable, WhatsApp GoWA beta, API officielle Meta
Module
Studio Canvas
Utilité
Créer un parcours sans code
Exemple d’usage
Accueil → Menu → Paiement → Support → Relance
Module
Templates
Utilité
Démarrer plus vite
Exemple d’usage
Template e-commerce, coaching, formation, restaurant, support, communauté VIP
Module
Groupes Telegram
Utilité
Gérer les accès privés
Exemple d’usage
Importer les membres existants puis automatiser les retraits
Module
Offres
Utilité
Vendre des durées différentes
Exemple d’usage
Mensuel, trimestriel, annuel, accès spécial
Module
Paiements
Utilité
Contrôler les reçus
Exemple d’usage
Valider un reçu Wave ou demander une preuve plus claire
Module
Clients & prospects
Utilité
Transformer les membres en clients
Exemple d’usage
Activer 40 prospects payants en une action
Module
Abonnements
Utilité
Corriger et prolonger les accès
Exemple d’usage
+7 jours, changer offre, suspendre, réactiver
Module
FAQ & Support
Utilité
Répondre rapidement
Exemple d’usage
FAQ dans le bot et tickets support dans le dashboard
Module
WhatsApp
Utilité
Tester GoWA ou Meta officiel
Exemple d’usage
QR GoWA, templates Meta approuvés, opt-in/opt-out, quotas
Module
CRM & Broadcasts
Utilité
Cibler les messages
Exemple d’usage
Envoyer une relance aux clients expirés
Module
Rapports
Utilité
Suivre la performance
Exemple d’usage
Revenus, abonnements actifs, paiements en attente
Module
Billing & IA
Utilité
Gérer plan, add-ons, quotas WhatsApp et crédits IA
Exemple d’usage
Acheter des crédits ou packs de messages WhatsApp Meta

Pour un lancement simple : choisissez le canal principal, créez le bot, préparez une offre, ajoutez un moyen de paiement, construisez le Studio Canvas, prévisualisez sur le canal cible, puis publiez progressivement.

Démarrage

Créer et publier un premier bot

Le chemin simple : compte, canal, template métier, personnalisation, preview, publication.

5 min
  1. 1Créez un compte JoinGate et nommez votre organisation.
  2. 2Choisissez le canal de départ : Telegram stable pour production, WhatsApp GoWA beta pour test QR, ou WhatsApp Meta officiel si vos accès Meta sont prêts.
  3. 3Pour Telegram, créez un bot via BotFather puis collez le token dans Dashboard → Bot.
  4. 4Pour WhatsApp, ouvrez Dashboard → Canaux → WhatsApp, configurez GoWA ou Meta, puis testez l’envoi.
  5. 5Ouvrez Bot Builder → Templates, choisissez un template adapté à votre activité.
  6. 6Personnalisez le canvas : messages FR/EN, menus, offres, paiement, FAQ et support.
  7. 7Sauvegardez, prévisualisez le rendu du canal cible, puis publiez progressivement.

Un template acheté ou gratuit crée un flow brouillon. L’utilisateur arrive directement dans l’éditeur, sans écran vide. Telegram reste le canal de production le plus stable ; WhatsApp doit être activé et testé progressivement.

Guides métier

Créer des bots généralistes sans code

Guides simples pour créer un bot en 10 minutes, e-commerce, WhatsApp, support, réservation ou communauté VIP.

10 min

Créer un bot en 10 minutes

  1. 1Choisissez l’objectif : vendre, réserver, qualifier un lead, répondre au support ou gérer une communauté.
  2. 2Choisissez le canal actif : Telegram stable ou WhatsApp opérationnel en beta contrôlée. Webchat est reporté.
  3. 3Sélectionnez un template métier dans Bot Builder → Templates.
  4. 4Connectez le canal : token BotFather pour Telegram, GoWA QR ou Meta officiel pour WhatsApp.
  5. 5Personnalisez le Studio Canvas : accueil, menu, collecte d’informations, offre, paiement, support.
  6. 6Testez avec la preview du canal cible puis publiez progressivement.
Cas
Bot e-commerce
Template conseillé
E-commerce
Parcours exemple
Accueil → Catégorie → Produit → Paiement → Suivi commande → Support
Cas
Bot support client
Template conseillé
Support client
Parcours exemple
FAQ → Qualification problème → Ticket → Transfert humain
Cas
Bot réservation
Template conseillé
Restaurant, coaching ou événement
Parcours exemple
Choix créneau → Coordonnées → Acompte → Confirmation
Cas
Bot Telegram communauté VIP
Template conseillé
Communauté VIP
Parcours exemple
Offre abonnement → Paiement → Accès groupe → Rappel renouvellement
Cas
Bot WhatsApp
Template conseillé
Tout template Telegram/WhatsApp
Parcours exemple
Opt-in → Menu court → Paiement/support → Logs et quotas
Cas
Bot webchat
Template conseillé
Reporté
Parcours exemple
Le modèle est prévu, mais non activé dans l’interface actuelle

Variables disponibles

  • Client : {{first_name}}, {{last_name}}, {{email}}, {{phone}} selon les données collectées.
  • Commerce : {{product_name}}, {{order_id}}, {{order_number}}, {{amount}}, {{currency}}, {{booking_date}}.
  • Paiement : {{payment_status}}, {{payment_request_id}}.
  • IA : {{ai.reply}}, {{ai.classification}}, {{ai.fields.email}}, {{ai.fields.need}} selon le bloc utilisé.

Publier et revenir en arrière

  1. 1Sauvegardez le brouillon Canvas.
  2. 2Prévisualisez Telegram ou WhatsApp avant publication.
  3. 3Publiez une nouvelle version uniquement quand le test est correct.
  4. 4En cas de problème, republiez la version précédente ou désactivez le canal concerné sans supprimer le flow.
Canal
Telegram
Statut
Stable
À savoir
Canal historique conseillé pour la production et les communautés VIP.
Canal
WhatsApp GoWA
Statut
Beta contrôlée
À savoir
Connexion QR rapide, utile pour tester, avec surveillance des sessions.
Canal
WhatsApp Meta
Statut
Préparé/officiel
À savoir
Nécessite Business Manager, numéro, templates approuvés, opt-in et quotas.
Canal
Webchat
Statut
Reporté
À savoir
Ne pas le vendre comme canal disponible aujourd’hui.
Business guides

Create generalist bots with no code

Simple guides for a 10-minute bot, e-commerce, WhatsApp, support, booking or VIP community.

10 min

Create a bot in 10 minutes

  1. 1Choose the goal: sell, book, qualify leads, support customers or manage a community.
  2. 2Choose the active channel: stable Telegram or WhatsApp in controlled beta. Webchat is deferred.
  3. 3Pick a business template in Bot Builder → Templates.
  4. 4Connect the channel: BotFather token for Telegram, GoWA QR or official Meta for WhatsApp.
  5. 5Customize Studio Canvas: welcome, menu, data capture, offer, payment, support.
  6. 6Test with the target channel preview, then publish progressively.
Use case
E-commerce bot
Recommended template
E-commerce
Example journey
Welcome → Category → Product → Payment → Order follow-up → Support
Use case
Support bot
Recommended template
Customer support
Example journey
FAQ → Issue qualification → Ticket → Human handoff
Use case
Booking bot
Recommended template
Restaurant, coaching or event
Example journey
Slot choice → Contact details → Deposit → Confirmation
Use case
Telegram VIP community
Recommended template
VIP community
Example journey
Subscription offer → Payment → Group access → Renewal reminder
Use case
WhatsApp bot
Recommended template
Any Telegram/WhatsApp template
Example journey
Opt-in → Short menu → Payment/support → Logs and quotas
Use case
Webchat bot
Recommended template
Deferred
Example journey
The model is prepared but not enabled in the current interface

Available variables

  • Customer: {{first_name}}, {{last_name}}, {{email}}, {{phone}} depending on collected data.
  • Commerce: {{product_name}}, {{order_id}}, {{order_number}}, {{amount}}, {{currency}}, {{booking_date}}.
  • Payment: {{payment_status}}, {{payment_request_id}}.
  • AI: {{ai.reply}}, {{ai.classification}}, {{ai.fields.email}}, {{ai.fields.need}} depending on the block.

Publish and roll back

  1. 1Save the Canvas draft.
  2. 2Preview Telegram or WhatsApp before publishing.
  3. 3Publish a new version only when the test is correct.
  4. 4If something breaks, republish the previous version or disable the channel without deleting the flow.
Channel
Telegram
Status
Stable
What to know
Historic production channel recommended for VIP communities.
Channel
WhatsApp GoWA
Status
Controlled beta
What to know
Fast QR connection, useful for testing, with session monitoring.
Channel
WhatsApp Meta
Status
Official/prepared
What to know
Requires Business Manager, number, approved templates, opt-in and quotas.
Channel
Webchat
Status
Deferred
What to know
Do not sell it as available today.
Groupe VIP existant

Importer et gérer les membres d’un groupe VIP existant

Synchronisez vos anciens membres, activez leurs abonnements et laissez le bot gérer rappels, expirations et retraits.

8 min

Telegram ne permet pas à un bot de récupérer automatiquement la liste complète des anciens membres déjà présents dans un groupe. JoinGate utilise donc une campagne de synchronisation : chaque membre clique un lien /start sync_xxx pour être identifié proprement.

Cas concret : une organisation possède déjà un groupe VIP Telegram avec des membres payants. Elle veut maintenant les voir dans le dashboard JoinGate, définir manuellement leur abonnement actuel, puis laisser le bot envoyer les rappels et retirer l’accès si un membre ne renouvelle pas.

Prérequis

  • Un abonnement JoinGate actif avec un quota groupes et clients suffisant.
  • Un bot Telegram connecté depuis Dashboard → Bot.
  • Le bot ajouté comme administrateur du groupe VIP existant.
  • Les permissions Telegram nécessaires : gérer le groupe, créer des liens d’invitation et retirer ou restreindre des membres.

Synchroniser les anciens membres

  1. 1Allez dans Dashboard → Groupes Telegram.
  2. 2Ajoutez le groupe VIP existant et vérifiez qu’il est prêt.
  3. 3Cliquez sur Synchroniser les membres existants pour créer une campagne.
  4. 4Copiez le lien https://t.me/<bot>?start=sync_xxx et le message conseillé.
  5. 5Publiez ce message dans votre groupe VIP : chaque ancien membre doit cliquer le lien une fois.
  6. 6JoinGate crée ou met à jour le membre comme prospect dans Dashboard → Clients.

Un prospect synchronisé ne consomme pas le quota max_customers. Le quota client est consommé seulement quand vous l’activez comme client géré.

Activer un ou plusieurs prospects

  1. 1Ouvrez Dashboard → Clients et filtrez les prospects synchronisés.
  2. 2Pour un seul prospect, ouvrez sa fiche puis choisissez l’offre, le groupe Telegram, la date de début et la date d’expiration.
  3. 3Pour plusieurs prospects, cochez les membres visibles ou utilisez Tout cocher.
  4. 4Choisissez une offre, un groupe Telegram optionnel, une date de début et une date de fin.
  5. 5Validez : JoinGate crée customer_subscriptions et group_accesses, puis passe les prospects en clients actifs.
  6. 6Si max_customers est atteint, l’activation est bloquée proprement avec un message d’upgrade.
Exemple : 40 prospects payants → Tout cocher → Offre VIP 30 jours → Groupe privé → activer en une seule action
État
Prospect
Effet
Membre identifié après clic sur le lien de synchronisation.
Quota
Ne consomme pas max_customers
État
Actif
Effet
Abonnement et accès groupe créés manuellement.
Quota
Consomme max_customers
État
Expiré
Effet
Le bot peut retirer l’accès si le membre ne renouvelle pas.
Quota
Ne doit plus compter comme client actif

Rappels, renouvellement et retrait automatique

  • Le cron de rappels utilise la date d’expiration pour prévenir le client avant la fin de son abonnement.
  • Si le client renouvelle avant l’expiration, son abonnement est prolongé et l’accès reste actif.
  • Si le client ne renouvelle pas, le cron d’expiration marque l’abonnement expiré et le bot retire l’accès au groupe.
  • Le bot doit rester administrateur du groupe pour pouvoir retirer automatiquement un membre.
Abonnements

Gérer les abonnements simplement

Prolonger un accès, corriger une date ou activer plusieurs prospects sans manipulation répétitive.

5 min

Depuis le dashboard, un admin peut gérer les accès sans coder : ajouter des jours, choisir une période exacte, changer d’offre ou activer plusieurs prospects à la fois.

Situation
Offrir des jours
Où cliquer
Abonnements → Gérer → Prolonger
Exemple
Ajouter 7 jours à un client fidèle
Situation
Corriger une période
Où cliquer
Abonnements → Gérer → Modifier les dates
Exemple
Début 9 juillet, fin 9 août
Situation
Changer le produit
Où cliquer
Abonnements → Gérer → Changer l’offre
Exemple
Mensuel vers VIP
Situation
Activer en masse
Où cliquer
Clients → sélectionner prospects
Exemple
40 prospects payants activés en une action
  1. 1Pour donner X jours : ouvrez l’abonnement, tapez le nombre de jours, ajoutez une note et cliquez Prolonger.
  2. 2Pour choisir les dates exactes : utilisez Modifier les dates avec Début et Expiration.
  3. 3Pour plusieurs personnes : sélectionnez les prospects dans Clients, choisissez offre/groupe/dates, puis activez en groupe.

Exemple simple : si un client a payé hors Telegram, vous pouvez créer ou corriger son abonnement manuellement, puis JoinGate s’occupe des rappels et retraits automatiques.

Studio Canvas

Créer un bot no-code avec le Studio Canvas

Construisez un parcours Telegram avec blocs, messages, menus, variables et publication.

8 min

Le Studio Canvas est l’éditeur visuel de JoinGate. Vous construisez votre bot comme un schéma : un message d’accueil, un menu, des chemins pour acheter, consulter la FAQ, renouveler ou contacter le support.

Zone
Palette
À quoi ça sert
Ajouter un bloc
Exemple concret
Message, Menu, Action, Condition, Webhook
Zone
Canvas
À quoi ça sert
Organiser le parcours
Exemple concret
Relier Message d’accueil → Menu principal
Zone
Inspecteur
À quoi ça sert
Modifier le bloc choisi
Exemple concret
Changer le texte, les boutons ou l’action
Zone
Toolbar
À quoi ça sert
Sauvegarder, centrer, auto-disposer, publier
Exemple concret
Publier vers Telegram quand le test est bon
Zone
Prévisualisation
À quoi ça sert
Tester avant de publier
Exemple concret
Vérifier le parcours comme un client

Créer un parcours de vente simple

  1. 1Ouvrez Dashboard → Bot Builder.
  2. 2Créez un flow ou choisissez un template proche de votre besoin.
  3. 3Ajoutez un bloc Message avec un accueil clair : Bienvenue {{client_name}} 👋.
  4. 4Ajoutez un bloc Menu avec 3 boutons : Voir les offres, FAQ, Support.
  5. 5Reliez le message au menu, puis chaque bouton au bon chemin.
  6. 6Ajoutez les variables utiles dans vos messages : {{selected_offer_name}}, {{subscription_expires_at}}, {{invite_link}}, {{group_name}}.
  7. 7Cliquez Sauvegarder, puis Prévisualiser.
  8. 8Si tout est correct, cliquez Publier vers Telegram.
Message d’accueil
→ Menu principal
  → Voir les offres
  → FAQ
  → Support

Exemple : vendre un accès VIP Telegram

  1. 1Message : expliquez ce que le client obtient dans le groupe VIP.
  2. 2Menu : proposez Acheter, Mes abonnements, FAQ et Support.
  3. 3Bouton Acheter : utilisez l’action buy_subscription pour afficher les offres actives.
  4. 4Après validation du paiement, envoyez un message de confirmation avec le lien privé.
Merci {{client_name}} !
Votre offre {{selected_offer_name}} est active jusqu’au {{subscription_expires_at}}.
Rejoignez {{group_name}} ici : {{invite_link}}

Autres parcours utiles

Objectif
Support
Structure simple
Message → FAQ / Contacter support / Retour menu
Quand l’utiliser
Répondre vite aux questions clients
Objectif
Renouvellement
Structure simple
Expire bientôt → Renouveler / Voir mes abonnements / Support
Quand l’utiliser
Réduire les expirations non renouvelées
Objectif
Prospect
Structure simple
Recevez le programme gratuit → PDF / Conseiller
Quand l’utiliser
Transformer un lead Telegram en client

Sauvegarder ou publier : différence importante

  • Sauvegarder garde le brouillon dans JoinGate, sans modifier le bot Telegram actif.
  • Prévisualiser sert à tester les textes, menus et chemins avant publication.
  • Publier envoie la version actuelle au bot Telegram.
  • Chaque publication est historisée pour pouvoir comparer, dupliquer ou revenir en arrière.

Méthode recommandée : construire petit à petit, sauvegarder souvent, prévisualiser les boutons importants, puis publier seulement quand le parcours est clair.

Canvas

Les 9 types de nodes du Bot Builder

Chaque node a un rôle précis dans la création d’un parcours bot.

7 min
Node
Message
Champs
messageFr, messageEn, label
Ce qu’il fait
Envoie un texte localisé avec variables comme {{client_name}}.
Statut runtime
Exécuté
Node
Menu
Champs
buttons[].label, buttons[].action
Ce qu’il fait
Affiche des boutons Telegram et continue vers le node connecté.
Statut runtime
Exécuté
Node
Condition
Champs
conditionField, operator, value
Ce qu’il fait
Prépare un branchement TRUE/FALSE selon une donnée client ou contexte.
Statut runtime
Éditable, runtime avancé à brancher
Node
Délai
Champs
delaySeconds
Ce qu’il fait
Prépare une attente avant de poursuivre le parcours.
Statut runtime
Éditable, runtime avancé à brancher
Node
Action
Champs
actionKey
Ce qu’il fait
Déclare une action interne : facture, accès, ticket, collecte.
Statut runtime
Éditable, runtime avancé à brancher
Node
Tag
Champs
tagKey, tagMode
Ce qu’il fait
Ajoute ou retire un tag CRM comme vip, lead ou expired.
Statut runtime
Éditable, runtime avancé à brancher
Node
Webhook
Champs
method, url
Ce qu’il fait
Prépare un appel GET/POST vers CRM, Make, Zapier ou backend.
Statut runtime
Éditable, runtime avancé à brancher
Node
IA
Champs
aiFeature, aiPrompt
Ce qu’il fait
Prépare une réponse ou génération IA consommant des crédits.
Statut runtime
Éditable, runtime avancé à brancher
Node
Split A/B
Champs
variants[].id, label, weight
Ce qu’il fait
Choisit une variante pondérée et mémorise l’attribution client.
Statut runtime
Exécuté

Pour vendre un template aujourd’hui, basez le chemin actif sur Message + Menu + Split. Les autres nodes documentent le parcours et préparent le runtime avancé.

Variables utiles dans les messages

Variable
{{selected_offer_name}}
Usage simple
Nom de l’offre choisie par le client
Variable
{{subscription_expires_at}}
Usage simple
Date de fin d’abonnement
Variable
{{invite_link}}
Usage simple
Lien privé pour rejoindre le groupe
Variable
{{group_name}}
Usage simple
Nom du groupe Telegram donné au client
Votre offre {{selected_offer_name}} est active jusqu’au {{subscription_expires_at}}. Rejoignez {{group_name}} ici : {{invite_link}}
Action keys

Actions et callbacks utilisables dans les templates

Les clés à utiliser dans les menus et les actions pour rester compatible runtime.

12 min

Dans un template, distinguez `buttons[].action` et `data.actionKey`. Les actions de menu sont déjà interprétées par Telegram. Les actionKey de node Action sont sauvegardées pour l’automatisation avancée.

Clé
buy, buy_subscription, subscription_buy
Usage
Alias Menu
Effet actuel
Normalisé en menu:buy. Ouvre les offres actives et le tunnel paiement.
Exemple pratique
Bouton `Voir les offres` dans un template formation premium.
Clé
subscriptions, my_subscriptions
Usage
Alias Menu
Effet actuel
Normalisé en menu:subscriptions. Affiche l’état des abonnements du client.
Exemple pratique
Bouton `Mon accès` pour vérifier si le client est encore actif.
Clé
renew
Usage
Alias Menu
Effet actuel
Normalisé en menu:renew. Relance achat ou renouvellement.
Exemple pratique
Bouton `Renouveler` envoyé 3 jours avant expiration.
Clé
faq
Usage
Alias Menu
Effet actuel
Normalisé en menu:faq. Affiche catégories FAQ et réponses.
Exemple pratique
Bouton `Questions fréquentes` dans un bot support.
Clé
support
Usage
Alias Menu
Effet actuel
Normalisé en menu:support. Ouvre l’aide et la création de demande.
Exemple pratique
Bouton `Parler au support` après une réponse FAQ insuffisante.
Clé
terms, conditions
Usage
Alias Menu
Effet actuel
Normalisé en menu:terms. Affiche règles, conditions ou infos utiles.
Exemple pratique
Bouton `Règles du groupe` avant achat d’une communauté privée.
Clé
language, lang
Usage
Alias Menu
Effet actuel
Normalisé en menu:language. Affiche le choix FR/EN.
Exemple pratique
Bouton `Changer de langue` dans le menu principal.
Clé
menu:start
Usage
Callback système
Effet actuel
Retourne au menu d’accueil ou relance le flow /start publié.
Exemple pratique
Bouton `Retour au menu` après paiement, FAQ ou support.
Clé
menu:buy
Usage
Callback système
Effet actuel
Affiche les offres actives puis les moyens de paiement.
Exemple pratique
Bouton généré par l’alias `buy_subscription`.
Clé
menu:renew
Usage
Callback système
Effet actuel
Affiche le flow offres puis les offres actives.
Exemple pratique
Bouton `Renouveler mon abonnement` dans une campagne de relance.
Clé
menu:faq
Usage
Callback système
Effet actuel
Ouvre la FAQ, catégories et questions disponibles.
Exemple pratique
Bouton `FAQ` après le message d’accueil.
Clé
menu:support
Usage
Callback système
Effet actuel
Affiche les instructions support et peut ouvrir la collecte de message.
Exemple pratique
Bouton `Contacter un humain` dans un parcours SAV.
Clé
menu:terms
Usage
Callback système
Effet actuel
Affiche conditions, règles ou mentions configurées.
Exemple pratique
Bouton `Conditions d’accès` avant paiement.
Clé
menu:language
Usage
Callback système
Effet actuel
Affiche les boutons Français / English.
Exemple pratique
Bouton `Langue` pour les communautés bilingues.
Clé
menu:subscriptions
Usage
Callback système
Effet actuel
Affiche le statut abonnements. Aujourd’hui le message peut indiquer que la vue arrive bientôt.
Exemple pratique
Bouton `Mes abonnements` dans le menu par défaut.
Clé
lang:fr, lang:en
Usage
Callback système
Effet actuel
Met à jour la langue du client Telegram puis renvoie le menu localisé.
Exemple pratique
Le client choisit `English` et reçoit ensuite les textes EN.
Clé
offer:<uuid>
Usage
Callback système
Effet actuel
Sélectionne une offre précise et affiche les moyens de paiement actifs.
Exemple pratique
Bouton généré automatiquement pour l’offre `Coaching Mensuel`.
Clé
pay:<uuid>
Usage
Callback système
Effet actuel
Sélectionne un moyen de paiement et affiche les instructions de règlement.
Exemple pratique
Bouton `Wave` ou `Orange Money` après choix de l’offre.
Clé
faqcat:<uuid>
Usage
Callback FAQ
Effet actuel
Ouvre les questions d’une catégorie FAQ précise.
Exemple pratique
Catégorie `Paiement` avec questions sur reçus et délais.
Clé
faq:<uuid>
Usage
Callback FAQ
Effet actuel
Affiche la réponse d’une question FAQ précise.
Exemple pratique
Question `Comment rejoindre le groupe après paiement ?`.
Clé
flow:<step_key>
Usage
Fallback flow v1
Effet actuel
Tente d’ouvrir une étape publiée par clé ou type.
Exemple pratique
Bouton `programme` qui ouvre une étape descriptive d’un ancien flow.
Clé
c:<flow>:<node>:<handle>
Usage
Canvas v2
Effet actuel
Continue un canvas publié depuis le node et la sortie du bouton.
Exemple pratique
Bouton d’un node Menu qui mène vers un message `Tarifs`.
Clé
canvas:<node>:<handle>
Usage
Canvas legacy
Effet actuel
Ancien format de callback canvas encore reconnu.
Exemple pratique
Compatibilité avec un template créé avant le préfixe court `c:`.
Clé
/start
Usage
Commande Telegram
Effet actuel
Lance le flow /start publié ou affiche le menu d’accueil.
Exemple pratique
Premier message quand un client ouvre le bot.
Clé
/renew, /faq, /support, /language, /lang, /id
Usage
Commandes Telegram
Effet actuel
Déclenchent renouvellement, FAQ, support, langue ou diagnostic chat ID.
Exemple pratique
Un admin tape `/id` dans un groupe pour récupérer l’identifiant Telegram.

Action keys recommandées pour les nodes Action

actionKey
send_invoice
Intention
Préparer/enregistrer une demande de facture.
Exemple de scénario
Après paiement B2B, le bot demande les infos société puis marque l’étape facture à traiter.
actionKey
grant_access
Intention
Déclarer une étape de livraison d’accès.
Exemple de scénario
Après validation Wave, le flow note que l’accès au groupe Telegram privé doit être livré.
actionKey
create_ticket
Intention
Créer une demande support.
Exemple de scénario
Si la FAQ ne résout pas le problème, le client décrit son souci et un ticket est créé.
actionKey
collect_email
Intention
Collecter un email client.
Exemple de scénario
Avant d’envoyer un PDF gratuit, le bot demande l’email du prospect.
actionKey
collect_phone
Intention
Collecter un téléphone.
Exemple de scénario
Pour un coaching premium, le bot récupère le numéro afin de planifier un appel.
actionKey
notify_admin
Intention
Notifier l’équipe interne.
Exemple de scénario
Un prospect choisit l’offre VIP : l’équipe reçoit une alerte pour le rappeler vite.
actionKey
handoff_human
Intention
Basculer vers intervention humaine.
Exemple de scénario
Un client signale un paiement bloqué : le bot arrête l’automatisation et passe au support humain.
Templates

Créer un template marketplace propre

Structure, contenu, checklist qualité et exemple JSON pour admin.

9 min
  1. 1Définissez le cas d’usage : vente, support, formation, réservation, lead, communauté.
  2. 2Renseignez nom FR/EN, slug, catégorie, description, difficulté, prix crédits et statut premium.
  3. 3Construisez le `default_flow` avec un Message d’accueil, un Menu principal et les chemins essentiels.
  4. 4Utilisez les actions runtime reconnues : buy_subscription, faq, support, renew, language.
  5. 5Testez le parcours depuis la preview, sauvegardez le canvas, puis activez le template.
{
  "slug": "coaching-premium",
  "is_premium": true,
  "price_credits": 20,
  "default_flow": {
    "version": 2,
    "nodes": [
      { "id": "welcome", "type": "message", "data": { "kind": "message", "messageFr": "Bienvenue {{client_name}}", "messageEn": "Welcome {{client_name}}" } },
      { "id": "main_menu", "type": "menu", "data": { "kind": "menu", "buttons": [
        { "label": "Voir les offres", "action": "buy_subscription" },
        { "label": "FAQ", "action": "faq" },
        { "label": "Support", "action": "support" }
      ] } }
    ]
  }
}

Un bon template doit être utile avant personnalisation : messages bilingues prêts, actions runtime valides, prix clair, preview lisible et bénéfice métier évident.

Paiements & IA

Paiements, reçus et crédits IA

Comment JoinGate gère l’argent, les reçus, les accès et la consommation IA.

6 min
  • Le client choisit une offre puis un moyen de paiement.
  • JoinGate affiche les instructions et attend le reçu ou la référence.
  • L’IA peut analyser le reçu si des crédits sont disponibles.
  • Après validation, l’abonnement est activé et l’accès Telegram est livré.
  • Les crédits inclus dans le plan sont consommés avant les packs achetés.
Feature IA
Analyse reçu
Coût indicatif
1 crédit
Usage
Valider un paiement plus vite.
Feature IA
Génération de flow
Coût indicatif
5 crédits
Usage
Créer une base de parcours.
Feature IA
Génération FAQ
Coût indicatif
3 crédits
Usage
Préparer le support self-service.
Feature IA
Résumé ticket
Coût indicatif
1 crédit
Usage
Aider l’équipe support.
WhatsApp

Utiliser WhatsApp avec JoinGate

Différence entre GoWA beta, API officielle Meta, templates, opt-in, quotas et bonnes pratiques de lancement.

7 min

WhatsApp dans JoinGate est conçu comme un canal additionnel du même Studio Canvas. Vous gardez vos offres, paiements, support et contacts dans le dashboard, puis vous choisissez le connecteur adapté à votre niveau de maturité.

Option
GoWA beta
À quoi ça sert
Connexion rapide via QR WhatsApp Web
Quand l’utiliser
Tests internes, démonstrations, premières automatisations non critiques
Option
API officielle Meta
À quoi ça sert
Envoi officiel via WhatsApp Business Cloud API
Quand l’utiliser
Production, templates approuvés, conformité, volumes suivis
Option
Templates Meta
À quoi ça sert
Messages pré-approuvés dans Meta Business Manager
Quand l’utiliser
Relances, notifications, paiements, messages hors fenêtre client
  1. 1Activez d’abord Telegram si vous voulez un canal de production stable immédiatement.
  2. 2Pour GoWA : ouvrez Dashboard → Canaux → WhatsApp, créez le connecteur, scannez le QR, envoyez un message test.
  3. 3Pour Meta : créez une app Meta Business, récupérez Phone Number ID, WABA ID, token d’accès et verify token, puis configurez le webhook JoinGate.
  4. 4Enregistrez uniquement des templates déjà approuvés côté Meta avant de les envoyer depuis JoinGate.
  5. 5Vérifiez opt-in/opt-out, quotas du plan, add-ons WhatsApp et monitoring admin avant d’augmenter le volume.

Ne lancez pas une campagne WhatsApp sans consentement explicite. Les STOP / DÉSABONNER sont enregistrés et bloquent les envois Meta depuis le dashboard tant que le contact n’a pas repris son consentement.

Troubleshooting

Checklist launch, erreurs fréquentes et rollback

Contrôles simples avant publication et actions de retour arrière si un canal ou flow pose problème.

6 min
Problème
Le bot Telegram ne répond pas
Vérification
Token, webhook, bot admin du groupe
Solution rapide
Rafraîchir le webhook et tester /start
Problème
Le canvas ne suit pas le bon chemin
Vérification
Connexions btn_0 / btn_1, flow publié
Solution rapide
Sauvegarder, prévisualiser, republier la bonne version
Problème
WhatsApp GoWA n’envoie pas
Vérification
Session QR, statut connecté, endpoint GoWA
Solution rapide
Reconnecter la session et envoyer un message test
Problème
Meta refuse un message
Vérification
Opt-in, template approuvé, variables, quota
Solution rapide
Utiliser un template approuvé ou demander le consentement
Problème
Quota WhatsApp atteint
Vérification
Plan + add-ons + usage du jour
Solution rapide
Acheter un add-on ou attendre le reset quotidien
  • Avant release : testez un flow court, une offre, un paiement, un ticket support et un message WhatsApp si le canal est activé.
  • Plan de rollback : repassez sur la dernière version publiée du flow, désactivez le connecteur WhatsApp instable, gardez Telegram comme canal stable.
  • Pour les admins SaaS : surveillez /admin/billing pour quotas WhatsApp, factures, add-ons et désactivation abus.
Webhooks & sécurité

Intégrations et règles de sécurité

Les bonnes pratiques pour connecter JoinGate à votre stack sans exposer de secrets.

5 min
  • Ne partagez jamais le token BotFather : JoinGate le stocke chiffré.
  • Utilisez les webhooks uniquement avec HTTPS et endpoints authentifiés.
  • Ne mettez jamais de clé secrète dans un template public.
  • Séparez toujours contexte admin plateforme et organisation.
  • Testez les flows sur un bot de staging avant publication client.
{
  "event": "payment.validated",
  "organization_id": "uuid",
  "customer_id": "uuid",
  "amount": 15000,
  "currency": "XOF",
  "provider": "wave"
}
Prêt à construire ?

Lancez un bot Telegram monétisable en quelques minutes.

Utilisez un template, personnalisez le canvas et publiez vers Telegram sans développeur.

Documentation JoinGate — Bot Builder no-code multi-canaux, WhatsApp, Telegram, paiements et IA