Conversational · Telegram
Acceptați plăți direct în Telegram cu @miaposbot — fără aplicații, fără terminale noi, fără a ieși din conversația cu clientul.
Ce este și de ce
@miaposbot este botul oficial miaPOS în Telegram. Scrieți o comandă scurtă în orice chat (în privat cu un client, într-un grup, într-un canal) — clientul primește un buton Plătește și achită prin pagina securizată a băncii sale.
De ce așa:
- Clientul nu instalează nimic — pagina obișnuită de plată a băncii.
- Vânzătorul nu deschide nimic — totul în chat-ul în care comunicați.
- Funcționează în orice chat Telegram, chiar și acolo unde botul nu este adăugat.
Pasul 0 — O singură dată: activare
Trebuie o singură dată să legați Telegram-ul de contul de vânzător. Botul va intra în sistemul băncii dvs. și vă va găsi după numărul de telefon.
- Deschideți chat-ul cu @miaposbot și trimiteți
/start. - Botul vă afișează lista de bănci — atingeți banca dvs. Dacă comerciantul dvs. lucrează cu o singură bancă, acest pas este sărit automat.
- Apăsați butonul 📞 Trimite numărul și confirmați în dialogul de sistem Telegram.
- Gata — botul vă scrie «Sunteți activat ca vânzător al „nume comerciant”».
Dacă botul răspunde «Numărul nu a fost găsit» — rugați managerul să adauge numărul dvs. în Portalul Comerciantului.
1) Selectarea băncii
După /start botul afișează lista de bănci:

2) Trimiteți numărul de telefon
După selectarea băncii botul vă propune să trimiteți numărul de telefon:

3) Confirmați în Telegram
Telegram va cere confirmare — este dialogul de sistem standard, atingeți OK:

