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

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

Обновлено:

Функция — это правило вида «если случилось 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, где ключи — названия параметров:

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

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

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

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

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

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

Проверка

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

Не нашли ответ?

Напишите в поддержку: чаще всего отвечаем в течение рабочего дня. Написать в WhatsApp · [email protected]

Эта страница в Markdown