Python Script
Python Script — действие, которое выполняет ваш Python-код внутри Nextbot. ИИ-модель решает, когда вызвать функцию со скриптом, а сам код выполняет платформа. Писать код самому не обязательно: его можно взять из шаблона или сгенерировать с помощью ИИ. Работает ли код, вы проверите тестом прямо в редакторе. Понимать каждую строку не нужно.
Что умеет скрипт
Обращаться к внешним сервисам: CRM, учётной системе, сайту. Например, узнать статус заказа в учётной системе и сообщить его клиенту.
Считать и проверять. Например, рассчитать стоимость заказа с учётом количества, размеров и скидок.
Отвечать клиенту напрямую, без ИИ-модели. Например, отправить точный текст с номером записи, который модель не перескажет по-своему.
Записывать переменные и ставить теги. Например, сохранить город клиента и отметить заявку тегом.
Управлять диалогом. Например, поставить диалог на паузу, переключить клиента на другого агента или уведомить администратора о новой заявке.
Для работы с Google Таблицами в скрипте доступен пакет gspread. Список всех пакетов — в статье «Как устроен Python-скрипт».
Когда выбирать скрипт
Не каждую задачу стоит решать кодом. Выбирайте самый простой способ, который с ней справится.
Передать данные в сервис, для которого в Nextbot есть готовая интеграция, например в amoCRM, Битрикс24 или Google Calendar
Отправить данные одним запросом в сервис без готовой интеграции, например заявку в свою CRM
Получать данные, когда в сервисе что-то произошло, например заказ сменил статус
Запросить данные из сервиса по ходу диалога, например статус заказа по номеру
Python Script
Посчитать по своим правилам, например стоимость заказа со скидкой
Python Script
Обработать данные, прежде чем передать их в CRM, например проверить телефон и привести его к одному формату
Python Script
Обратиться к нескольким сервисам за один раз, например найти адрес клиента в одном сервисе и ближайший филиал в другом
Python Script
Хранить историю клиента между обращениями
Запускать свою логику постоянно или по расписанию
Собственный сервер
Использовать возможности, которых нет в Nextbot
Собственный сервер
Сколько это стоит
Python Script доступен на тарифе «Бизнес» и выше.
Вызов скрипта
От 0,01 до 0,50 BotCoin за вызов, в зависимости от времени выполнения. Цена одинакова для обеих версий
Тестовый запуск
Как вызов скрипта
Генерация кода с ИИ
Зависит от уровня рассуждений и сложности скрипта. Чем выше уровень, тем дороже
Стоимость вызова показана в шапке редактора скрипта, рядом с надписью «Код функции».
Где запускается скрипт
Действие Python Script можно добавить в трёх местах:
в функцию — скрипт выполняется, когда ИИ-модель вызывает функцию как инструмент;
в сценарий — скрипт выполняется, когда сценарий срабатывает и доходит до этого шага;
в обработку формы персональных данных — скрипт выполняется, когда клиент отправил форму.
В функции ИИ-модель сразу получает результат скрипта и отвечает с его учётом. В сценарии модель результат не видит. В форме результат попадает в диалог, и модель учтёт его в следующем ответе. Подробнее — в статье «Как устроен Python-скрипт».
Если агент должен ответить клиенту по результату скрипта, начните с функции.
С чего начать
Если вы впервые настраиваете скрипт
Пройдите два шага по порядку. Знать Python не нужно: статьи ведут от задачи до работающего скрипта.
Проверьте, нужен ли вам скрипт. Найдите свою задачу в таблице раздела «Когда выбирать скрипт»:
подходит готовая интеграция, вебхук или Custom API — скрипт не нужен;
нужен собственный сервер — переходите к разделу «Создание сервера для решения нестандартных задач»;
подходит Python Script — переходите к следующему шагу.
Настройте скрипт — откройте статью «Настройка и тестирование скрипта» и идите по шагам.
Если вы уже работали со скриптами
Открывайте нужную статью, когда возникнет вопрос:
«Шаблоны Python Script» — готовые заготовки для типовых задач и как их доработать;
«Как устроен Python-скрипт» — какие данные получает скрипт, что он может вернуть, какие библиотеки доступны и какие есть ограничения;
«Запрос библиотеки» — что делать, если нужного пакета нет.
Дополнительные материалы
Для сложных задач и старых скриптов:
«Кастомные интеграции» — универсальный алгоритм разработки нестандартных интеграций и разборы реальных проектов;
«Создание сервера для решения нестандартных задач» — когда возможностей скрипта не хватает и нужен свой сервер;
«Python Script v1 (Устаревшее)» — инструкции для скриптов, созданных на старой версии.
Last updated
Was this helpful?