Функции бота: как научить его создавать сделки, слать отчёты и запросы
Функции — действия, которые бот выполняет по ходу разговора: создать сделку в CRM, отправить отчёт в Telegram, вызвать ваш адрес по API, прислать файл или передать диалог.
Обновлено:
Функция — это правило вида «если случилось X, сделай Y». Например: «Если клиент готов сделать заказ, соберите имя и телефон и передайте менеджеру». Функции находятся в кабинете бота в разделе «Функции».
Как создать функцию
- Нажмите «Добавить функцию» и дайте название.
- В описании объясните боту, когда её вызывать.
- Добавьте параметры: что бот должен узнать у клиента до вызова (имя, телефон, дата). Для каждого укажите название, тип (текстовый или числовой), подсказку для ИИ и обязательность.
- Выберите, что произойдёт при вызове (блок «Отправка результатов»).
- Выберите реакцию: ничего не отправлять, отправить заданное сообщение, дать боту инструкцию или позволить ИИ решить самому.
- Включите функцию. Выключенную бот не использует.
Что функция умеет
| Действие | Что делает |
|---|---|
| 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]