Generación de código QR

Para generar un código, debes usar la función https://store.mavibot.ai/function/qrcode\\_generator 

Parámetros:

text_for_qr - texto que debe ser codificado
api_key - clave de acceso a la API desde la configuración del proyecto

Puedes generar un código en la configuración del proyecto

Cambia #{api_key} por el token de la configuración

Ejemplo:

En el campo "Solicitud URL" pega: https://store.mavibot.ai/function/qrcode\\_generator

En el campo "Valores almacenados" pega las variables que deseas guardar (la URL requerida está en qr_image_url):

status->status;

qr_image_url->qr_image_url

En "Parámetros JSON" escribe

{"text_for_qr":"Texto para codificar","api_key":"8629fe13ba9efebefd27a7afd701767f"}

La función devuelve un json con los parámetros status y qr_image_url

El código QR que obtienes

Generación de código de barras

Para generar un código, debes usar la función https://store.mavibot.ai/function/barcode\\_generator 

Parámetros:

text_for_qr - texto que debe ser codificado
api_key - clave de acceso a la API desde la configuración del proyecto

Puedes generar una clave de acceso a la API en la configuración del proyecto

class - la clase de código que necesitas generar. Por defecto es ea13. Puede tomar estos valores: 'code39', 'code128', 'ean', 'ean13', 'ean8', 'gs1', 'gtin', 'isbn', 'isbn10', 'isbn13', 'issn', 'jan', 'pzn', 'upc', 'upca'

without_text - (un parámetro opcional) si le proporcionas cualquier valor, el código de barras se mostrará sin texto, como se muestra en la imagen a continuación.

Cambia #{api_key} por el token de la configuración

Ejemplo: {"text":"#{barcode}","api_key":"#{api_key}", "class": "ean13"}

La función devuelve un json con los parámetros status y qr_image_url si tiene éxito y error_message si no tiene éxito

El texto de ejemplo se almacena en la variable barcode, y la variable image_url se usa para enviarlo como imagen.

Un ejemplo de la solicitud sin texto

Reconocimiento de código de barras desde una imagen

Puedes usar esto para crear un bot que escanee códigos de productos. Una característica útil es que también puede escanear códigos QR.

La dirección de la función que reconoce un código de barras en una imagen es https://store.mavibot.ai/function/cv2barcode 

Para escanear una imagen, debes enviar estos parámetros desde el bloque:

{"photo":"el enlace al código de barras/código QR o la variable con el enlace","api_key":"clave de acceso a la API desde la configuración"}

Por ejemplo, para enviar una imagen para escanear, debes enviar estos parámetros:

En la flecha en el campo "El usuario ingresa datos" ingresa la variable #{attachments}.

Ejemplo de código:

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

photo es el enlace a la imagen del código de barras; en nuestro caso, es la variable que contiene el enlace a la imagen enviada al bot.

El siguiente parámetro es api_key - clave de acceso a la API desde la configuración del proyecto

La función funciona así:

El cliente envía una imagen del código de barras, la función la escanea y, si tiene éxito, devuelve el número del código de barras con el estado de operación establecido en "ok".

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

El estado de escaneo puede ser:

  • ok — el código de barras fue reconocido
  • barcode not recognized — como su nombre indica, el código de barras no pudo ser reconocido
  • error image reading — hubo un error al leer la imagen
  • error subscription — esta función no está disponible con tu plan de suscripción actual

La variable status se puede usar como condición en una flecha para dirigir al cliente al bloque apropiado.

Por ejemplo, si la condición de una flecha verifica si status es igual a "barcode not recognized", puedes mostrar el mensaje "El código no fue reconocido, inténtalo de nuevo" y solicitar al cliente que envíe la foto nuevamente.