Действие — Отправить счет в Telegram

Действие позволяет сформировать ссылку на оплату в Telegram для оплаты звездами или другой валютой через платежных провайдеров (которые дает сам Telegram).

Важно! Для работы действия нужно настроить интеграцию с telegram.

Рассмотрим действие подробнее:

1) Переключатель позволяет выбрать сообщество из которого будет выполнено действие.

2) ID пользователя: поддерживаются числа и переменные например, %chat_id%
По умолчанию: %chat_id%.

3) Название продукта в Telegram (до 32 символов): поддерживаются переменные например, %product_title%
По умолчанию: %product_title%.

4) Стоимость продукта в Telegram : поддерживаются числа и переменные например, %product_price%

По умолчанию: %product_price%.

5) Номер счета, поддерживаются переменные автопилота, например %bill_id%

По умолчанию: ничего.

6) Описание продукта в Telegram (до 255 символов): поддерживаются переменные например, %description%

По умолчанию: ничего.

7) Валюта счёта в Telegram : поддерживаются переменные, либо идентификатор валюты: RUB,USD, XTR (звезды)

По умолчанию: RUB.

8) Платёжный токен в Telegram (выдается вашим ботом): поддерживаются переменные например, %token%

По умолчанию: ничего. Значение игнорируется, если валюта XTR - звезды.

9) Дополнительные параметры.

Список дополнительных параметров для действия. По умолчанию они все все false. Ниже рассмотрим подробнее

• need_name — запросить у пользователя имя/фамилию и передать в order_info.name.
• need_email — запросить e-mail пользователя и передать в order_info.email.
• need_phone_number — запросить номер телефона пользователя и передать в order_info.phone_number.
• send_email_to_provider — передать e-mail платёжному провайдеру (Acquirer/PSP). Имеет смысл только если запрошен e-mail.
• send_phone_number_to_provider — передать телефон провайдеру. Имеет смысл только если запрошен телефон.
• need_shipping_address — запросить почтовый адрес доставки и прислать боту shipping_query с адресом; адрес попадёт в order_info.shipping_address.
• is_flexible — цена зависит от способа доставки/опций. Включает механику доставки: бот получит shipping_query, на которое нужно ответить answerShippingQuery с вариантами доставки и их ценами. Обычно используют вместе с need_shipping_address=true.

Замечания:

• Все флаги по умолчанию false.
• Данные (имя, e-mail, телефон, адрес) появляются только если пользователь согласился их передать.
• Для доставки ставьте оба: need_shipping_address=true и is_flexible=true, и обязательно обрабатывайте shipping_query.

Полезные переменные действия:

Ответ сервера Telegram: %reponse%
Данные действия: %api_data%
ID сообщения со счётом: %last_mess_id%

Важно! Рекомендуется привязывать страницы к счету, чтобы реагировать на конкретный товар, потому что Telegram не отдает название при оплате и платеж будет неопознанный.

Предупреждение! Ограничения самого Telegram, оплаты можно вывести не раньше чем, через 21 день после совершения покупки.

Пример настройки показан в видео выше.

Авторы инструкции: Андрей Горячих

Творческих взлётов и успешного внедрения.