Conversational · Telegram

Принимайте платежи прямо в Telegram через @miaposbot — без приложений, без новых устройств, без выхода из диалога с клиентом.

Что это и зачем

@miaposbot — официальный бот miaPOS в Telegram. Вы пишете в любом чате (с клиентом в личке, в групповом чате, в канале) короткую команду — клиент получает кнопку «Оплатить» и оплачивает через защищённую страницу своего банка.

Зачем именно так:

• Клиенту ничего ставить не нужно — стандартная страница оплаты банка.
• Вам ничего открывать не нужно — всё в том же чате, где вы общаетесь.
• Работает в любом чате Telegram, даже там где бот не подключён.

Шаг 0 — Один раз: онбординг

Один раз вам нужно привязать ваш Telegram к учётной записи продавца. Бот сходит в систему вашего банка и найдёт вас по номеру телефона.

1. Откройте чат с @miaposbot и отправьте /start.
2. Бот покажет список банков — тапните ваш банк. Если у вашего мерчанта один банк, этот шаг пропускается автоматически.
3. Нажмите кнопку «📞 Поделиться номером» и подтвердите в системном диалоге Telegram.
4. Готово — бот напишет «Активирован как продавец «название мерчанта»».

Если бот пишет «Номер не найден» — попросите менеджера добавить ваш номер в кабинете мерчанта.

1) Выбор банка

После /start бот показывает выбор банка:

2) Поделитесь номером телефона

После выбора банка бот предлагает поделиться номером телефона:

3) Подтвердите в Telegram

Telegram откроет стандартный системный диалог — тапните OK:

4) Активировано

@miaposbot
  ✅ Активирован как продавец Cafenea SRL.
     Попробуйте: @miaposbot 100 кофе

Главный сценарий — inline-режим

Это то, ради чего бот существует. Вы пишете команду прямо в чате с клиентом (или в группе) — бот не входит в чат, он только подсказывает вам платёж.

1. В чате с клиентом начинаете печатать:

@miaposbot 100 кофе

2. Над клавиатурой появляется превью платежа (это видите только вы — клиент пока ничего не видит):

┌─ предложения @miaposbot ────────────────┐
│ 💳 Оплатить 100 MDL                     │
│    Cafenea SRL · «кофе»                 │
└─────────────────────────────────────────┘

3. Тапаете по превью — бот публикует в чат карточку платежа с кнопкой «Оплатить»:

вы (через @miaposbot)
  💳 Cafenea SRL
     100 MDL · кофе

  [    Оплатить    ]

4. Клиент тапает «Оплатить» → открывается защищённая страница банка → оплачивает.

5. Карточка сама обновляется на ✅ Оплачено или ❌ Не оплачено — никто ничего не делает руками:

вы (через @miaposbot)
  ✅ 100 MDL оплачено
     «кофе»

Синтаксис команды

Формат:

@miaposbot <сумма> [валюта] [описание] [+телефон | IBAN] [#тег]

Примеры

Разделитель — обычный пробел. Можно ставить ; если так удобнее (@miaposbot 100; кофе; #стол-7).

В группах и каналах

Inline-команда работает в любом чате Telegram, где вы можете писать:

• В личке с клиентом — как описано выше.
• В групповом чате (например, чат заказа в HoReCa) — то же самое.
• В канале, где вы являетесь админом.

Боту не нужно быть в группе. Он работает в режиме Guest (Bot API 10.0) — ничего не читает в чате, только публикует карточку платежа, которую вы выбрали в inline-превью.

DM-зеркало

Каждый раз, когда вы создаёте платёж в группе, бот присылает вам копию в личку — чтобы у вас был свой журнал, даже если групповой чат шумный:

@miaposbot → вам в личку
  💳 Платёж создан через inline mode
     100 MDL · «кофе»

Когда платёж завершится, в личку придёт и статус.

Статусы платежей

Карточка платежа сама редактируется в чате, когда статус известен:

Тот же статус приходит и в вашу личку с ботом.

Что делать если…

FAQ

Q: Клиенту нужно что-то ставить?
A: Нет. Он просто тапает «Оплатить» — открывается защищённая страница его банка. Это та же страница, что и при обычной онлайн-оплате.

Q: Что с комиссиями?
A: Тарифы — ровно те, что согласованы с вашим банком. Бот ничего не добавляет.

Q: Где приземляются деньги?
A: На счёт мерчанта, с которым вы зарегистрированы — по правилам вашего банка.

Q: А если оплата пройдёт, а статус не обновится?
A: Карточка обновится автоматически, как только банк подтвердит. Если что-то зависло — деньги на статус не влияют, они уже у банка.

Q: На каком языке отвечает бот?
A: На том, что задан в вашем Telegram (RU / RO / EN).

Q: Безопасно ли в групповом чате?
A: Да. Бот работает в режиме Guest — не читает чужие сообщения, только публикует карточку, которую вы выбрали в inline-превью.

Безопасность

• Бот никогда не видит данные карты — клиент вводит их на защищённой странице своего банка.
• Бот никогда не видит ваши пароли — авторизация идёт через ваш номер телефона, привязанный в кабинете мерчанта.
• Каждый платёж проходит через ваш банк и подписывается на их стороне — никто посередине ничего изменить не может.

Что ещё умеет бот

В этом гиде описан только inline-режим. У бота есть и другие сценарии (прямые команды /pay и /rtp в личке с ботом, мульти-банковский выбор, история и отчёты по #тегам) — они появятся в следующих версиях гида.