Documentație · Ghid utilizator

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.

AudiențăComerciant
DificultateDe bază
Actualizat2026-05-30

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.

  1. Deschideți chat-ul cu @miaposbot și trimiteți /start.
  2. 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.
  3. Apăsați butonul 📞 Trimite numărul și confirmați în dialogul de sistem Telegram.
  4. 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:

Selectarea băncii după /start

2) Trimiteți numărul de telefon

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

Salut și butonul «Trimite numărul»

3) Confirmați în Telegram

Telegram va cere confirmare — este dialogul de sistem standard, atingeți OK:

Dialog de sistem Telegram «Share Your Phone Number?»

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âmpObligatoriuExemple
sumăda100, 99.50, 10.00
valutănu (implicit MDL)EUR, USD, RON
descrierenucafea, masa 7, plata pentru mai
+telefonnu+37368881777request-to-pay la telefon în loc de link
IBANnuMD24AG000...request-to-pay la cont
#etichetănu#masa-7, #iunie — eticheta dvs. pentru rapoarte

Exemple

ComandăCe se întâmplă
@miaposbot 100100 MDL, fără descriere
@miaposbot 100 cafea100 MDL, descriere «cafea»
@miaposbot 99.50 EUR pranz99.50 EUR, descriere «pranz»
@miaposbot 250 +37368881777Cerere de plată push la +37368881777
@miaposbot 50 cafea #masa-750 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țiCe înseamnă
💳 + butonul PlăteșteAșteptăm acțiunea clientului
PlătitClientul a achitat cu succes; banii ajung pe cont conform regulilor băncii
EșuatClientul 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 /startAsiguraț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 apareVerificaț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.