Integração web do scanner

Chame o scanner de código de barras do app Teclado Coletor a partir do seu site, com um botão — sem precisar de nenhum campo de texto focado.

⚠️ Isso é diferente do uso normal do teclado (que já funciona em qualquer campo de texto, automaticamente). Esta integração é para quando você quer um botão "Escanear" na página que abre a câmera diretamente, mesmo fora de um campo. Requer que o app Teclado Coletor esteja instalado no aparelho do visitante.

Como funciona

O fluxo é simples e instantâneo: seu site chama o app por um link especial, a câmera abre na hora, o usuário escaneia, e o app volta automaticamente para a mesma página com o código lido na URL.

Visitante toca no botão "Escanear" do seu site
O app Teclado Coletor abre com a câmera já ativa — mesma experiência instantânea do scanner do teclado
Usuário escaneia o código de barras
O app volta para o seu site automaticamente, com o valor lido na URL
O SDK JS processa o retorno e chama sua função de callback

1. Inclua o script

<script src="https://tecladocoletor.com.br/assets/teclado-coletor-scan.js"></script>

Ou baixe e hospede o arquivo no seu próprio site — ele é independente, sem dependências externas.

2. Processe o retorno ao carregar a página

Coloque isso assim que a página carregar — ele verifica se o usuário acabou de voltar de um scan (e limpa a URL depois, então é seguro chamar sempre):

TecladoColetorScan.processarRetorno({
  onResultado: function (codigo) {
    document.getElementById('campo-codigo').value = codigo;
  },
  onCancelado: function () {
    console.log('Usuário cancelou o scan.');
  },
  onErro: function (motivo) {
    alert('Não foi possível escanear: ' + motivo);
  }
});

3. Dispare o scanner num botão

document.getElementById('btn-escanear').addEventListener('click', function () {
  TecladoColetorScan.escanear({
    onIndisponivel: function () {
      alert('Instale o app Teclado Coletor para usar o scanner.');
    }
  });
});

Referência da API

`TecladoColetorScan.escanear(opcoes)`

Opção	Descrição
`timeoutMs`	Tempo (ms) de espera antes de considerar que o app não está instalado. Padrão: 1800
`onIndisponivel`	Função chamada se o app não abrir a tempo (provavelmente não instalado)

`TecladoColetorScan.processarRetorno(callbacks)`

Callback	Quando dispara
`onResultado(codigo)`	O usuário escaneou com sucesso — `codigo` é o valor lido
`onCancelado()`	O usuário cancelou antes de escanear
`onErro(motivo)`	Algo impediu o scan (ex: `"sem_licenca"` — licença/teste expirado no aparelho do usuário)

💡 A câmera abre instantaneamente — sem tela de confirmação no meio do caminho, mesma agilidade do scanner do teclado. Um aviso discreto sobreposto na câmera mostra pra qual site o resultado vai voltar, sem bloquear ou atrasar o uso.

Testar agora

Clique no botão abaixo neste próprio celular (com o app instalado) para testar a integração ao vivo:

Limitações importantes

Funciona só em navegadores Android — não existe integração equivalente para iOS/desktop
O app precisa estar instalado no aparelho do visitante
Como o retorno acontece por navegação de página (não é uma janela popup), sua página recarrega ao voltar do scan — se for um app de página única (SPA), trate o parâmetro da URL adequadamente no seu roteamento
Se a licença do usuário estiver expirada, o app avisa antes de abrir a câmera e retorna com tc_erro=sem_licenca

Dúvidas

Precisa de ajuda com a integração? Fale com a gente: nao-responda@seusite.com