Docs · Guide utilisateur

Conversationnel · Telegram

Acceptez les paiements directement dans Telegram avec @miaposbot — pas d'application à installer, pas de nouvel appareil, pas besoin de quitter la conversation avec votre client.

PublicMarchand
DifficultéDébutant
Mis à jour30.05.2026

De quoi s'agit-il et pourquoi

@miaposbot est le bot officiel miaPOS sur Telegram. Vous tapez une commande courte dans n'importe quelle conversation (un message privé avec un client, un groupe, un canal) — le client reçoit un bouton Payer et finalise le paiement sur la page sécurisée de sa banque.

Pourquoi cela fonctionne ainsi :

  • Le client n'installe rien — il s'agit de la page de paiement standard de sa banque.
  • Vous n'ouvrez rien — tout reste dans la conversation où vous échangez déjà.
  • Cela fonctionne dans n'importe quelle conversation Telegram, même celle où le bot n'a jamais été ajouté.

Étape 0 — Activation unique

Vous liez votre Telegram à votre compte vendeur une seule fois. Le bot interroge le système de votre banque et vous identifie par votre numéro de téléphone.

  1. Ouvrez la conversation avec @miaposbot et envoyez /start.
  2. Le bot affiche la liste des banques — appuyez sur votre banque. Si votre marchand ne travaille qu'avec une seule banque, cette étape est ignorée automatiquement.
  3. Appuyez sur 📞 Partager le téléphone et confirmez dans la boîte de dialogue système de Telegram.
  4. Terminé — le bot répond « Activé en tant que vendeur de [nom du marchand] ».
Si le bot répond « Téléphone introuvable » — demandez à votre responsable d'ajouter votre numéro dans le Portail Marchand.

1) Choisissez votre banque

Après /start, le bot affiche le sélecteur de banque :

Sélecteur de banque affiché après /start

2) Partagez votre téléphone

Après avoir choisi votre banque, le bot vous demande de partager votre numéro de téléphone :

Message d'accueil et bouton Partager le téléphone

3) Confirmez dans Telegram

Telegram ouvre sa boîte de dialogue système standard — appuyez sur OK :

Boîte de dialogue système Telegram « Partager votre numéro de téléphone »

4) Activé

@miaposbot
  ✅ Activé en tant que vendeur de Cafenea SRL.
     Essayez : @miaposbot 100 café

Le scénario principal — le mode inline

C'est la raison d'être du bot. Vous tapez la commande directement dans la conversation du client (ou dans un groupe) — le bot ne rejoint pas la conversation, il vous suggère simplement le paiement.

1. Dans la conversation avec votre client, commencez à taper :

@miaposbot 100 café

2. Un aperçu de paiement apparaît au-dessus du clavier (seul vous le voyez — le client ne voit encore rien) :

┌─ suggestions @miaposbot ────────────────┐
│ 💳 Payer 100 MDL                        │
│    Cafenea SRL · "café"                 │
└─────────────────────────────────────────┘

3. Appuyez sur l'aperçu — le bot publie une carte de paiement avec un bouton Payer dans la conversation :

vous (via @miaposbot)
  💳 Cafenea SRL
     100 MDL · café

  [   Payer   ]

4. Le client appuie sur Payer → la page de paiement sécurisée de sa banque s'ouvre → il paie.

5. La carte se met à jour toute seule en ✅ Payé ou ❌ Échec — personne n'a besoin de rafraîchir quoi que ce soit :

vous (via @miaposbot)
  ✅ 100 MDL payés
     "café"

Syntaxe de la commande

Format :

