С помощью функции, разработанной командой Salebot, чат-бот ИИ прекрасно понимает введенные в таблицу значения, а затем записывает их в системную переменную в настройках проекта.
Например, это может понадобится для AI-ассистента, который будет консультировать ваших клиентов по имеющемуся ассортименту товаров в вашем интернет-магазине, а также для рекламы умным ботом ваших возможностей.
Как именно использовать чтение google-таблицы ботом - решать только Вам, а мы в свою очередь покажем, как оформить таблицу и настроить бота на работу с ней.
Подготовка таблицы
Для начала перейдите в раздел таблицы:
Далее вы увидите кнопку "Добавить таблицу", кликнув по которой откроется модальное окошко, в котором нужно ввести название таблицы:
Пропишите название для таблицы и кликните на кнопку "Готово". Тогда новая таблица будет создана в проекте и появится в разделе "Таблицы":
Настройки таблицы
После того как вы создали таблицу, необходимо добавить строки и колонки. Для этого на плашке нужной таблицы найдите кнопку "Перейти" и кликните по ней.
Вы увидите следующие настройки:
Чтобы добавить столбец с названием, нажмите "Плюс":
при клике на кнопку появится модальное окно, в котором нужно прописать название для добавляемого столбца:
После того как вы прописали название столбца, кликните по кнопке "Готово", тогда новый столбец добавится в таблицу. Добавьте необходимое количество столбцов, а затем строк:
Теперь наша таблица выглядит следующим образом:
Скопируйте (запомните) ID таблицы: для этого нажмите на адресную строку:
Теперь перейдем к настройкам блоков в конструкторе.
Работа в конструкторе воронок
Функция get_records_from_table()
Для того чтобы использовать функцию get_records_from_table(), понадобится один блок в конструкторе воронок.
Перейдите в соответствующую вкладку в Salebot и создайте блок с условием (стартовое условие или не состояние с условием):
Назначьте переменную (она понадобится для знаний AI-ассистента): в примере это переменная 'online_shop'.
Пример кода из калькулятора:
project.****online_shop``=``get_records_from_table(5)
project. - конструкция для записи переменной в настройки проекта;online_shop - название переменной;-
get_records_from_table(5) - функция, где передан параметр в виде ID таблицы.
get_records_from_table(table_id, start_row, count, start_col, end_col) - получение записи из таблицы
| Параметр | Описание | Примечание |
|---|---|---|
| ! table_id | id таблицы (обязательный параметр) | |
| start_row | необязательный параметр, целое число. Указывает начало диапазона строк. | Передается номер строки, с которой включительно необходимо прочесть значения таблицы. Указывается без кавычек. |
| count | необязательный параметр, целое число. Указывает количество строк, которое нужно получить | По умолчанию - 1000, максимум - 5000. Указывается без кавычек. |
| start_col | необязательный параметр, строка. Указывает начало диапазона столбцов | Передается название колонки, с которой включительно необходимо прочесть значения таблицы. Указывается в кавычках |
| end_col | необязательный параметр, строка. Указывает конец диапазона столбцов | Передается название колонки, до которой включительно необходимо прочесть значения таблицы. Указывается в кавычках. |
Если указать только начало диапазона строк/столбцов, то будут получены все данные от указанного значения без ограничения по концу диапазона. Аналогично можно не указывать начало диапазона, указав только конец.
Пропишем в сообщении вместо #{none} нашу переменную через конструкцию #{}, чтобы наглядно увидеть, какие данные записались в переменную проекта.
Обращаем внимание!
Переменная, вложенная в сообщении, необходима для проверки чтения ботом функции.
При запуске блока в режиме тестирования бот покажет значения, которые будут вложены в переменную.
Обращаем внимание!
После настроек вызова блока в режиме тестирования и сохранения переменной в настройках проекта, не удаляйте данный блок.
Он может понадобится: например, если вы добавили еще какие-либо значения в таблицу, просто запустите блок в тестовом режиме. Тогда данные в переменной проекта обновятся.
Название переменной может быть любое, удобное вам.
Блок для передачи данных
Далее создадим блок "Состояние" для передачи данных в карточку клиента
Можно также в данном блоке передать завершающее сообщение от бота, например, "Спасибо за заказ! Передаю данные менеджеру по связи!":
Далее скопируйте ID блока - он понадобится для настройки AI-ассистента в команде "вызываю блок 31241050" , где вместо ID блока из примера вам необходимо вставить ID своего блока.
Важно!
После тестирования замените "вызываю блок 31241050" на команду "start_block_from_ai 31241050".
Команда "вызываю блок 31241050" является отладочной и понадобится для понимания того, какие данные записывает бот (см. параграф "Тестирование").
Для запуска бота для клиентов прописывайте команду "start_block_from_ai 31241050".
Чтение таблицы
Теперь перейдите в тестирование бота и запустите блок с условием:
Таким образом, блок отработался верно: вы видите значения, которые лежат в переменной в настройках проекта.
В этом можно убедиться, перейдя в соответствующий раздел:
Во вкладке "Переменные" в настройках проекта вы увидите свою переменную с вложенными в нее значениями из таблицы. Таким образом, теперь внутри вашего проекта существует переменная с товарами, стоимостью и всем тем, что вы указали в таблице.
Работа в AI-ассистенте
Переходим в раздел "AI-ассистент" и приступаем к настройке чат-бота с ИИ
Роль ассистента: продажник
Также установим дополнительные настройки:
Настройки AI-ассистента
В настройках бота прописываем следующие данные:
- Должность и инструкции для бота.
- Команда для вызова блока и передачи переменных в систему прописывается следующим образом:
Знания бота
В поле "Знания бота" передайте переменную, которую ранее закешировали блоком с условием:
Знания бота:
Так бот будет брать информацию из переменной, лежащей в настройках проекта, и консультировать ваших клиентов по поводу имеющегося ассортимента.
Сохраняемые переменные
В формате передаваемых данных вы прописываете собственно сами собираемые данные (например, товар), далее прописывается фразу с "ключом" и присваиваете значение ключу:
Так переменные при вызове блока будут передаваться в карточку клиента: далее вы сможете работать с переменными, например, в конструкторе:
Поскольку в формате передаваемых данных мы объявили переменную payment_sum, при подключенных платежных сервисах вы сможете выдавать ссылку на оплату прямо в боте:
При объявлении переменной payment_sum сумма ссылка на оплату генерируется автоматически!
Не подходит для ю/л и ИП с НДС.
Настоятельно рекомендуем выдавать ссылку на оплату после проверки суммы оплаты менеджером во избежании неточностей!
На этом настройка AI-ассистента завершена.
Остальные параметры можно выставить по-своему усмотрению.
Тестирование бота
Если у вас уже работают боты, то укажите в условии запуска АИ-ассистента запуск только в окне тестирования.
Шаг 1. Кликните по конструктору условий
Шаг 2. Выберите вкладку с тестовым окном и кликните "Добавить":
Теперь в условии для запуска вы видите следующее значение:
Так бот будет запускаться только в тестовом окне и нигде больше.
После отладки работы бота, уберите данное условие.
В примере мы протестируем прямо в мессенджере:
В схеме мы создали блоки для формирования ссылки на оплату и реакции на колбек об успешной оплате.
АИ-ассистент вызывает блок для формирования ссылки на оплату, затем отправляется блок с кнопкой:
Далее после успешной оплаты приходит колбек в диалоге с клиентом (колбек пользователь не видит):
Обратите внимание, что на примере выше, видно, где отработал AI, а где бот из конструктора.
- Серые сообщения — сообщения AI-ассистента;
- Синие — сообщения из блоков в конструкторе.
На данный колбек настроена реакция в блоке с условием:
Не направляйте ссылку на оплату без тестирования платежей!
Подробнее о настройках каждой платежной системы рассказали в разделе "Эквайринг".
Данное сообщение отправляется в режиме тестирования из-за команды "вызываю блок 31241050"
После тестирования и отладки работы бота, прописывайте команду в настройках бота "start_block_from_ai 31241050".
Таким образом вы можете создать интернет-магазин любого вида, использовать любые необходимые значения внутри таблицы.
Основное ограничение - только Ваша фантазия!