# Функции бота: как научить его создавать сделки, слать отчёты и запросы

Функции — действия, которые бот выполняет по ходу разговора: создать сделку в CRM, отправить отчёт в Telegram, вызвать ваш адрес по API, прислать файл или передать диалог.

Обновлено: 14 ноября 2026 г. · https://onswer.ai/docs/bot/functions · Onswer

Функция — это правило вида «если случилось X, сделай Y». Например: «Если клиент готов сделать заказ, соберите имя и телефон и передайте менеджеру». Функции находятся в кабинете бота в разделе «Функции».

## Как создать функцию

1. Нажмите «Добавить функцию» и дайте название.
2. В **описании** объясните боту, когда её вызывать.
3. Добавьте **параметры**: что бот должен узнать у клиента до вызова (имя, телефон, дата). Для каждого укажите название, тип (текстовый или числовой), подсказку для ИИ и обязательность.
4. Выберите, **что произойдёт** при вызове (блок «Отправка результатов»).
5. Выберите **реакцию**: ничего не отправлять, отправить заданное сообщение, дать боту инструкцию или позволить ИИ решить самому.
6. Включите функцию. Выключенную бот не использует.

## Что функция умеет

| Действие | Что делает |
|---|---|
| CRM, amoCRM, Bitrix24 | Создаёт сделку в подключённой CRM. Повторная заявка из того же чата станет примечанием к той же сделке |
| Отчёт в Telegram | Присылает сообщение в ваш Telegram |
| Свой запрос (Custom API) | Отправляет данные на ваш адрес, например в вашу систему. Заголовки (в том числе ключи) хранятся зашифрованными |
| Google Calendar | Работает с календарём |
| Отправка файла | Присылает клиенту прикреплённый файл |

Для CRM можно указать, в какое поле сделки записать каждый параметр. Параметры, для которых поле не выбрано, определяются по названию, остальное попадает в примечание сделки.

## Что делать после вызова

В блоке «Пост-сценарий» выберите: продолжать диалог, поставить бота на паузу, дополнить инструкции или сменить агента (передать чат другому боту).

## Пример: заявка на доставку в вашу систему

Задача: клиент пишет «хочу заказать доставку», бот собирает данные и отправляет заявку на ваш сервер. Клиент получает номер заказа.

**1. Название и описание.** Название: «Заявка на доставку». Описание (по нему бот решает, когда вызвать функцию): «Вызывай, когда клиент хочет оформить доставку и назвал адрес и удобную дату».

**2. Параметры:**

| Название | Тип | Подсказка для ИИ | Обязательный |
|---|---|---|---|
| name | текстовый | Имя клиента | да |
| phone | текстовый | Телефон для курьера, в формате +7… | да |
| address | текстовый | Адрес доставки с улицей и домом | да |
| date | текстовый | Дата доставки, например 20 ноября | да |
| comment | текстовый | Пожелания к заказу, если клиент их назвал | нет |

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

**3. Отправка результатов → «Custom API».** Адрес: `https://shop.example.kz/api/orders`, метод POST. В заголовок добавьте ключ вашей системы, например `Authorization: Bearer …`. Ключ хранится зашифрованным, в кабинете после сохранения его не видно.

Бот отправит на этот адрес JSON, где ключи — названия параметров:

```json
{
  "name": "Динара",
  "phone": "+77011234567",
  "address": "Алматы, ул. Абая 10, кв. 5",
  "date": "20 ноября",
  "comment": "позвонить за час"
}
```

При методе GET те же данные уходят в адресе (`?name=Динара&phone=…`). Сервер должен ответить за 10 секунд. Адреса внутренних сетей и localhost не принимаются.

**4. Реакция на выполнение функции → «ИИ-агент сам решит».** Бот видит ответ вашего сервера. Если сервер вернул `{"order_id": 1042}`, бот напишет клиенту что-то вроде «Заказ №1042 оформлен, курьер позвонит 20 ноября». Чтобы ответ был всегда одинаковым, выберите «Сообщение» и напишите текст сами.

**5. Пост-сценарий → «Продолжать диалог».** Если после заявки диалог должен вести менеджер, выберите «Поставить на паузу».

**6. Проверка.** Введите пример данных и нажмите «Показать, что уйдёт»: вы увидите адрес, метод и JSON, ничего не отправится. Затем «Выполнить по-настоящему» (кнопку нужно нажать дважды): запрос уйдёт на ваш сервер, и вы увидите его ответ.

Если ваш сервер ответил ошибкой или не ответил, бот не обещает клиенту, что заказ оформлен: он говорит, что заявку передали человеку, и отдаёт чат менеджеру. Одна и та же заявка с теми же данными в течение суток повторно не отправляется.

## Проверка

В карточке функции есть блок «Проверка»: введите пример данных и нажмите «Показать, что уйдёт» (ничего не отправляется) или «Выполнить по-настоящему». Тестовая сделка в CRM называется «Проверка: ...», файл при проверке никому не отправляется.

> **Совет:** Если вам нужна просто заявка в CRM, обычно хватает [интеграции с amoCRM](/docs/integrations/amocrm) или [Bitrix24](/docs/integrations/bitrix24): контакт и сделка создаются сами. Функции нужны для нестандартных сценариев.