4) Activat
@miaposbot
✅ Sunteți activat ca vânzător al Cafenea SRL.
Încercați: @miaposbot 100 cafea
Scenariul principal — mod inline
Aici stă puterea botului. Scrieți comanda direct în chat-ul cu clientul (sau în grup) — botul nu intră în chat, doar vă sugerează plata.
1. În chat-ul cu clientul începeți să scrieți:
@miaposbot 100 cafea
2. Deasupra tastaturii apare previzualizarea plății (o vedeți doar dvs. — clientul încă nu vede nimic):
┌─ sugestii @miaposbot ───────────────────┐
│ 💳 Plătește 100 MDL │
│ Cafenea SRL · «cafea» │
└─────────────────────────────────────────┘
3. Apăsați pe previzualizare — botul publică în chat cardul de plată cu butonul Plătește:
dvs. (prin @miaposbot)
💳 Cafenea SRL
100 MDL · cafea
[ Plătește ]
4. Clientul apasă Plătește → se deschide pagina securizată a băncii → achită.
5. Cardul se actualizează singur la ✅ Plătit sau ❌ Eșuat — nimeni nu face nimic manual:
dvs. (prin @miaposbot)
✅ 100 MDL plătit
«cafea»
Sintaxa comenzii
Format:
@miaposbot <sumă> [valută] [descriere] [+telefon | IBAN] [#etichetă]
| Câmp | Obligatoriu | Exemple |
|---|---|---|
sumă | da | 100, 99.50, 10.00 |
valută | nu (implicit MDL) | EUR, USD, RON |
descriere | nu | cafea, masa 7, plata pentru mai |
+telefon | nu | +37368881777 → request-to-pay la telefon în loc de link |
IBAN | nu | MD24AG000... → request-to-pay la cont |
#etichetă | nu | #masa-7, #iunie — eticheta dvs. pentru rapoarte |
Exemple
| Comandă | Ce se întâmplă |
|---|---|
@miaposbot 100 | 100 MDL, fără descriere |
@miaposbot 100 cafea | 100 MDL, descriere «cafea» |
@miaposbot 99.50 EUR pranz | 99.50 EUR, descriere «pranz» |
@miaposbot 250 +37368881777 | Cerere de plată push la +37368881777 |
@miaposbot 50 cafea #masa-7 | 50 MDL + eticheta dvs. #masa-7 |
Separator — spațiu obișnuit. Puteți folosi;dacă vă este mai comod (@miaposbot 100; cafea; #masa-7).
În grupuri și canale
Comanda inline funcționează în orice chat Telegram unde puteți scrie:
- În privat cu clientul — așa cum este descris mai sus.
- În chat de grup (de exemplu chat-ul de comandă HoReCa) — la fel.
- În canal unde sunteți admin.
Botul nu trebuie să fie în grup. Lucrează în regim Guest (Bot API 10.0) — nu citește nimic din chat, doar publică cardul de plată pe care l-ați ales din previzualizarea inline.
Oglindă în privat
De fiecare dată când creați o plată într-un grup, botul vă trimite o copie în privat — ca să aveți propriul jurnal, chiar dacă chat-ul de grup este aglomerat:
@miaposbot → dvs. în privat
💳 Plată creată via inline mode
100 MDL · «cafea»
Când plata se finalizează, statusul vine și în privat.
Statusul plății
Cardul de plată se editează singur în chat când se cunoaște statusul:
| Ce vedeți | Ce înseamnă |
|---|---|
| 💳 + butonul Plătește | Așteptăm acțiunea clientului |
| ✅ Plătit | Clientul a achitat cu succes; banii ajung pe cont conform regulilor băncii |
| ❌ Eșuat | Clientul a anulat sau a apărut o eroare |
Același status ajunge și în privat la dvs. cu botul.
Ce să faceți dacă…
| Problemă | Soluție |
|---|---|
Botul nu răspunde la /start | Asigurați-vă că aveți username setat în Telegram (Setări → Username). Botul vă caută după @username. |
| «Numărul nu a fost găsit» | Managerul trebuie să adauge numărul dvs. în Portalul Comerciantului. |
| «Acest cont este deja legat de alt Telegram» | Contactați administratorul — trebuie deconectat vechiul Telegram. |
| Previzualizarea inline nu apare | Verificați că ați scris exact @miaposbot (cu @!) și spațiu înainte de sumă. |
| «⚠️ Serviciul este temporar indisponibil» | Așteptați un minut și reîncercați. |
FAQ
Î: Clientul trebuie să instaleze ceva?
R: Nu. Apasă «Plătește» — se deschide pagina securizată a băncii sale. Aceeași pagină ca la orice plată online obișnuită.
Î: Cum stă cu comisioanele?
R: Exact tarifele agreate cu banca dvs. Botul nu adaugă nimic.
Î: Unde ajung banii?
R: În contul comerciantului cu care sunteți înregistrat — conform regulilor băncii dvs.
Î: Dacă plata trece, dar statusul nu se actualizează?
R: Cardul se va actualiza automat când banca confirmă. Dacă ceva întârzie — asta nu afectează banii, ei sunt deja la bancă.
Î: În ce limbă răspunde botul?
R: În limba setată în Telegram-ul dvs. (RO / RU / EN).
Î: E sigur într-un chat de grup?
R: Da. Botul lucrează în regim Guest — nu citește mesaje străine, publică doar cardul pe care l-ați ales în previzualizarea inline.
Securitate
- Botul nu vede niciodată datele cardului — clientul le introduce pe pagina securizată a băncii sale.
- Botul nu vede niciodată parolele dvs. — autorizarea se face prin numărul de telefon legat în Portalul Comerciantului.
- Fiecare plată trece prin banca dvs. și este semnată pe partea lor — nimeni la mijloc nu poate modifica nimic.
Ce mai poate botul
În acest ghid este descris doar modul inline. Botul are și alte scenarii (comenzi directe /pay și /rtp în privat cu botul, istoric și rapoarte pe #etichete) — vor apărea în versiunile următoare ale ghidului.