Тема
Функции
Функции — это действия которые бот может выполнить во время диалога. Например: создать сделку в CRM, вызвать внешний API, отправить уведомление менеджеру.
Как это работает
- Вы создаёте функцию и описываете когда её вызывать
- Бот сам решает когда вызвать функцию (на основе контекста диалога)
- При вызове бот собирает нужные параметры у клиента
- Выполняет действие и продолжает диалог
Создание функции
Два способа:
Вручную
- Нажмите «Создать с базовыми настройками»
- Введите имя (латиница, snake_case):
create_deal,send_notification - Опишите по-русски что делает функция и когда вызывать
- Добавьте параметры и действия
С помощью ИИ
- Нажмите «Сгенерировать с помощью ИИ»
- Опишите своими словами: «Когда клиент хочет записаться на просмотр квартиры, собери ФИО, дату и время, и отправь уведомление менеджеру»
- ИИ создаст функцию с правильным именем, параметрами и действиями
Параметры
Параметры — данные которые бот собирает у клиента перед вызовом функции.
| Тип | Пример | Описание |
|---|---|---|
| text | Имя клиента, адрес | Любой текст |
| number | Бюджет, количество | Число |
| enum | Город (Москва/СПб/Казань) | Выбор из списка |
Каждый параметр может быть обязательным или опциональным.
Пример
Функция book_viewing (запись на просмотр):
client_name(text, обязательный) — «Имя клиента»preferred_date(text, обязательный) — «Удобная дата»phone(text, обязательный) — «Номер телефона»comment(text, опциональный) — «Дополнительные пожелания»
Действия
Что происходит когда функция вызвана:
| Действие | Описание |
|---|---|
| Создать сделку в CRM | Создаёт сделку в Bitrix24 или amoCRM с данными клиента |
| Отправить сообщение | Бот отправляет фиксированный текст клиенту |
| Custom API | Вызывает ваш API (URL, метод, заголовки, тело запроса) |
| Пауза диалога | Передаёт диалог менеджеру (бот замолкает) |
Тест API
Перед подключением внешнего API — протестируйте его:
- Укажите URL, метод, заголовки, тело запроса
- Нажмите «Тест»
- Увидите статус, время ответа, заголовки и тело ответа
Реакция на выполнение
После выполнения функции бот может:
- Ответить по инструкции — вы пишете что бот должен сказать
- Ответить самостоятельно — бот сам сформирует ответ на основе результата
Важно знать
- Описание каждой функции всегда в контексте бота — чем больше функций, тем больше входных токенов (= больше расход Sol)
- Вызов функции сам по себе бесплатный (0 Sol), но LLM-запрос для принятия решения о вызове — платный
- Можно включать/выключать функции без удаления