Настройка ЮKassa и Prodamus в ИИ-агенте: базовая оплата, колл-бэки по статусам платежа, чеки, скидка и рассрочка Продамуса, расширенная оплата через «Действия».
ЮKassa и Продамус подключаются во вкладке «Интеграции» → «Платёжные системы». Базовая функция ЮKassa задаёт сумму, описание, ссылку возврата и число стадий оплаты, а три колл-бэка отвечают на успех, отказ и ожидание подтверждения. Продамус добавляет скидку, лимит оплат по ссылке, срок жизни ссылки и рассрочку. Расширенная оплата через «Действия» передаёт сумму аргументом и кладёт ссылку в переменную для другого сервиса.
Клиент уже написал «оплачу сейчас» — и тут менеджер лезет в личный кабинет ЮKassa, копирует старую ссылку из прошлого чата, проверяет, не истёк ли у неё срок, вставляет в переписку и уточняет, туда ли она вообще ведёт. Пока это происходит, клиент смотрит в экран и ждёт, хотя всё, что от него требовалось, — согласиться.
На деле в двух системах платежей нет ничего загадочного, если разложить настройку по шагам: что задаёт сама платформа, что добавляет каждый сервис сверху и где проходит граница между базовым и расширенным режимом.
Обе системы живут в одном месте — вкладка «Интеграции», категория «Платёжные системы». ЮKassa подключается стандартной авторизацией сервиса, и сразу после этого платформа открывает панель настроек оплаты.
Базовая функция создания оплаты рассчитана на фиксированную сумму: включаете флаг «Включить базовую функцию создания оплаты» и заполняете четыре поля — сумма платежа, описание платежа, ссылка для возврата после оплаты и выбор между приёмом платежа в одну или в две стадии (в интерфейсе это поле подписано «Автоматический приём поступившего платежа»). Двухстадийная схема сначала блокирует сумму на карте, а списывает её только после отдельного подтверждения. Так удобно, когда между согласием клиента и фактическим оказанием услуги проходит время.
Проверьте на своих диалогах.Регистрация без карты, 500 ₽ на тест по промокоду BLOG500
Собрать агентаУ ЮKassa три колл-бэка: платёж прошёл успешно, платёж отклонён, платёж принят и ожидает подтверждения магазина. Каждый настраивается отдельно, и без настроенного колл-бэка агент просто не узнаёт, что произошло по ссылке дальше.
На каждое из трёх событий назначается один из четырёх вариантов ответа клиенту.
| Вариант ответа | Что происходит |
|---|---|
| Фиксированное сообщение | Агент отправляет заранее заданный текст, одинаковый для всех клиентов |
| Сообщение по инструкции | Агент формулирует ответ сам, опираясь только на написанную инструкцию |
| Инструкция с учётом базы знаний | Агент учитывает инструкцию к колл-бэку, основную инструкцию и базу знаний целиком: ответ выходит точнее и персональнее |
| Прямой вопрос | Клиенту приходит готовый файл из раздела «Прямые вопросы» |
Один и тот же список из четырёх вариантов работает и для колл-бэков Продамуса: платформа не делает разных механизмов ответа под разные платёжные системы.
Чек в ЮKassa не идёт автоматически при каждом платеже: отправка настраивается отдельно от суммы и описания. Выбирается способ отправки (email или телефон), и перед ссылкой на оплату агент отдельным сообщением запрашивает у клиента нужный контакт — текст запроса можно переписать под свой тон.
Дальше в настройках выбираются предмет расчётов из готового списка (товар, услуга, работа и другие варианты фискализации) и тип платежа. Количество единиц указывается вручную, по умолчанию расчёт идёт от одной. Для разовой консультации это поле остаётся как есть, а число меняют на нужное только при оплате партии одинаковых позиций.
У Продамуса вход другой: понадобятся поддомен и секретный ключ, которые берутся на стороне сервиса, а не логин с паролем. После успешного подключения открывается выбор валюты расчётов.
Дальше логика создания оплаты похожа на ЮKassa, но с расширенным набором полей:
| Поле Продамуса | Чем полезно |
|---|---|
| Скидка | Уменьшает сумму платежа прямо в ссылке, без пересчёта вручную |
| Лимит оплат по ссылке | Ограничивает число раз, которое одну ссылку можно оплатить — важно для ссылок, разосланных группе |
| Время жизни ссылки (в минутах) | Ссылка перестаёт действовать по истечении срока, а не висит бессрочно |
| Ссылки возврата (успех и неуспех отдельно) | Клиент попадает на разные страницы в зависимости от результата оплаты |
| Рассрочка (тумблер) | Включает для клиента вариант платежа частями прямо в форме оплаты |
| Описание платежа | Короткий текст уходит в чек клиента, поле обязательно и в базовом, и в расширенном режиме |
| Описание для пользователя | Дополнительный текст, который клиент получает отдельно при успешной оплате |
Перед боевым запуском доступна кнопка «Получить тестовую ссылку»: у ЮKassa отдельной тестовой кнопки в интерфейсе нет, там проверка идёт через обычную ссылку с минимальной суммой.
Колл-бэков у Продамуса пять, а не три: к успешному платежу добавляются четыре статуса рассрочки — договор подписан, заявка одобрена, заявка отменена, заявка отклонена. Если рассрочку не включали, оставшиеся четыре колл-бэка можно не трогать вовсе.
Тумблер рассрочки в Продамусе включает только дополнительный вариант оплаты в форме: сумма, скидка и лимит по ссылке настраиваются так же, как без рассрочки. Отдельно донастроить нужно только четыре колл-бэка по статусам заявки.
Расширенная оплата нужна, когда услуг несколько с разными ценами или сумма складывается в самом разговоре, а не задана заранее: тогда цена приходит в шаг оплаты аргументом действия, и фиксированное поле не используется. Механика переключения та же, что и для оплаты в переписке: выключить базовый флаг, завести действие с аргументом суммы price и добавить шаг «ЮKassa» или «Продамус». Ссылку при этом необязательно отправлять клиенту напрямую — её можно положить в переменную payment_link и передать аргументом в шаг, который уходит вебхуком в рабочий чат с уведомлением о новом счёте.
Распишите на бумаге, сколько у вас реально вариантов цены. Одна фиксированная сумма на всё — хватит базовой функции и трёх её полей. Несколько услуг, скидка от суммы заказа или сумма, которую клиент называет сам, — тогда без расширенного режима и аргумента price не обойтись.
Начните с одной платёжной системы и одного колл-бэка — успешного платежа. Проверьте на нескольких тестовых диалогах, что ссылка приходит, а ответ клиенту после оплаты звучит так, как задумано, и только потом добавляйте отклонённый платёж, чеки или рассрочку Продамуса. Полный список настроек и полей обеих интеграций — в руководстве Савви, разделы ЮKassa и Продамус.
ЮKassa подключается стандартной авторизацией сервиса прямо из вкладки «Интеграции». Продамус просит два поля: поддомен и секретный ключ, которые берутся на стороне документации Продамуса, и после этого отдельно выбирается валюта расчётов.
Да, у ЮKassa в базовой функции есть переключатель между одностадийным и двухстадийным приёмом платежа. Двухстадийная схема сначала блокирует сумму на карте клиента, а списывает её только после отдельного подтверждения.
То, что настроено в колл-бэке «Платёж отклонён» — один из четырёх вариантов: фиксированный текст, сообщение по инструкции, инструкция с учётом базы знаний или прямой вопрос из готового файла. Без настроенного колл-бэка агент об отклонении не узнает и продолжит ждать оплату.
Лимит ограничивает число раз, которое ссылку можно оплатить. Это полезно, когда одна ссылка уходит в общий чат или рассылку и её не должны использовать повторно после первой успешной оплаты. У ЮKassa такого поля нет: там ссылка формируется под конкретный диалог.
Расширенная оплата нужна, если услуг несколько с разными ценами, сумма складывается в разговоре, а не задана заранее, или ссылку требуется отдать в другой сервис. Тогда сумма приходит в шаг оплаты аргументом действия, а не берётся из одного зафиксированного поля.
Да, через флаг «Поместить ссылку на оплату в переменную» в настройках шага. Переменная `payment_link` становится доступна как аргумент любого другого действия, например того, что отправляет уведомление в рабочий чат отдела продаж.