Skip to content

Функции

Функции — это действия которые бот может выполнить во время диалога. Например: создать сделку в CRM, вызвать внешний API, отправить уведомление менеджеру.

Как это работает

  1. Вы создаёте функцию и описываете когда её вызывать
  2. Бот сам решает когда вызвать функцию (на основе контекста диалога)
  3. При вызове бот собирает нужные параметры у клиента
  4. Выполняет действие и продолжает диалог

Создание функции

Два способа:

Вручную

  1. Нажмите «Создать с базовыми настройками»
  2. Введите имя (латиница, snake_case): create_deal, send_notification
  3. Опишите по-русски что делает функция и когда вызывать
  4. Добавьте параметры и действия

С помощью ИИ

  1. Нажмите «Сгенерировать с помощью ИИ»
  2. Опишите своими словами: «Когда клиент хочет записаться на просмотр квартиры, собери ФИО, дату и время, и отправь уведомление менеджеру»
  3. ИИ создаст функцию с правильным именем, параметрами и действиями

Параметры

Параметры — данные которые бот собирает у клиента перед вызовом функции.

ТипПримерОписание
textИмя клиента, адресЛюбой текст
numberБюджет, количествоЧисло
enumГород (Москва/СПб/Казань)Выбор из списка

Каждый параметр может быть обязательным или опциональным.

Пример

Функция book_viewing (запись на просмотр):

  • client_name (text, обязательный) — «Имя клиента»
  • preferred_date (text, обязательный) — «Удобная дата»
  • phone (text, обязательный) — «Номер телефона»
  • comment (text, опциональный) — «Дополнительные пожелания»

Действия

Что происходит когда функция вызвана:

ДействиеОписание
Создать сделку в CRMСоздаёт сделку в Bitrix24 или amoCRM с данными клиента
Отправить сообщениеБот отправляет фиксированный текст клиенту
Custom APIВызывает ваш API (URL, метод, заголовки, тело запроса)
Пауза диалогаПередаёт диалог менеджеру (бот замолкает)

Тест API

Перед подключением внешнего API — протестируйте его:

  1. Укажите URL, метод, заголовки, тело запроса
  2. Нажмите «Тест»
  3. Увидите статус, время ответа, заголовки и тело ответа

Реакция на выполнение

После выполнения функции бот может:

  • Ответить по инструкции — вы пишете что бот должен сказать
  • Ответить самостоятельно — бот сам сформирует ответ на основе результата

Важно знать

  • Описание каждой функции всегда в контексте бота — чем больше функций, тем больше входных токенов (= больше расход Sol)
  • Вызов функции сам по себе бесплатный (0 Sol), но LLM-запрос для принятия решения о вызове — платный
  • Можно включать/выключать функции без удаления

AI Business Platform