💡 Зачем нужна эта интеграция
Связка Telegram и ЮKassa превращает мессенджер в полноценный канал продаж: клиент выбирает товар или услугу, получает ссылку на оплату, платит картой, через СБП или ЮMoney и сразу получает подтверждение в том же чате. Для бизнеса это означает, что менеджеру больше не нужно вручную выставлять счета, сверять поступления и уточнять у клиента, прошёл ли платёж. Бот или автоматический сценарий создаёт платёж через API ЮKassa, отслеживает его статус и мгновенно реагирует на событие: отправляет чек, открывает доступ к закрытому каналу, выдаёт цифровой товар или передаёт заказ в работу.
Прямой «кнопочной» интеграции между Telegram и ЮKassa в виде готового коннектора нет, поэтому связь настраивается одним из трёх способов. Первый: через платформы-коннекторы, такие как Make, Zapier или APIX-Drive, где события ЮKassa (успешная оплата, отмена, возврат) запускают действия в Telegram без программирования. Второй: через встроенные платежи Telegram Bot API, где ЮKassa подключается как платёжный провайдер через @BotFather. Третий: через виджеты и модули из маркетплейсов CRM и конструкторов ботов (например, SaleBot, BotHelp, GetCourse, Albato), где подключение выполняется по Shop ID и секретному ключу.
Автоматизация решает типичные проблемы: потерю заявок из-за долгого ответа менеджера, ошибки при ручной проверке оплат, задержки с выдачей доступа и отсутствие прозрачной отчётности. Владелец получает мгновенные уведомления о платежах в рабочий чат, команда видит статусы заказов в реальном времени, а клиент остаётся в привычном мессенджере без переходов между сайтами. Это особенно полезно для онлайн-школ, сервисов по подписке, интернет-магазинов, студий услуг и авторов платного контента, а также помогает снизить долю брошенных корзин и ускорить оборот денег.
🛠️ Как настроить интеграцию
- **Подготовьте аккаунты и получите доступы.** Создайте бота в Telegram через @BotFather командой `/newbot` и сохраните токен. В личном кабинете ЮKassa убедитесь, что магазин прошёл проверку и активен, затем скопируйте Shop ID и создайте секретный ключ в разделе «Интеграция → Ключи API». Если нужны уведомления для команды, создайте рабочий чат или канал, добавьте туда бота как администратора и определите ID чата. Для тестирования включите в ЮKassa тестовый магазин и используйте тестовые ключи.
- **Выберите способ подключения.** Для сценария без кода зарегистрируйтесь в Make, Zapier или APIX-Drive. Для оплаты прямо внутри чата используйте платёжного провайдера в @BotFather: откройте `/mybots`, выберите бота, затем «Payments» и ЮKassa, после чего авторизуйте магазин и получите платёжный токен. Если вы работаете через конструктор ботов или CRM, найдите виджет ЮKassa в маркетплейсе и введите Shop ID и секретный ключ.
- **Настройте сценарий создания платежа.** В коннекторе создайте сценарий, где триггером служит сообщение боту, нажатие кнопки или новая сделка в CRM. Добавьте действие «Создать платёж» в ЮKassa: укажите сумму, валюту RUB, описание заказа, адрес возврата (return_url) и данные для чека по 54-ФЗ (email или телефон, наименование позиции, ставка НДС). Полученную ссылку на оплату передайте следующим шагом в Telegram: «Отправить сообщение» с кнопкой «Оплатить» для клиента.
- **Настройте обработку статусов и уведомления.** Создайте второй сценарий с триггером «Webhook ЮKassa» и подпишитесь на события `payment.succeeded`, `payment.canceled` и `refund.succeeded`. Укажите URL вебхука из коннектора в разделе «Интеграция → HTTP-уведомления» кабинета ЮKassa. Добавьте ветвление по статусу: при успешной оплате отправьте клиенту подтверждение и чек, выдайте инвайт-ссылку в закрытый канал или файл, обновите сделку в CRM и уведомите менеджера в рабочий чат; при отмене отправьте напоминание с новой ссылкой.
- **Протестируйте интеграцию и запустите в работу.** Подключите тестовые ключи, отправьте боту команду, пройдите оплату тестовой картой ЮKassa и убедитесь, что вебхук сработал, а сообщения пришли клиенту и в рабочий чат. Проверьте сценарии отмены платежа и возврата, корректность суммы, чека и статуса в CRM, а также историю выполнения в журнале коннектора. После успешных проверок замените тестовые ключи на боевые, проведите реальный платёж на минимальную сумму и включите мониторинг ошибок: уведомления о сбоях сценария и регулярную сверку платежей в кабинете ЮKassa.