Данная статья поможет вам изменить шаблон "Онлайн-заказы" под нужды своего бизнеса. Это очень простая пошаговая инструкция, которая позволит вам создать бота, который:
будет предоставлять информацию о наличии товаров и их стоимости;
сможет принимать заказы, включая принятие адреса доставки;
сможет предоставлять информацию по статусу существующего заказа.

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

Эта статья не содержит инструкцию о том, как передавать данные о заказе. Вы можете найти инструкцию о том, как отправлять данные сообщением в телеграм здесь, а для отправки данных в гугл-таблицы или для отправки имейлов вы можете использовать сервис IFTTT. А в этой статье рассмотрим базовую логику чат-бота, которую вы сможете дополнить позднее.

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

Итак, приступим.

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


Требования к оформлению таблицы:

В таблице должно быть четыре столбца со следующими названиями:
number - порядковый номер товара;
Name - название товара;
Price - стоимость товара;
InStock - наличие товара (в наличии или нет).



Важно писать названия столбцов именно таким образом. Не заменять заглавные буквы на маленькие и наоборот, не добавлять пробелов. Просто копируйте и вставляйте названия столбцов в таблицу. Если вы сделаете опечатку в названии столбца, сценарий не будет корректно работать.

Перечислите в таблице свои товары, дайте им номера, назначьте им стоимость.

В колонке "InStock" должны быть элементы "Флажок". Чтобы добавить флажки в колонку InStock перейдите в гугл таблице в меню "Вставка" —> “Флажок”.



Опубликуйте таблицу.

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

Файл -> Публикация в интернете -> Опубликовать -> Ок -> Закройте всплывающее окно.

Путь из всплывающего окна копировать не нужно.



Вы можете найти шаблон сценария "Онлайн-заказы" на главной странице Aimylogic. Если вы ещё не открывали этот шаблон, то перейдите на https://app.aimylogic.com и кликните на шаблон "Онлайн-заказы":



В этом сценарии перейдите на вкладку Сущности.

Чтобы бот понимал синонимы, создадим сущности, соответствующие списку ваших товаров. Как видите, здесь у вас уже есть готовый справочник $item. Он добавлен сюда для демонстрационных целей.



Чтобы добавить список своих товаров, удалите этот справочник:


И затем создайте свой справочник, дав ему название $item. Нажмите "Создать справочник", введите "item" и нажмите продолжить:

Если ваш справочник будет называться иначе, а не $item, то сценарий не будет работать корректно.

Добавьте названия своих товаров в колонку "Сущности". В разделе "Синонимы" перечислите синонимы (другие варианты названий ваших товаров, которые могут использовать пользователи. Например, мерседес - мерс). Будьте внимательны, когда будете перечислять свои товары в "Сущностях". Название сущности должно соответствовать названию товара в вашей гугл-таблице. В колонке "синонимы" могут быть все возможные формы этого слова, но в колонке "сущности" должно быть ровно то, что в таблице.
Когда закончите, нажмите "Сохранить изменения".




Вы можете почитать о сущностях подробнее здесь.

Теперь оформим обращение к гугл-таблице.

Для начала, скопируйте и вставьте данную строку в блокнот:
http://tools.aimylogic.com/api/googlesheet2json?sheet=1&id=



Откройте гугл-таблицу, в которой вы создавали базу своих товаров, и найдите в пути таблицы данный элемент:


Будьте очень внимательны на этом моменте. Нужный вам элемент находится в пути страницы между частями
https://docs.google.com/spreadsheets/d/
и
/edit#



Это идентификатор документа. Скопируйте его и вставьте в блокнот после той строки, которую мы вставили ранее. Затем скопируйте всё, что получилось в блокноте.



Вернитесь на вкладку "Сценарий" и найдите первый блок HTTP-запрос, как видно на картинке, и на gif ниже. Этот HTTP-запрос получает данные из гугл-таблиц и предоставляет информацию о наличии и стоимости товаров. Откройте его, нажав на шестерёнку (она появляется, если навести курсор на этот экран).

Удалите ссылку из поля URL и вставьте то, что скопировали ранее из блокнота. Больше ничего менять в запросе не нужно.
Нажмите Сохранить.



И сохраните сценарий:


Создайте второй лист таблицы.

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

