💡 Зачем нужна эта интеграция
Связка ЮKassa и Telegram превращает мессенджер в полноценный канал продаж и операционный центр. Клиент выбирает товар или услугу в чат-боте, получает ссылку на оплату, платит картой, через СБП или ЮMoney, а подтверждение приходит ему в тот же диалог за несколько секунд. Менеджеру не нужно вручную сверять поступления в личном кабинете ЮKassa и писать клиенту «Оплата получена». Для онлайн-школ, экспертов, студий, сервисов по подписке и небольших интернет-магазинов это самый короткий путь от обращения до денег.
Автоматизация закрывает сразу несколько задач. Во-первых, мгновенные уведомления: команда получает в рабочий Telegram-чат сообщение о каждом успешном платеже, возврате или отмене с суммой, номером заказа и контактами покупателя. Во-вторых, автоматическая выдача доступа: после оплаты бот отправляет ссылку на закрытый канал, чат, курс или файл, а по истечении подписки напоминает о продлении. В-третьих, сокращение потерь: если клиент создал платёж, но не завершил его, бот присылает напоминание с повторной ссылкой, что повышает конверсию. Ещё один плюс — меньше ошибок и «потерянных» заказов, потому что статусы платежей фиксируются автоматически.
Прямой «нативной» кнопки интеграции между ЮKassa и Telegram нет, но связать сервисы можно несколькими способами. Самый гибкий вариант — платформы-коннекторы **Make**, **Zapier** и **APIX-Drive**: они принимают уведомления (webhook) от ЮKassa и передают данные в Telegram-бота без программирования. Второй вариант — конструкторы ботов и официальные решения из маркетплейсов (например, SaleBot, BotHelp, GetCourse или виджеты в Bitrix24 и amoCRM), где подключение ЮKassa уже встроено. Третий вариант — собственный сервер, работающий с API ЮKassa и Bot API Telegram, когда нужна нестандартная логика.
🛠️ Как настроить интеграцию
- **Подготовьте аккаунты и доступы.** В личном кабинете ЮKassa убедитесь, что магазин прошёл проверку и подключён к приёму платежей. Перейдите в «Интеграция» → «Ключи API» и скопируйте **shopId** и **секретный ключ** (для начала удобнее использовать тестовый магазин). В Telegram откройте @BotFather, выполните команду /newbot, задайте имя бота и сохраните выданный **токен**. Если уведомления должны приходить в рабочую группу, добавьте бота в чат, назначьте его администратором и узнайте ID чата (например, через @getmyid_bot или метод getUpdates).
- **Выберите способ связки и создайте сценарий.** Зарегистрируйтесь в Make, Zapier или APIX-Drive. Если вы работаете с конструктором ботов или CRM, найдите ЮKassa в разделе «Платежи» или «Интеграции» маркетплейса и подключите её по shopId и секретному ключу. Для коннектора создайте новый сценарий: в качестве триггера выберите ЮKassa (событие «Платёж успешно завершён», payment.succeeded) или модуль Webhook, а в качестве действия — Telegram Bot с операцией «Отправить сообщение». Вставьте токен бота, чтобы авторизовать подключение.
- **Настройте приём уведомлений от ЮKassa.** Скопируйте URL вебхука из созданного сценария. В ЮKassa откройте «Интеграция» → «HTTP-уведомления», вставьте URL и отметьте события: payment.succeeded, payment.canceled, refund.succeeded (и при необходимости payment.waiting_for_capture). Сохраните настройки. Если вы создаёте платежи через API, передавайте в metadata идентификатор клиента Telegram (chat_id) и номер заказа, чтобы потом понимать, кому отправлять сообщение.
- **Настройте шаблоны сообщений и сопоставление полей.** В модуле Telegram укажите получателя: для клиента — chat_id из metadata платежа, для команды — ID рабочего чата. Составьте текст с подстановкой данных, например: «Оплата №{{order_id}} на сумму {{amount}} ₽ получена. Спасибо! Ваша ссылка на доступ: …». Для команды сделайте отдельное уведомление с суммой, способом оплаты и контактами покупателя. Добавьте фильтры или ветвление: успешная оплата — выдача доступа, отмена — сообщение с повторной ссылкой, возврат — уведомление бухгалтеру. При необходимости добавьте запись в Google Таблицу или CRM.
- **Протестируйте и запустите в работу.** Включите тестовый режим ЮKassa и создайте пробный платёж на небольшую сумму, используя тестовую карту из документации. Убедитесь, что вебхук сработал, в истории сценария нет ошибок, а сообщение пришло нужному получателю с правильными данными. Проверьте сценарии отмены и возврата. После успешных тестов замените тестовые shopId и ключ на боевые, обновите URL уведомлений, проведите один реальный платёж и при необходимости оформите возврат. Включите сценарий на постоянное выполнение и в первые дни следите за журналом запусков и ошибками.