# Código QR y código de barras: generación y reconocimiento

## Generación de código QR

Para generar un código, debes usar la función <https://store.mavibot.ai/function/qrcode\\_generator&#x20>;

#### Parámetros:&#x20;

**text\_for\_qr** - texto que necesita ser codificado \
**api\_key** - clave de acceso API de la configuración del proyecto

![Puedes generar un código en la configuración del proyecto](https://lh6.googleusercontent.com/G3P9JaFTZGHPGvVwzzehQy0mdgSHib6jodk5ABNL426isLQtkDmfduUrAmufT2ExI9ecJXPlTGdhywYGP5X6oGxTTu_QbsqTIE1A9RE4Qr5kVQIpkR8O3mL0-NTKuasuf2o73Kga_LD6s_hc7w)

{% hint style="info" %}
Cambia #{api\_key} por el token de la configuración
{% endhint %}

#### Ejemplo:

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

En el campo "Stored values" pega las variables que deseas guardar (la URL requerida está en *qr\_image\_url*):

*status->status;*&#x20;

*qr\_image\_url->qr\_image\_url*

En "JSON parameters" escribe

*{"text\_for\_qr":"Texto para codificar","api\_key":"8629fe13ba9efebefd27a7afd701767f"}*

<figure><img src="/files/2f36ce13649fb6a87d1a2bfa7e1874cc27b66702" alt="" width="563"><figcaption></figcaption></figure>

La función devuelve JSON con los parámetros *status* y *qr\_image\_url*

![El código QR que obtienes](https://lh6.googleusercontent.com/eSuVmN8FWyY6t7zXmyghnfXLbSy4S5u_Di4oryW3beBhQNZVXLXMPdve7wpx3fvqmbvYAL8J3XWn4gNff9R5pVFp04OjhgOqfJnS-kbC_kZnCV6iPO2JlJeL11TYUJ-mRij7eWVllrLlGeRZsA)

## Generación de código de barras

Para generar un código, debes usar la función <https://store.mavibot.ai/function/barcode\\_generator&#x20>;

#### Parámetros:&#x20;

**text\_for\_qr** - texto que necesita ser codificado \
**api\_key** - clave de acceso API de la configuración del proyecto

![Puedes generar una clave de acceso API en la configuración del proyecto](https://lh5.googleusercontent.com/cWMoOIdWMMRt6-EDnJvQXFRSsEZaTJNUnXZwcVBrBUmK19nZ_coUel3BXdrxT1sBn6L5qitVUu1-xbYuks6qsC8mxsEUGJ1u6ctNoYkFQaoLRLO4X32XupBFtVDxKuMSIY6G-Wsj_VcMqVrZPA)

**class** - la clase de código que necesitas generar. De forma predeterminada 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 lo proporcionas con cualquier valor, el código de barras se mostrará sin el texto, como se muestra en la imagen de abajo.

![](https://lh5.googleusercontent.com/VXAHILxb5iktDtp4u8t6DzuQ3mfCWi-UX-XuPQ_cuSd9lvQTMEMgrcH8q7ZuqnJjRsHT5czWg_ra1RGxAVSm7OJe3nQeSI5Yu5zrvSQSxBBNB6wR-zzfuy9XEVRxTBlyv41nvKk8aaxt0fUJrQ)

{% hint style="info" %}
Cambia #{api\_key} por el token de la configuración
{% endhint %}

Ejemplo: *{"text":"#{barcode}","api\_key":"#{api\_key}", "class": "ean13"}*&#x20;

La función devuelve JSON con los parámetros *status* y *qr\_image\_url* si tiene éxito y *error\_message* si no tiene éxito

![](https://lh5.googleusercontent.com/d5iQRmdgfMrKI5_lnMzriTnyMcWm_slw4Mj5kArjxkOcGJzm5OIlRflLzqrwOe8OUdwyVl12fHC5yWQAs26g6cWuMTJoreO3cIE4HBFbBKrgZvrykg8onW4xZBIMaBGtUkhUbvXmVQLDJ-MaJw)

{% hint style="info" %}
El texto de ejemplo se guarda en la variable barcode, y la variable image\_url se usa para enviarlo como una imagen.
{% endhint %}

![Un ejemplo de la solicitud sin texto](https://lh6.googleusercontent.com/LOJir5XWjFLkuValhnA6WDmsDIDfXS_RZ-dtSuuN5ZJBrnTdSPmXU1SqtVcKab6yEpsLi-ZsuIRQhjbZuM3XJt9HuGf7bd_stOygSXYLPh2FJFoxEONy9ZZJOmR_R1X-nsHBdFk47_FFo_lFpA)

## Reconocimiento de código de barras desde una imagen

Puedes usar esto para crear un bot que escanee códigos de productos. Una función ú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&#x20>;

Para escanear una imagen necesitas 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 API de la configuración"}*

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

![](https://lh6.googleusercontent.com/xbJz5HRo4PX_phHU5OW0j9GGANrH6sconYSdOwIW7iE-BtJwYibjv3DMZ0-UqebJaZ54TrCxH2sCFxcF3mEMEQFqdWDj4OHIf9_D5lmKn47Ye3rQ7cd6wZO6bPFfTm6OIbe90qUFBC_CYPCPgA)

En la flecha del campo "User enters data" introduce la variable #{attachments}.

Ejemplo de código:

`{"photo":"#{attachments}","api_key":"8629fe13ba9efebefd27a7afd701767f"}`&#x20;

`foto` 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 API de la configuración del proyecto

![](https://lh6.googleusercontent.com/acBPr_Z1ewC3iC32xGYyy-l1LItVnkfdtIByxUYCbujBANi7KTfcce9mnBMl9jA4foxKv6Z75dp7fCiNBVFOKVE60EFOnhdrh2wH_eEDesvWQTO-mDYVUXCxeZTHoLv4p8RHhrr0qhhXnMmOqQ)

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 la operación configurado en "ok".

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

El estado del escaneo puede ser:

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

La variable status puede usarse 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 “código de barras no reconocido”, puedes mostrar el mensaje "El código no fue reconocido, por favor inténtalo de nuevo" y pedirle al cliente que envíe la foto otra vez.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/es/funciones-especiales/codigo-qr-y-codigo-de-barras-generacion-y-reconocimiento.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
