> For the complete documentation index, see [llms.txt](https://doc.nextbot.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.nextbot.ru/functional/python-script.md).

# Python Script

Python Script — действие, которое выполняет ваш Python-код внутри Nextbot. ИИ-модель решает, когда вызвать функцию со скриптом, а сам код выполняет платформа. Писать код самому не обязательно: его можно взять из шаблона или сгенерировать с помощью ИИ. Работает ли код, вы проверите тестом прямо в редакторе. Понимать каждую строку не нужно.

## Что умеет скрипт

* **Обращаться к внешним сервисам: CRM, учётной системе, сайту.** Например, узнать статус заказа в учётной системе и сообщить его клиенту.
* **Считать и проверять.** Например, рассчитать стоимость заказа с учётом количества, размеров и скидок.
* **Отвечать клиенту напрямую, без ИИ-модели.** Например, отправить точный текст с номером записи, который модель не перескажет по-своему.
* **Записывать переменные и ставить теги.** Например, сохранить город клиента и отметить заявку тегом.
* **Управлять диалогом.** Например, поставить диалог на паузу, переключить клиента на другого агента или уведомить администратора о новой заявке.

Для работы с Google Таблицами в скрипте доступен пакет `gspread`. Список всех пакетов — в статье [«Как устроен Python-скрипт»](https://doc.nextbot.ru/functional/python-script/spravochnik-python-script-v2.md).

## Когда выбирать скрипт <a href="#kogda-vybirat-skript" id="kogda-vybirat-skript"></a>

Не каждую задачу стоит решать кодом. Выбирайте самый простой способ, который с ней справится.

| Что нужно сделать                                                                                                          | Какой инструмент выбрать                                                                                                       |
| -------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| Передать данные в сервис, для которого в Nextbot есть готовая интеграция, например в amoCRM, Битрикс24 или Google Calendar | [Готовая интеграция](https://doc.nextbot.ru/functional/integrations.md)                                                        |
| Отправить данные одним запросом в сервис без готовой интеграции, например заявку в свою CRM                                | [Custom API](https://doc.nextbot.ru/functional/functions/sending-result/custom-api.md)                                         |
| Получать данные, когда в сервисе что-то произошло, например заказ сменил статус                                            | [Вебхуки](https://doc.nextbot.ru/functional/integrations/vebkhuki.md)                                                          |
| Запросить данные из сервиса по ходу диалога, например статус заказа по номеру                                              | Python Script                                                                                                                  |
| Посчитать по своим правилам, например стоимость заказа со скидкой                                                          | Python Script                                                                                                                  |
| Обработать данные, прежде чем передать их в CRM, например проверить телефон и привести его к одному формату                | Python Script                                                                                                                  |
| Обратиться к нескольким сервисам за один раз, например найти адрес клиента в одном сервисе и ближайший филиал в другом     | Python Script                                                                                                                  |
| Хранить историю клиента между обращениями                                                                                  | [Собственный сервер](https://doc.nextbot.ru/functional/python-script/sozdanie-servera-dlya-resheniya-nestandartnykh-zadach.md) |
| Запускать свою логику постоянно или по расписанию                                                                          | Собственный сервер                                                                                                             |
| Использовать возможности, которых нет в Nextbot                                                                            | Собственный сервер                                                                                                             |

## Сколько это стоит <a href="#skolko-eto-stoit" id="skolko-eto-stoit"></a>

Python Script доступен на тарифе «Бизнес» и выше.

| Что                 | Стоимость                                                                                              |
| ------------------- | ------------------------------------------------------------------------------------------------------ |
| Вызов скрипта       | От 0,01 до 0,50 BotCoin за вызов, в зависимости от времени выполнения. Цена одинакова для обеих версий |
| Тестовый запуск     | Как вызов скрипта                                                                                      |
| Генерация кода с ИИ | Зависит от уровня рассуждений и сложности скрипта. Чем выше уровень, тем дороже                        |

Стоимость вызова показана в шапке редактора скрипта, рядом с надписью **«Код функции»**.

## Где запускается скрипт

Действие Python Script можно добавить в трёх местах:

* **в** [**функцию**](https://doc.nextbot.ru/functional/functions/create-function.md) — скрипт выполняется, когда ИИ-модель вызывает функцию как инструмент;
* **в** [**сценарий**](https://doc.nextbot.ru/functional/scenarii.md) — скрипт выполняется, когда сценарий срабатывает и доходит до этого шага;
* **в обработку** [**формы персональных данных**](https://doc.nextbot.ru/functional/functions/sending-result/forma-personalnykh-dannykh.md) — скрипт выполняется, когда клиент отправил форму.

В функции ИИ-модель сразу получает результат скрипта и отвечает с его учётом. В сценарии модель результат не видит. В форме результат попадает в диалог, и модель учтёт его в следующем ответе. Подробнее — в статье [«Как устроен Python-скрипт»](https://doc.nextbot.ru/functional/python-script/spravochnik-python-script-v2.md).

Если агент должен ответить клиенту по результату скрипта, начните с функции.

## С чего начать

### Если вы впервые настраиваете скрипт

Пройдите два шага по порядку. Знать Python не нужно: статьи ведут от задачи до работающего скрипта.

1. **Проверьте, нужен ли вам скрипт.** Найдите свою задачу в таблице раздела [«Когда выбирать скрипт»](#kogda-vybirat-skript):
   * подходит готовая интеграция, вебхук или Custom API — скрипт не нужен;
   * нужен собственный сервер — переходите к разделу [«Создание сервера для решения нестандартных задач»](https://doc.nextbot.ru/functional/python-script/sozdanie-servera-dlya-resheniya-nestandartnykh-zadach.md);
   * подходит Python Script — переходите к следующему шагу.
2. **Настройте скрипт** — откройте статью [«Настройка и тестирование скрипта»](https://doc.nextbot.ru/functional/python-script/nastroika-i-testirovanie-skripta.md) и идите по шагам.

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

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

* [**«Шаблоны Python Script»**](https://doc.nextbot.ru/functional/python-script/shablony-python-script.md) — готовые заготовки для типовых задач и как их доработать;
* [**«Как устроен Python-скрипт»**](https://doc.nextbot.ru/functional/python-script/spravochnik-python-script-v2.md) — какие данные получает скрипт, что он может вернуть, какие библиотеки доступны и какие есть ограничения;
* [**«Запрос библиотеки»**](https://doc.nextbot.ru/functional/python-script/zapros-biblioteki.md) — что делать, если нужного пакета нет.

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

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

* [**«Кастомные интеграции»**](https://doc.nextbot.ru/functional/python-script/kastomnye-integracii.md) — [универсальный алгоритм](https://doc.nextbot.ru/functional/python-script/kastomnye-integracii/universalnyi-algoritm-po-razrabotke-kastomnykh-integracii.md) разработки нестандартных интеграций и разборы реальных проектов;
* [**«Создание сервера для решения нестандартных задач»**](https://doc.nextbot.ru/functional/python-script/sozdanie-servera-dlya-resheniya-nestandartnykh-zadach.md) — когда возможностей скрипта не хватает и нужен свой сервер;
* [**«Python Script v1 (Устаревшее)»**](https://doc.nextbot.ru/functional/python-script/python-script-v1-ustarevshee.md) — инструкции для скриптов, созданных на старой версии.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://doc.nextbot.ru/functional/python-script.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
