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

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

Ви можете перевіряти дійсність кодів за допомогою Google Таблиць та їх API-запитів.

Дізнайтеся більше про ці процеси нижче:

Як перевірити промокод з Google Таблиці

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

Підготуйте Google Таблицю, в якій один стовпець буде списком ваших промокодів. Встановіть налаштування доступу на «Усі, хто має посилання, можуть редагувати». Як це зробити, читайте в цій статті

Ось як працює функція: Клієнт вводить свій промокод у бот. Потім функція перевіряє, чи існує код у визначеному вами стовпці. Якщо код знайдено, до сусідньої комірки додається фраза «Промокод використано», і функція повертає цю відповідь:

{“status”: ‘’0’’}

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

Для перевірки коду вам потрібно надіслати ці параметри з блоку:

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

id — це ідентифікатор вашої Google Таблиці, що містить промокоди. Ви можете знайти його в URL-адресі вашого документа. Переконайтеся, що налаштування спільного доступу до документа дозволяють усім, хто має посилання, редагувати.

Якщо промокоди знаходяться в окремому аркуші, тоді вам потрібно використати параметр list_name, в якому ви маєте вказати його назву, наприклад:

{"id":"1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI", "promocode": "#{question}", "col_number": "1", "list_name": "Назва аркуша"}

Наступний параметр — це промокод, який застосовує клієнт.

col_number — номер стовпця, що містить коди

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

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

{“status”: ‘’0’’}

Якщо ви цікавитеся, як це використовувати та куди розмістити, перегляньте скріншот нижче.

#{custom_answer} — відповідь від сервера, яка згадується у вкладці «URL-запит».

Використовуйте цю змінну у вкладці відповіді, щоб побачити її вміст. Якщо все налаштовано правильно, збережіть status->status, потім у стрілках під вкладкою «Змінна для порівняння» встановіть умови "status == 0" (відповідь користувачеві, що код уже використано) або "status == 1" (дозвіл користувачеві продовжити).

Приклад наведено нижче.

Як надати промокод з Google Таблиці

Підготуйте свою таблицю, як показано на зображенні нижче, з промокодами в першому стовпці та словом «Доступний» у другому стовпці. Налаштуйте параметри доступу на «Усі в Інтернеті, хто має посилання, можуть редагувати». Як це зробити, читайте в цій статті

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

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

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

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

URL-запит: https://store.salebot.ai/function/findcell

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

data->Промокод;
cell_number|row ->рядок;

Параметри JSON:

{"id": "1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI", "find": "Доступний", "col": 2, "return": 1}

де вам потрібно вставити власний ідентифікатор сторінки замість 1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI

Створіть блок нижче та натисніть «Налаштування часу» в налаштуваннях з'єднання. У відкритому розділі під вкладкою «Затримка перед відповіддю» введіть -1, щоб перехід відбувся якомога швидше.

У новому блоці встановіть параметри, зазначені нижче.

Щоб показати клієнту його код, введіть #{Promo_code}

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

URL-запит: https://store.mavibot.ai/function/gsheets

Параметри JSON:

{"id": "1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI", "write":{"b#{line}":"Використано"}}
де вам потрібно вставити власний ідентифікатор сторінки замість 1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI

Як згенерувати промокод за допомогою Mavibot

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

Для цього вам знадобляться змінні. Наприклад, щоб згенерувати унікальний промокод, ви можете використати змінну #{client_id}. Це змінна в Mavibot, яка вказує номер вашого клієнта в системі.

У налаштуваннях блоку Розширені -> Калькулятор запишіть:
Promocode = promo#{client_id}

Вставте #{Promo_code} у полі «Відповідь»
Ви отримаєте промокод promo1330882.

Якщо ви хочете додати більше випадковості до вашого коду, додайте виклик функції random()
Promocode = 'promo' + '#{client_id}' + random(0,10)
У цьому випадку в кінці додається 1 випадкове число

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

Спочатку створіть нову порожню Google Таблицю. Встановіть дозволи спільного доступу на «Усі, хто має посилання, можуть редагувати».

Потім введіть Промокоди в комірку A1.

Якщо перша комірка порожня, функція не працюватиме. Обов'язково заповніть її!

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

https://docs.google.com/spreadsheets/d/**1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf\\_OKvDMrOI**/edit?usp=sharing

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

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

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

URL-запит: https://store.mavibot.ai/function/gsheets

Параметри JSON:

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

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