@miaposbot <montant> [devise] [description] [+téléphone | IBAN] [#étiquette]
ChampObligatoireExemples
montantoui100, 99.50, 10.00
devisenon (MDL par défaut)EUR, USD, RON
descriptionnoncafé, table 7, facture mai
+téléphonenon+37368881777demande de paiement envoyée au téléphone au lieu d'un lien
IBANnonMD24AG000...demande de paiement envoyée au compte
#étiquettenon#table-7, #juin — votre propre libellé pour vos rapports

Exemples

CommandeCe qui se passe
@miaposbot 100100 MDL, sans description
@miaposbot 100 café100 MDL, description « café »
@miaposbot 99.50 EUR déjeuner99,50 EUR, description « déjeuner »
@miaposbot 250 +37368881777Demande de paiement push envoyée au +37368881777
@miaposbot 50 café #table-750 MDL + votre étiquette #table-7
Séparateur — une simple espace. Vous pouvez utiliser ; si vous préférez (@miaposbot 100; café; #table-7).

Dans les groupes et les canaux

La commande inline fonctionne dans n'importe quelle conversation Telegram où vous pouvez envoyer des messages :

  • En tête-à-tête avec un client — comme décrit ci-dessus.
  • Groupe (par exemple un groupe de commande HoReCa) — même déroulement.
  • Canal dont vous êtes administrateur.
Le bot n'a pas besoin d'être dans le groupe. Il fonctionne en mode Invité (Bot API 10.0) — il ne lit rien dans la conversation, il publie seulement la carte de paiement que vous avez sélectionnée dans l'aperçu inline.

Copie en message privé

Chaque fois que vous créez un paiement dans un groupe, le bot vous envoie une copie en message privé — vous conservez ainsi votre propre historique, même si le groupe est animé :

@miaposbot → vous, en privé
  💳 Paiement créé via le mode inline
     100 MDL · "café"

Le statut final est également répercuté dans votre message privé.

Statut du paiement

La carte de paiement se modifie d'elle-même dans la conversation au fur et à mesure que le résultat arrive :

Ce que vous voyezSignification
💳 + bouton PayerEn attente de l'action du client
PayéLe client a payé ; les fonds sont réglés selon les règles de votre banque
ÉchecLe client a annulé ou une erreur est survenue

Le même statut arrive dans votre message privé avec le bot.

En cas de problème

ProblèmeSolution
Le bot ne répond pas à /startVérifiez que vous avez bien défini un nom d'utilisateur dans Telegram (Paramètres → Nom d'utilisateur). Le bot vous identifie par @username.
« Téléphone introuvable »Votre responsable doit ajouter votre numéro dans le Portail Marchand.
« Ce compte est déjà lié à un autre Telegram »Contactez votre administrateur pour délier l'ancien Telegram.
L'aperçu inline n'apparaît pasVérifiez que vous avez tapé exactement @miaposbot (avec l'arobase) et une espace avant le montant.
« ⚠️ Service temporairement indisponible »Patientez une minute puis réessayez.

FAQ

Q : Le client doit-il installer quelque chose ?
R : Non. Il appuie sur Payer et la page de paiement sécurisée de sa banque s'ouvre — la même que pour n'importe quel paiement en ligne classique.

Q : Et les frais ?
R : Exactement les tarifs négociés avec votre banque. Le bot n'ajoute rien.

Q : Où arrive l'argent ?
R : Sur le compte marchand auprès duquel vous êtes enregistré — selon les règles de votre banque.

Q : Et si le paiement passe mais que le statut ne se met pas à jour ?
R : La carte se rafraîchira automatiquement dès que la banque aura confirmé. Si quelque chose bloque — cela n'affecte pas l'argent ; il est déjà chez la banque.

Q : Dans quelle langue le bot répond-il ?
R : Dans celle configurée dans votre Telegram (RO / RU / EN).

Q : Est-ce sûr dans un groupe ?
R : Oui. Le bot fonctionne en mode Invité — il ne lit pas les autres messages, il publie seulement la carte que vous avez choisie dans l'aperçu inline.

Sécurité

  • Le bot ne voit jamais les données de carte — le client les saisit sur la page sécurisée de sa banque.
  • Le bot ne voit jamais vos mots de passe — l'autorisation se fait via votre numéro de téléphone lié dans le Portail Marchand.
  • Chaque paiement transite par votre banque et est signé de son côté — personne au milieu ne peut rien modifier.

Que fait d'autre le bot

Ce guide couvre uniquement le mode inline. Le bot dispose aussi d'autres scénarios (commandes directes /pay et /rtp en DM, historique et rapports par #étiquette) — ils apparaîtront dans les versions futures de ce guide.