Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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 не нужно: статьи ведут от задачи до работающего скрипта.

  1. Проверьте, нужен ли вам скрипт. Найдите свою задачу в таблице раздела «Когда выбирать скрипт»:

  2. Настройте скрипт — откройте статью «Настройка и тестирование скрипта» и идите по шагам.

Если вы уже работали со скриптами

Открывайте нужную статью, когда возникнет вопрос:

Дополнительные материалы

Для сложных задач и старых скриптов:

Last updated

Was this helpful?