Быстрый гайд для подключения и проверки Robokassa

Настоящее руководство представляет собой краткую пошаговую инструкцию, охватывающую весь цикл внедрения: подключение интеграции с Робокассой, конфигурацию прайс-листа, создание Функции через Мастер, тестирование функционала и запуск в production-режиме.

Если вам требуется более подробная информация о настройке интеграции и Функций, ознакомьтесь со следующими материалами:

• Подключение Robokassa

• Функции для работы с Robokassa

Подключение интеграции Robokassa

1. Убедитесь, что личный кабинет Робокассы настроен и Магазин создан

2. Перейдите в раздел Интеграции → Robokassa

3. Запустите Мастер подключения и следуйте пошаговым инструкциям, читая подсказки

4. (Опционально) Для тестирования перед запуском выберите в Мастере тестовый режим и укажите два тестовых пароля

5. На десятом шаге Мастера вам будет предложено создать прайс-лист. Инструкция по заполнению представлена ниже

   

Конфигурация и добавление прайс-листа

Настройте прайс-лист на шаге 10 Мастера подключения или на главной странице интеграции Robokassa.

Для добавления позиции нажмите «Новая позиция» и заполните:

• Название (уникальное)

• Цена (от 1 до 5 000 000)

⚠️ Будьте внимательны: позиция не будет добавлена при некорректном заполнении обязательных полей!

Прайс-лист обеспечивает ИИ-агента данными о товарах и ценах для генерации чеков. Логика работы определяется двумя факторами:

• Тип подгрузки данных (в параметры Функции, в промпт или через внешний источник)

• Количество позиций в одном чеке

Настройка способов подгрузки прайс-листа описана в следующем разделе.

Создание Функции через Мастер содания функций

По завершении подключения интеграции и формирования прайс-листа необходимо создать Функцию для обработки платежей.

⚠️Для формирования функции крайне рекомендуется использовать Мастер создания функций, поскольку самостоятельная настройка параметров может привести к некорректной работе интеграции.

1. Откройте «Интеграции» → Robokassa и нажмите «Мастер создания функций»

2. Следуйте пошаговым инструкциям, внимательно читая подсказки

3. Шаг 2: Определите количество позиций в чеке — одна или нескольк

4. Шаг 3: Выберите способ подгрузки прайс-листа:

   • В промпт — прайс-лист обновляется автоматически при любых изменениях

   • В параметры Функции — требуется пересоздание Функции при изменении цен

   • Без подгрузки — ИИ-агент использует цены из других источников (промпт, YClients и др.), но при формировании чека позиции сверяются с прайс-листом

5. Дополнительные настройки:

   • Должен ли ИИ-агент запрашивать количество товара (или всегда использовать «1»)

   • Должен ли ИИ-агент запрашивать e-mail клиента перед формированием чека

   После завершения Мастера Функция generate_payment_link будет создана и готова к тестированию. Переходите к следующему этапу.

Тестирование и отладка работы Robokassa

Чтобы изменить режим работы интеграции (тестовый/рабочий), используйте переключатель на главной странице интеграции.

Тестовый режим позволяет безопасно проверить работу интеграции без реальных транзакций.

Для его использования сначала сгенерируйте тестовые пароли в разделе «Технические настройки» кабинета Робокассы, затем укажите эти пароли в настройках интеграции Nextbot.

После этого перейдите в тестовый чат и от лица клиента попросите ИИ-агента сформировать чек на услугу\товар. Агент создаст платежную ссылку и отправит её в чат — перейдите по ссылке для завершения тестового платежа.

Вы будете перенаправлены на страницу тестовой оплаты. Проверьте все доступные способы оплаты и убедитесь, что они корректно обрабатываются системой.

Чтобы завершить тестовый платеж, выберите «Успешно». Система перенаправит вас на страницу успешной оплаты, указанную в настройках интеграции.

Финальный запуск Robokassa

После завершения всех тестов и проверки работы интеграции переключите режим работы с помощью переключателя Тестовый режим Robokassa на главной странице интеграции.

С этого момента ИИ-агент будет генерировать чеки для реальных платежей.