С помощью функции, разработанной командой Salebot, чат-бот ИИ прекрасно понимает введенные в таблицу значения, а затем записывает их в системную переменную в настройках проекта.

Например, это может понадобится для AI-ассистента, который будет консультировать ваших клиентов по имеющемуся ассортименту товаров в вашем интернет-магазине, а также для рекламы умным ботом ваших возможностей.

Как именно использовать чтение google-таблицы ботом - решать только Вам, а мы в свою очередь покажем, как оформить таблицу и настроить бота на работу с ней.

Подготовка таблицы

Для начала перейдите в раздел таблицы:

Далее вы увидите кнопку «Добавить таблицу», кликнув по которой откроется модальное окошко, в котором нужно ввести название таблицы:

Пропишите название для таблицы и кликните на кнопку «Готово». Тогда новая таблица будет создана в проекте и появится в разделе «Таблицы»:

Настройки таблицы

После того как вы создали таблицу, необходимо добавить строки и колонки. Для этого на плашке нужной таблицы найдите кнопку «Перейти» и кликните по ней.

Вы увидите следующие настройки:

Чтобы добавить столбец с названием, нажмите «Плюс»:

При клике на кнопку появится модальное окно, в котором нужно прописать название для добавляемого столбца:

После того как вы прописали название столбца, кликните по кнопке «Готово», тогда новый столбец добавится в таблицу. Добавьте необходимое количество столбцов, а затем строк:

Теперь наша таблица выглядит следующим образом:

Скопируйте (запомните) ID таблицы: для этого нажмите на адресную строку:

Теперь перейдем к настройкам блоков в конструкторе.

Работа в конструкторе воронок

Функция get_records_from_table()

Для того чтобы использовать функцию get_records_from_table(), понадобится один блок в конструкторе воронок.

Перейдите в соответствующую вкладку в Salebot и создайте блок с условием (стартовое условие или не состояние с условием):

Назначьте переменную (она понадобится для знаний AI-ассистента): в примере это переменная online_shop.

Пример кода из калькулятора:

project.online_shop = get_records_from_table(5)
  1. project. — конструкция для записи переменной в настройки проекта;
  2. online_shop — название переменной;
  3. 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-ассистента

В настройках бота прописываем следующие данные.

  1. Должность и инструкции для бота.

  1. Команда для вызова блока и передачи переменных в систему прописывается следующим образом:

Знания бота

В поле «Знания бота» передайте переменную, которую ранее закешировали блоком с условием.

Знания бота:

Так бот будет брать информацию из переменной, лежащей в настройках проекта, и консультировать ваших клиентов по поводу имеющегося ассортимента.

Сохраняемые переменные

В формате передаваемых данных вы прописываете собственно сами собираемые данные (например, товар), далее прописывается фраза с «ключом» и присваиваете значение ключу.

Так переменные при вызове блока будут передаваться в карточку клиента. Далее вы сможете работать с переменными, например, в конструкторе.

Поскольку в формате передаваемых данных мы объявили переменную payment_sum, при подключенных платежных сервисах вы сможете выдавать ссылку на оплату прямо в боте.

При объявлении переменной payment_sum сумма ссылки на оплату генерируется автоматически!

Не подходит для ю/л и ИП с НДС.

Настоятельно рекомендуем выдавать ссылку на оплату после проверки суммы оплаты менеджером во избежании неточностей!

На этом настройка AI-ассистента завершена.

Остальные параметры можно выставить по-своему усмотрению.

Тестирование бота

Если у вас уже работают боты, то укажите в условии запуска AI-ассистента запуск только в окне тестирования.

Шаг 1. Кликните по Конструктору условий.

Шаг 2. Выберите вкладку Тестовое окно и кликните Добавить.

Теперь в условии для запуска вы видите следующее значение:

Так бот будет запускаться только в тестовом окне и нигде больше.

После отладки работы бота уберите данное условие.

В примере мы протестируем прямо в мессенджере:

Дополнительно

В схеме мы создали блоки для формирования ссылки на оплату и реакции на callback об успешной оплате.

AI-ассистент вызывает блок для формирования ссылки на оплату, затем отправляется блок с кнопкой.

Далее после успешной оплаты приходит callback в диалоге с клиентом (callback пользователь не видит).

Обратите внимание, что на примере выше видно, где отработал AI, а где бот из конструктора.

  1. Серые сообщения — сообщения AI-ассистента.
  2. Синие сообщения — сообщения из блоков конструктора.

На данный callback настроена реакция в блоке с условием.

Не направляйте ссылку на оплату без тестирования платежей!

Подробнее о настройках каждой платежной системы рассказали в разделе «Эквайринг».

Данное сообщение отправляется в режиме тестирования из-за команды:

вызываю блок 31241050

После тестирования и отладки работы бота пропишите в настройках бота команду:

start_block_from_ai 31241050

Таким образом вы можете создать интернет-магазин любого вида, использовать любые необходимые значения внутри таблицы.

Основное ограничение — только ваша фантазия!