Работа с промокодами

Бот позволяет не только выдавать клиентам промокоды, но и проверять их валидность и контролировать их одноразовое использование

Вы можете передать промокод клиенту одним из двух способов:

  1. Подготовьте список промокодов в Google Sheet, обучите Mavibot находить доступный код, передавать его клиенту, а затем отмечать его как выданный в таблице.

  2. Обучите Mavibot генерировать промокоды по определённым правилам, передайте код клиенту, а затем запишите его в таблицу.

Проверять действительность кодов можно с помощью Google Sheets и его API-запросов.

Подробнее об этих процессах читайте ниже:

Как проверить промокод из Google Sheets

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

Подготовьте Google Sheet, в котором в одном столбце будет список ваших промокодов. Установите настройку доступа «Любой, у кого есть эта ссылка, может редактировать». Как это сделать, читайте в эту статьюarrow-up-right

Вот как работает функция: клиент вводит свой промокод в бота. Затем функция проверяет, существует ли код в указанном вами столбце. Если код найден, в соседнюю ячейку добавляется фраза «Promo code was used», и функция возвращает этот ответ:

{“status”: ‘’0’’}

Адрес функции: https://store.mavibot.ai/function/check-promocode

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

{"id":"1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI", "promocode": "#{question}", "col_number": "1"}

id — это ID вашей Google Sheet с промокодами. Вы можете найти его в URL вашего документа. Убедитесь, что настройки доступа к документу позволяют любому пользователю по ссылке редактировать его.

Если промокоды находятся на отдельном листе, тогда нужно использовать параметр list_name, в который нужно указать его название, например:

{"id":"1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI", "promocode": "#{question}", "col_number": "1", "list_name": "Sheet name"}

Следующий параметр — это промокод, который использует клиент.

col_number — номер столбца, в котором находятся коды

{“status”: ‘’1’’}— после этого использовать код во второй раз уже нельзя

Если функция не найдёт промокод в таблице или он уже был использован, она ответит

{“status”: ‘’0’’}

Если вы хотите понять, как это использовать и куда это вставить, посмотрите на скриншот ниже.

#{custom_answer} — ответ сервера, указанный во вкладке "URL request".

Используйте эту переменную во вкладке ответа, чтобы увидеть её содержимое. Если всё настроено правильно, сохраните status->status, затем в стрелках под вкладкой «Variable for comparison» установите условия "status == 0" (сообщая пользователю, что код уже был использован) или "status == 1" (позволяя пользователю продолжить).

Пример показан ниже.

Как выдать промокод из Google Sheets

Подготовьте таблицу, как показано на изображении ниже: промокоды в первом столбце, а слово "Available" — во втором. Настройте доступ на «Anyone on the Internet with this link can edit». Как это сделать, читайте в эту статьюarrow-up-right

Вы получите ссылку, похожую на эту: https://docs.google.com/spreadsheets/d/1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI/edit?usp=sharing

Жирный текст здесь — это ID вашей страницы. Он понадобится вам позже.

Создайте блок в Mavibot и вставьте в его настройки эти параметры:

Тип запроса: POST-json

URL request: https://store.salebot.ai/function/findcell

Stored values:

data->Promo code; cell_number|row ->line;

JSON parameters:

{"id": "1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI", "find": "Available", "col": 2, "return": 1}

где вместо 1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI нужно указать свой ID страницы

Создайте блок ниже и нажмите на "Time settings" в настройках соединения. В открывшемся разделе, во вкладке "Delay before answer" введите -1, чтобы переход произошёл как можно быстрее.

В новом блоке задайте параметры, указанные ниже.

Чтобы показать клиенту его код, введите #{Promo_code}

Тип запроса: POST-json

URL request: https://store.mavibot.ai/function/gsheets

JSON parameters:

{"id": "1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI", "write":{"b#{line}":"Used"}} где вместо 1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI нужно указать свой ID страницы

Как сгенерировать промокод с помощью Mavibot

Если промокод можно создать по определённым правилам, то вы можете сгенерировать его прямо в Mavibot и записать в Google Sheets для последующей проверки.

Для этого вам понадобятся переменные. Например, чтобы сгенерировать уникальный промокод, можно использовать переменную #{client_id}— это переменная в Mavibot, которая показывает номер вашего клиента в системе.

В настройках блока Advanced -> Calculator пропишите: Promocode = promo#{client_id}

Вставьте #{Promo_code} в поле "Answer" У вас получится промокод promo1330882.

Если вы хотите добавить в свой код ещё больше случайности , тогда добавьте вызов функции random() Promocode = 'promo' + '#{client_id}' + random(0,10) В этом случае в конце добавляется 1 случайное число

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

Сначала создайте новую пустую Google Sheet. Установите настройки доступа на "Anyone with the link can edit." Затем в ячейку A1 впишите Promo codes.

circle-exclamation

Вы получите ссылку, похожую на эту:

https://docs.google.com/spreadsheets/d/1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI/edit?usp=sharing

Жирный текст здесь — это ID вашей страницы. Он понадобится вам позже.

Теперь вернёмся в Mavibot и продолжим работу над вашим блоком с промокодом

Тип запроса: POST-json

URL request: https://store.mavibot.ai/function/gsheets

JSON parameters:

{"id": "1sl15vKFjo5TFD98GnVjF3AlLtdhr85-AkEjoeJkgDxE", "mapping":{"a":"#{Promo_code}"}} где вместо 1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI нужно указать свой ID страницы

У вас должно получиться что-то вроде этого:

Последнее обновление