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

Бот дозволяє не лише видавати промокоди клієнтам, а й перевіряти їхню дійсність та контролювати одноразове використання

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

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

  2. Навчіть Mavibot генерувати промокоди за певними правилами, надайте код клієнту, а потім запишіть його в таблицю.

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

Докладніше про ці процеси читайте нижче:

Як перевірити промокод із Google Sheets

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

Підготуйте Google Sheet, у якому в одному стовпці буде список ваших промокодів. Встановіть налаштування доступу на “Anyone with this link can edit”. Як це зробити, читайте в цю статтю

Ось як працює функція: Клієнт вводить свій промокод у бота. Потім функція перевіряє, чи існує код у зазначеному вами стовпці. Якщо код знайдено, у сусідню клітинку додається фраза "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”. Як це зробити, читайте в цю статтю

Ви отримаєте посилання, подібне до цього: https://docs.google.com/spreadsheets/d/1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI/edit?usp=sharing

Жирний текст тут — це ID вашої сторінки. Він знадобиться вам пізніше.

Створіть блок у Mavibot і вставте ці параметри в його налаштування:

Тип запиту: POST-json

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

Збережені значення:

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

Параметри JSON:

{"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:

{"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." Потім введіть Promo codes у клітинку A1.

Ви отримаєте посилання, подібне до цього:

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:

{"id": "1sl15vKFjo5TFD98GnVjF3AlLtdhr85-AkEjoeJkgDxE", "mapping":{"a":"#{Promo_code}"}} де вам потрібно замінити 1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI на свій власний ID сторінки

Ви повинні створити щось подібне до цього:

Останнє оновлення