QR code e código de barras: geração e reconhecimento
Geração de QR code
Para gerar um código, você precisa usar a função https://store.mavibot.ai/function/qrcode_generator
Parâmetros:
text_for_qr - texto que precisa ser codificado api_key - chave de acesso da API nas configurações do projeto
Altere #{api_key} para o token das configurações
Exemplo:
No campo "URL request" cole: https://store.mavibot.ai/function/qrcode_generator
No campo "Stored values" cole as variáveis que você quer salvar (a URL necessária está em qr_image_url):
status->status;
qr_image_url->qr_image_url
Em "JSON parameters" digite
{"text_for_qr":"Texto para codificação","api_key":"8629fe13ba9efebefd27a7afd701767f"}
A função retorna json com os parâmetros status e qr_image_url
Geração de código de barras
Para gerar um código, você precisa usar a função https://store.mavibot.ai/function/barcode_generator
Parâmetros:
text_for_qr - texto que precisa ser codificado api_key - chave de acesso da API nas configurações do projeto
classe - a classe de código que você precisa gerar. Por padrão, é ea13. Pode receber estes valores: 'code39', 'code128', 'ean', 'ean13', 'ean8', 'gs1', 'gtin', 'isbn', 'isbn10', 'isbn13', 'issn', 'jan', 'pzn', 'upc', 'upca'
sem_texto - (um parâmetro opcional) se você fornecê-lo com qualquer valor, o código de barras será exibido sem o texto, como mostrado na imagem abaixo.
Altere #{api_key} para o token das configurações
Exemplo: {"text":"#{barcode}","api_key":"#{api_key}", "class": "ean13"}
A função retorna json com os parâmetros status e qr_image_url se tiver sucesso e mensagem_de_erro se não tiver sucesso
O texto de exemplo é armazenado na variável barcode, e a variável image_url é usada para enviá-lo como uma imagem.
Reconhecimento de código de barras a partir de uma imagem
Você pode usar isso para criar um bot que lê códigos de produtos. Um recurso útil é o fato de que ele também pode ler QR codes.
O endereço da função que reconhece um código de barras em uma imagem é https://store.mavibot.ai/function/cv2barcode
Para escanear uma imagem, você precisa enviar estes parâmetros do bloco:
{"photo":"o link para o código de barras/QR code ou a variável com o link","api_key":"chave de acesso da API nas configurações"}
Por exemplo, para enviar uma imagem para escaneamento, você precisa enviar estes parâmetros:
Na seta no campo "User enters data" insira a variável #{attachments}.
Exemplo de código:
{"photo":"#{attachments}","api_key":"8629fe13ba9efebefd27a7afd701767f"}
foto é o link para a imagem do código de barras; no nosso caso, é a variável que contém o link para a imagem enviada ao bot.
O próximo parâmetro é api_key - chave de acesso da API nas configurações do projeto
A função funciona assim:
O cliente envia uma foto do código de barras, a função a escaneia e, se tiver sucesso, retorna o número do código de barras com o status da operação definido como "ok".
barcode -> "4500000000567" status -> "ok"
O status da leitura pode ser:
ok — o código de barras foi reconhecido
código de barras não reconhecido — como o nome sugere, o código de barras não pôde ser reconhecido
erro na leitura da imagem — houve um erro ao ler a imagem
erro de assinatura — este recurso não está disponível no seu plano de assinatura atual
A variável status pode ser usada como condição em uma seta para direcionar o cliente ao bloco apropriado.
Por exemplo, se a condição de uma seta verificar se status é igual a "código de barras não reconhecido", você pode exibir a mensagem "O código não foi reconhecido, por favor tente novamente" e solicitar que o cliente envie a foto novamente.
Atualizado