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 das configurações do projeto

Você pode gerar um código nas configurações do projeto

Altere #{api_key} pelo token das configurações

Exemplo:

No campo "Requisição de URL" cole: https://store.mavibot.ai/function/qrcode\\_generator

No campo "Valores armazenados" cole as variáveis que deseja salvar (a URL necessária está em qr_image_url):

status->status;

qr_image_url->qr_image_url

Em "Parâmetros JSON" digite

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

A função retorna json com os parâmetros status e qr_image_url

O QR code que você obtém

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 das configurações do projeto

Você pode gerar uma chave de acesso da API nas configurações do projeto

class - a classe do código que você precisa gerar. Por padrão é ea13. Pode assumir estes valores: 'code39', 'code128', 'ean', 'ean13', 'ean8', 'gs1', 'gtin', 'isbn', 'isbn10', 'isbn13', 'issn', 'jan', 'pzn', 'upc', 'upca'

without_text - (um parâmetro opcional) se você fornecer qualquer valor, o código de barras será exibido sem o texto, conforme mostrado na imagem abaixo.

Altere #{api_key} pelo 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 bem-sucedida e error_message se mal-sucedida

O texto de exemplo é armazenado na variável barcode, e a variável image_url é usada para enviá-lo como imagem.

Um exemplo da requisição sem texto

Reconhecimento de código de barras a partir de uma imagem

Você pode usar isso para criar um bot que escaneia códigos de produtos. Um recurso útil é o fato de que ele também pode escanear 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 das configurações"}

Por exemplo, para enviar uma imagem para escaneamento, você precisa enviar estes parâmetros:

Na seta no campo "Usuário insere dados" insira a variável #{attachments}.

Exemplo de código:

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

photo é 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 das configurações do projeto

A função funciona assim:

O cliente envia uma imagem do código de barras, a função a escaneia e, se bem-sucedida, retorna o número do código de barras com o status da operação definido como "ok".

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

O status do escaneamento pode ser:

  • ok — o código de barras foi reconhecido
  • barcode not recognized — como o nome sugere, o código de barras não pôde ser reconhecido
  • error image reading — houve um erro ao ler a imagem
  • error subscription — este recurso não está disponível com 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 “barcode not recognized”, você pode exibir a mensagem "O código não foi reconhecido, tente novamente" e solicitar que o cliente envie a foto novamente.