Оплата контента за звезды

Событие блок-схемы «Оплата контента за звезды» запускается, когда пользователь оплатил звёздами Telegram (⭐) фото или видео, отправленные действием «Отправить платный контент за звёзды». По нему можно выдать доступ к курсу, начислить бонус, поблагодарить за покупку или записать её в CRM.

Если бот ранее уже был подключен - то чтобы событие сработало - обязательно переподключите интеграцию.

Зайдите в "Интеграции" - "Telegram" - "Ваш бот" - "Переподключить".

Событие находится в каталоге событий блок-схемы: вкладка «Интеграции», раздел «Telegram».

Когда приходит и когда нет

Приходит, когда пользователь оплатил платный контент, который бот отправил ему в личный чат, и у этого контента заполнена «Метка покупки».

Не приходит:

если в действии «Отправить платный контент за звёзды» пустая «Метка покупки» — Telegram сообщает только о покупках с меткой;
если контент отправлен в канал — о покупках в каналах Telegram боту не сообщает;
если бот подключён к Multy давно и после этого не переподключался (см. ниже).

Событие приходит один раз на покупку. Повторно оплатить тот же контент пользователь не может — он уже открыт.

Переменные

{var:object.payload} — «Метка покупки» из действия, по ней понятно, что купили (текст);
{var:object.text} — то же значение (текст);
{var:object.type} — всегда paid_media (текст);
пользователь блок-схемы — покупатель: его имя, поля и переменные {user:…} доступны как обычно.

Пример содержимого {var:object}:

{
  "id": 0,
  "type": "paid_media",
  "payload": "course-42",
  "text": "course-42"
}

Сумму оплаты событие не передаёт: она равна цене, указанной в действии при отправке.

Как отличить, что именно купили

Давайте каждому платному контенту свою «Метку покупки», например course-42, lesson-1, pack-photos. Затем:

После события поставьте условие по переменной {var:object.payload} и разветвите блок-схему: своя ветка для каждой метки.

В метку можно подставить переменную при отправке — например, ID товара или заказа: order-{var:order_id}. Тогда по ней легко найти, к чему относится оплата. Длина метки — до 128 байт (кириллица занимает 2 байта на букву).

Пример блок-схемы

Событие «Оплата контента за звезды».
Условие: {var:object.payload} равно course-42.
Действие: записать пользователя в список «Купили курс 42» или поставить ему тег.
Действие «Отправить сообщение»: «Спасибо за покупку! Доступ к курсу открыт» с кнопкой-ссылкой на материалы.

Если событие не приходит: переподключите бота

Telegram отправляет боту только те типы событий, которые были разрешены при его подключении. Если бот подключён до появления этого события, откройте настройки интеграции бота и нажмите «Переподключить». Сделать это нужно один раз — после этого события об оплате начнут приходить.

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

Симптом	Причина и что сделать
Оплата прошла, а блок-схема не запустилась	Проверьте по порядку: заполнена ли «Метка покупки» в действии отправки; отправлен ли контент в личный чат, а не в канал; нажимали ли «Переподключить» в интеграции бота; совпадает ли метка с той, что проверяет условие после события.
Схема реагирует на любую покупку	Событие срабатывает на все покупки. Добавьте после него условие по `{var:object.payload}`.
Нужно знать сумму	Событие её не передаёт. Сохраните цену в метку при отправке (например, `course-42-150`) или в поле пользователя.