Генерация QR-кода

Для генерации кода необходимо использовать функцию https://store.mavibot.ai/function/qrcode\\_generator 

Параметры:

text_for_qr - текст, который нужно закодировать
api_key - ключ доступа к API из настроек проекта

Вы можете сгенерировать код в настройках проекта

Замените #{api_key} на токен из настроек

Пример:

В поле "URL запроса" вставьте: https://store.mavibot.ai/function/qrcode\\_generator

В поле "Сохраненные значения" вставьте переменные, которые хотите сохранить (нужный URL находится в qr_image_url):

status->status;

qr_image_url->qr_image_url

В "JSON параметры" введите

{"text_for_qr":"Текст для кодирования","api_key":"8629fe13ba9efebefd27a7afd701767f"}

Функция возвращает json с параметрами status и qr_image_url

Полученный QR-код

Генерация штрихкода

Для генерации кода необходимо использовать функцию https://store.mavibot.ai/function/barcode\\_generator 

Параметры:

text_for_qr - текст, который нужно закодировать
api_key - ключ доступа к API из настроек проекта

Вы можете сгенерировать ключ доступа к API в настройках проекта

class - класс кода, который нужно сгенерировать. По умолчанию ea13. Может принимать следующие значения: 'code39', 'code128', 'ean', 'ean13', 'ean8', 'gs1', 'gtin', 'isbn', 'isbn10', 'isbn13', 'issn', 'jan', 'pzn', 'upc', 'upca'

without_text - (необязательный параметр) если передать любое значение, штрихкод будет отображаться без текста, как показано на изображении ниже.

Замените #{api_key} на токен из настроек

Пример: {"text":"#{barcode}","api_key":"#{api_key}", "class": "ean13"}

Функция возвращает json с параметрами status и qr_image_url в случае успеха и error_message в случае неудачи

Пример текста хранится в переменной barcode, а переменная image_url используется для отправки в виде изображения.

Пример запроса без текста

Распознавание штрихкода с изображения

Вы можете использовать это для создания бота, который сканирует коды товаров. Полезная особенность заключается в том, что он также может сканировать QR-коды.

Адрес функции, распознающей штрихкод на изображении: https://store.mavibot.ai/function/cv2barcode 

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

{"photo":"ссылка на штрихкод/QR-код или переменная со ссылкой","api_key":"ключ доступа к API из настроек"}

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

В поле "Пользователь вводит данные" (указано стрелкой) введите переменную #{attachments}.

Пример кода:

{"photo":"#{attachments}","api_key":"8629fe13ba9efebefd27a7afd701767f"}

photo — это ссылка на изображение штрихкода; в нашем случае это переменная, содержащая ссылку на изображение, отправленное боту.

Следующий параметр — api_key — ключ доступа к API из настроек проекта

Функция работает следующим образом:

Клиент отправляет изображение штрихкода, функция сканирует его и в случае успеха возвращает номер штрихкода со статусом операции "ok".

barcode -> "4500000000567" status -> "ok"

Статус сканирования может быть:

  • ok — штрихкод распознан
  • barcode not recognized — как следует из названия, штрихкод не удалось распознать
  • error image reading — произошла ошибка чтения изображения
  • error subscription — эта функция недоступна с вашим текущим тарифным планом

Переменная status может использоваться как условие на стрелке для перенаправления клиента в соответствующий блок.

Например, если условие на стрелке проверяет, равен ли status значению "barcode not recognized", можно вывести сообщение "Код не распознан, попробуйте еще раз" и предложить клиенту отправить фото снова.