Génération de code QR

Pour générer un code, vous devez utiliser la fonction https://store.mavibot.ai/function/qrcode\\_generator 

Paramètres :

text_for_qr - texte à coder
api_key - clé d'accès API depuis les paramètres du projet

Vous pouvez générer un code dans les paramètres du projet

Remplacez #{api_key} par le jeton des paramètres

Exemple :

Dans le champ "Requête URL", collez : https://store.mavibot.ai/function/qrcode\\_generator

Dans le champ "Valeurs stockées", collez les variables que vous souhaitez enregistrer (l'URL requise se trouve dans qr_image_url) :

status->status;

qr_image_url->qr_image_url

Dans "Paramètres JSON", tapez

{"text_for_qr":"Texte à coder","api_key":"8629fe13ba9efebefd27a7afd701767f"}

La fonction renvoie un json avec les paramètres status et qr_image_url

Le code QR que vous obtenez

Génération de code-barres

Pour générer un code, vous devez utiliser la fonction https://store.mavibot.ai/function/barcode\\_generator 

Paramètres :

text_for_qr - texte à coder
api_key - clé d'accès API depuis les paramètres du projet

Vous pouvez générer une clé d'accès API dans les paramètres du projet

class - la classe de code que vous devez générer. Par défaut, c'est ea13. Peut prendre ces valeurs : 'code39', 'code128', 'ean', 'ean13', 'ean8', 'gs1', 'gtin', 'isbn', 'isbn10', 'isbn13', 'issn', 'jan', 'pzn', 'upc', 'upca'

without_text - (un paramètre optionnel) si vous lui fournissez une valeur quelconque, le code-barres sera affiché sans le texte, comme illustré dans l'image ci-dessous.

Remplacez #{api_key} par le jeton des paramètres

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

La fonction renvoie un json avec les paramètres status et qr_image_url en cas de succès et error_message en cas d'échec

Le texte d'exemple est stocké dans la variable barcode, et la variable image_url est utilisée pour l'envoyer en tant qu'image.

Un exemple de requête sans texte

Reconnaissance de code-barres à partir d'une image

Vous pouvez l'utiliser pour créer un bot qui scanne les codes produits. Une fonctionnalité utile est le fait qu'il peut également scanner les codes QR.

L'adresse de la fonction qui reconnaît un code-barres sur une image est https://store.mavibot.ai/function/cv2barcode 

Pour scanner une image, vous devez envoyer ces paramètres depuis le bloc :

{"photo":"le lien vers le code-barres/code QR ou la variable contenant le lien","api_key":"clé d'accès API depuis les paramètres"}

Par exemple, pour envoyer une image à scanner, vous devez envoyer ces paramètres :

Dans la flèche du champ "L'utilisateur saisit des données", entrez la variable #{attachments}.

Exemple de code :

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

photo est le lien vers l'image du code-barres ; dans notre cas, c'est la variable qui contient le lien vers l'image envoyée au bot.

Le paramètre suivant est api_key - clé d'accès API depuis les paramètres du projet

La fonction fonctionne ainsi :

Le client envoie une image du code-barres, la fonction la scanne et, en cas de succès, renvoie le numéro du code-barres avec le statut de l'opération défini sur "ok".

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

Le statut de numérisation peut être :

  • ok — le code-barres a été reconnu
  • barcode not recognized — comme son nom l'indique, le code-barres n'a pas pu être reconnu
  • error image reading — une erreur s'est produite lors de la lecture de l'image
  • error subscription — cette fonctionnalité n'est pas disponible avec votre formule d'abonnement actuelle

La variable status peut être utilisée comme condition sur une flèche pour diriger le client vers le bloc approprié.

Par exemple, si la condition d'une flèche vérifie si status est égal à "barcode not recognized", vous pouvez afficher le message "Le code n'a pas été reconnu, veuillez réessayer" et inviter le client à renvoyer la photo.