Второй лист таблицы будет выглядеть так:


Требования к оформлению таблицы:
названия товаров должны быть указаны точно так, как они прописаны на первом листе таблицы;

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

Order
- номер заказа;
Name
- название товара (должно быть таким же, как на первом листе таблице, и соответствовать названию сущности)
Status
- статус заказа;
Address
- адрес доставки;
Price
- стоимость товара.

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

Если вы допустите опечатку или добавите пробел в название столбца, сценарий не будет корректно работать.

Теперь изменим второй HTTP-запрос, с помощью которого уточняется статус заказа.

Скопируйте в блокнот эту строку:
http://tools.aimylogic.com/api/googlesheet2json?sheet=2&id=


В этой строке есть значение sheet=2, так как мы делаем обращение ко второму листу.

Скопируйте идентификатор вашей гугл-таблицы и вставьте его в блокнот после строки, которую вставили в блокнот ранее. Скопируйте всё, что получилось в блокноте.



Найдите в сценарии второй HTTP-запрос, как видно на gif ниже. Этот HTTP-запрос получает данные о статусе заказа и предоставляет эту информацию пользователю. Откройте его, нажав на шестерёнку (она появляется, если навести курсор на этот экран).

Удалите ссылку из поля URL и вставьте то, что скопировали ранее из блокнота. Больше ничего менять в запросе не нужно.
Нажмите Сохранить.



И сохраните сценарий:


Просмотрите сценарий и внесите необходимые изменения.

Например, если ваш магазин продаёт шоколад или игрушки, а не технику Apple, измените тексты в различных текстовых блоках сценария.



Можно тестировать бота.

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



Если вы тестировали бота в тестовом виджете, а затем решили что-нибудь отредактировать в сценарии, остановите тестирование и снова нажмите Тестировать, чтобы изменения пришли в силу:



Всё получилось, всё работает? Проверьте перечень популярных запросов пользователей на стартовом экране и измените согласно потребностям вашего бизнеса. Дополните логику чат-бота нужным вам функционалом, например:

принимайте телефон пользователя и отправляйте данные о заказе в телеграм,
отправляйте данные в гугл-таблицы или на почту с помощью сервиса IFTTT.
подключите канал, например, Вк, телеграм или добавьте бота к вашей странице в Фейсбуке или в Битрикс24. Информацию о всех имеющихся каналах и о том, как их подключить, вы можете найти здесь.

Возможные неполадки:

Бот говорит: "Извините, у нас какие-то неполадки на сервере... Статус -1. Попробуйте обратиться к нам чуть позже."

Проверьте правильность URL в http-запросах. Возможно, в самом URL или в конце URL есть пробел. Вернитесь к шагам 5 и 7 и правильно оформите URL в HTTP-запросах.

Бот говорит: "Извините, у нас какие-то неполадки на сервере... Статус 404. Попробуйте обратиться к нам чуть позже."

Проверьте правильность URL в http-запросах. Вернитесь к шагам 5 и 7 и правильно оформите URL в HTTP-запросах.

Сценарий изменен, но бот выдает старую версию текста / реагирует по-старому.

Остановите тестирование и запустите его снова.

Бот говорит, что таких товаров нет в наличии, хотя они есть.

Проверьте, выполнили ли вы шаг 4. Обратите внимание, что названия сущностей должны соответствовать названиям товаров в вашей таблице. В синонимах вы можете перечислить альтернативные названия товаров.

Если возникли сложности:

ещё раз проверьте, правильно ли следовали всем шагам, перечисленным в инструкции. Можете попробовать повторить этот урок с самого начала, с нуля;
просмотрите описания возможных неполадок выше в этой статье;
если все шаги выполнены внимательно, но повторить кейс всё равно не получается, то обратитесь в чат поддержки и опишите, какую именно ошибку видите. Обязательно пришлите:
1) скриншот общения с ботом, где четко видно, где именно возникла ошибка,
2) если есть сообщение об ошибке, то скопируйте и пришлите его;
3) скриншот сценария,
4) скриншот с вкладки "Сущности"
5) скриншот своей гугл-таблицы, оба листа.

Также поясните, меняли ли что-либо ещё в сценарии.

С удовольствием вам поможем!

Была ли эта статья полезна?
отменить
Спасибо!