Para implementar validação de CPF por voz, você combina a Web Speech API nativa dos navegadores com uma chamada GET à API do CPFHub.io. O usuário clica no botão de microfone, dita os dígitos do CPF, e o sistema converte a fala em texto, formata o número e valida no momento da consulta — tudo com latência total de cerca de na etapa de consulta. Essa abordagem atende às exigências da Lei Brasileira de Inclusão (Lei 13.146/2015) e às diretrizes WCAG 2.1, ampliando o alcance da sua plataforma para pessoas com deficiência visual ou motora.
Por que acessibilidade importa na coleta de CPF
Números no Brasil
Segundo o IBGE, mais de 18 milhões de brasileiros possuem algum tipo de deficiência visual, e cerca de 2,5 milhões têm deficiência motora nos membros superiores. Para essas pessoas, digitar uma sequência de 11 números em um campo de texto pode ser extremamente difícil ou até impossível.
Impacto no negócio
Além da obrigação legal, a acessibilidade amplia o público potencial da sua plataforma. Empresas que investem em acessibilidade reportam aumento de conversão de 10-30% entre usuários com deficiência, além de melhorias na experiência geral -- design acessível beneficia todos os usuários.
Fundamentos da Web Speech API
O que é
A Web Speech API é uma API nativa dos navegadores modernos que oferece dois recursos principais:
- SpeechRecognition -- converte fala em texto.
- SpeechSynthesis -- converte texto em fala.
Para a entrada de CPF por voz, usaremos o SpeechRecognition. Para feedback acessível, combinaremos com SpeechSynthesis.
Compatibilidade
A Web Speech API é suportada no Chrome, Edge e Safari. No Firefox, o suporte é parcial. Para navegadores sem suporte, a interface deve fazer fallback gracioso para o input de texto tradicional.
Implementação do input de voz para CPF
Estrutura HTML
<div class="cpf-voice-input" role="group" aria-label="Campo de CPF com entrada por voz">
<label for="cpf">CPF</label>
<div class="input-wrapper">
<input
type="text"
id="cpf"
name="cpf"
inputmode="numeric"
pattern="[0-9]{11}"
maxlength="14"
placeholder="000.000.000-00"
aria-describedby="cpf-feedback"
autocomplete="off"
>
<button
type="button"
id="btn-voice"
class="voice-btn"
aria-label="Ditar CPF por voz"
title="Ditar CPF por voz"
>
<svg aria-hidden="true" width="20" height="20" viewBox="0 0 24 24">
<path d="M12 14c1.66 0 3-1.34 3-3V5c0-1.66-1.34-3-3-3S9 3.34 9 5v6c0 1.66 1.34 3 3 3z"/>
<path d="M17 11c0 2.76-2.24 5-5 5s-5-2.24-5-5H5c0 3.53 2.61 6.43 6 6.92V21h2v-3.08c3.39-.49 6-3.39 6-6.92h-2z"/>
</svg>
</button>
</div>
<div id="cpf-feedback" class="feedback" aria-live="polite" role="status"></div>
</div>
Atributos ARIA importantes
aria-labelno grupo identifica o propósito do componente.aria-describedbyconecta o input ao elemento de feedback.aria-live="polite"no feedback garante que leitores de tela anunciem mudanças.role="status"indica que o conteúdo será atualizado dinamicamente.
JavaScript com reconhecimento de voz
Código completo
A chave de API (x-api-key) deve ficar apenas no servidor, em uma variável de ambiente. O navegador chama uma rota do seu próprio backend; é essa rota que consulta a CPFHub.io.
// backend (Node/Express ou rota serverless) — a chave fica só no servidor
import express from 'express';
const app = express();
app.use(express.json());
app.post('/api/validar-cpf', async (req, res) => {
const cpf = String(req.body.cpf || '').replace(/\D/g, '');
if (cpf.length !== 11) {
return res.status(400).json({ success: false, error: 'CPF deve ter 11 dígitos.' });
}
try {
const response = await fetch(`https://api.cpfhub.io/cpf/${cpf}`, {
headers: {
'x-api-key': process.env.CPFHUB_API_KEY,
'Accept': 'application/json',
},
signal: AbortSignal.timeout(10000),
});
const result = await response.json();
return res.status(response.ok ? 200 : response.status).json(result);
} catch (error) {
return res.status(502).json({ success: false, error: 'Falha na validação.' });
}
});
const cpfInput = document.getElementById('cpf');
const btnVoice = document.getElementById('btn-voice');
const feedback = document.getElementById('cpf-feedback');
// Verifica suporte à Web Speech API
const SpeechRecognition = window.SpeechRecognition || window.webkitSpeechRecognition;
if (SpeechRecognition) {
const recognition = new SpeechRecognition();
recognition.lang = 'pt-BR';
recognition.continuous = false;
recognition.interimResults = false;
btnVoice.addEventListener('click', () => {
feedback.textContent = 'Ouvindo... Dite os números do CPF.';
feedback.className = 'feedback listening';
btnVoice.classList.add('active');
recognition.start();
});
recognition.onresult = (event) => {
const transcript = event.results[0][0].transcript;
const numeros = extrairNumeros(transcript);
if (numeros.length === 11) {
cpfInput.value = formatarCPF(numeros);
feedback.textContent = 'CPF capturado. Validando...';
validarCPF(numeros);
} else {
feedback.textContent = `Foram reconhecidos ${numeros.length} dígitos. O CPF precisa ter 11. Tente novamente.`;
feedback.className = 'feedback warning';
falarFeedback(`Foram reconhecidos ${numeros.length} dígitos. Tente novamente.`);
}
};
recognition.onerror = (event) => {
feedback.textContent = 'Não foi possível reconhecer a fala. Tente novamente ou digite manualmente.';
feedback.className = 'feedback error';
btnVoice.classList.remove('active');
};
recognition.onend = () => {
btnVoice.classList.remove('active');
};
} else {
// Fallback: esconde botão de voz se não há suporte
btnVoice.style.display = 'none';
}
function extrairNumeros(texto) {
// Converte palavras numéricas para dígitos
const mapa = {
'zero': '0', 'um': '1', 'uma': '1', 'dois': '2', 'duas': '2',
'três': '3', 'tres': '3', 'quatro': '4', 'cinco': '5',
'seis': '6', 'meia': '6', 'sete': '7', 'oito': '8', 'nove': '9'
};
let resultado = texto.toLowerCase();
for (const [palavra, digito] of Object.entries(mapa)) {
resultado = resultado.replace(new RegExp(palavra, 'g'), digito);
}
return resultado.replace(/\D/g, '');
}
function formatarCPF(numeros) {
return numeros.replace(/(\d{3})(\d{3})(\d{3})(\d{2})/, '$1.$2.$3-$4');
}
function falarFeedback(mensagem) {
if ('speechSynthesis' in window) {
const utterance = new SpeechSynthesisUtterance(mensagem);
utterance.lang = 'pt-BR';
utterance.rate = 0.9;
speechSynthesis.speak(utterance);
}
}
async function validarCPF(cpf) {
const controller = new AbortController();
const timeoutId = setTimeout(() => controller.abort(), 10000);
try {
const res = await fetch('/api/validar-cpf', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Accept': 'application/json',
},
body: JSON.stringify({ cpf }),
signal: controller.signal
});
clearTimeout(timeoutId);
const data = await res.json();
if (data.success) {
const nome = data.data.name;
feedback.textContent = `CPF válido. Titular: ${nome}.`;
feedback.className = 'feedback success';
falarFeedback(`CPF válido. Titular: ${nome}.`);
} else {
feedback.textContent = 'CPF não encontrado. Verifique os números.';
feedback.className = 'feedback warning';
falarFeedback('CPF não encontrado. Verifique os números.');
}
} catch (error) {
clearTimeout(timeoutId);
feedback.textContent = 'Erro na validação. Tente novamente.';
feedback.className = 'feedback error';
}
}
CSS acessível
.cpf-voice-input {
max-width: 400px;
}
.input-wrapper {
display: flex;
gap: 8px;
align-items: center;
}
.input-wrapper input {
flex: 1;
padding: 12px;
font-size: 1.1rem;
border: 2px solid #d1d5db;
border-radius: 6px;
}
.input-wrapper input:focus {
outline: 3px solid #2563eb;
outline-offset: 2px;
border-color: #2563eb;
}
.voice-btn {
padding: 12px;
border: 2px solid #d1d5db;
border-radius: 6px;
background: #f9fafb;
cursor: pointer;
transition: all 0.2s;
}
.voice-btn:hover,
.voice-btn:focus {
background: #e5e7eb;
outline: 3px solid #2563eb;
outline-offset: 2px;
}
.voice-btn.active {
background: #fee2e2;
border-color: #dc2626;
animation: pulse 1.5s infinite;
}
@keyframes pulse {
0%, 100% { opacity: 1; }
50% { opacity: 0.6; }
}
.feedback {
margin-top: 8px;
font-size: 0.9rem;
min-height: 24px;
}
.feedback.listening { color: #2563eb; }
.feedback.success { color: #059669; }
.feedback.warning { color: #d97706; }
.feedback.error { color: #dc2626; }
Contraste e tamanho
O contraste mínimo entre texto e fundo segue as diretrizes WCAG 2.1 nível AA (4.5:1 para texto normal). Os botões têm área de toque mínima de 44x44 pixels, conforme recomendado para acessibilidade.
Tratamento de casos especiais na fala
Números por extenso vs. dígitos
Usuários podem ditar "um dois três quatro cinco seis sete oito nove zero um" ou "12345678901". A função extrairNumeros trata ambos os casos, convertendo palavras numéricas para dígitos.
A palavra "meia"
No Brasil, é comum usar "meia" para o número 6. O mapeamento inclui essa variação.
Pausas e ruído
O SpeechRecognition pode capturar palavras irrelevantes como "é", "ponto", "traço". A função de extração remove tudo que não é dígito ou palavra numérica reconhecida.
Teste da API via cURL
Para validar a integração durante o desenvolvimento:
curl --max-time 10 -X GET "https://api.cpfhub.io/cpf/12345678901" \
-H "x-api-key: SUA_API_KEY_AQUI" \
-H "Accept: application/json"
Boas práticas de acessibilidade complementares
Navegação por teclado
Garanta que o botão de voz seja acessível via Tab e ativável com Enter ou Space. O foco deve ser visível e claro.
Leitores de tela
Teste com NVDA (Windows), VoiceOver (macOS/iOS) e TalkBack (Android). Verifique que:
- O label do campo é anunciado corretamente.
- O feedback de validação é lido automaticamente via
aria-live. - O estado do botão de voz (ativo/inativo) é comunicado.
Alternativas de input
Além de voz e teclado, considere suporte a:
- Câmera -- leitura de CPF em documentos via OCR.
- NFC -- leitura de documentos com chip.
- Colagem -- permitir colar o CPF copiado de outro aplicativo.
Perguntas frequentes
A Web Speech API funciona em todos os navegadores para entrada de CPF por voz?
A API tem suporte completo no Chrome e Edge, e suporte parcial no Safari. No Firefox, o suporte ainda é limitado. Por isso, é fundamental implementar um fallback para o campo de texto tradicional quando o navegador não suporta a API — o botão de voz simplesmente não aparece, e o usuário digita normalmente.
Como a solução lida com sotaques regionais ao ditar o CPF?
O SpeechRecognition com lang: 'pt-BR' já tem boa tolerância a variações regionais. A função extrairNumeros reforça isso ao converter palavras como "meia" (6), "três/tres" e outros por extenso. Em testes, a taxa de reconhecimento correto de sequências numéricas em PT-BR gira em torno de 90-95% em ambiente sem ruído excessivo.
A validação de CPF por voz é compatível com a LGPD?
Sim, desde que o áudio não seja armazenado. A Web Speech API processa o áudio localmente no navegador (ou via serviço do próprio navegador) e retorna apenas o texto transcrito — nenhum áudio chega ao seu servidor. O CPF em texto deve seguir as mesmas regras de qualquer dado pessoal: coletar com finalidade declarada e base legal, conforme orientações da ANPD.
Qual é o tempo total do fluxo de voz até o feedback de validação?
O reconhecimento de voz demora entre 500ms e 2s dependendo da conexão e do navegador. O fluxo completo — do fim da fala ao feedback de validação — leva geralmente entre 1,5s e 3s, o que é aceitável para uma interação por voz.
Conclusão
Implementar validação de CPF por voz não é apenas uma questão de acessibilidade -- é uma melhoria de experiência para todos os usuários. A Web Speech API, combinada com a validação pela API no momento do preenchimento do CPFHub.io, entrega um fluxo fluido e inclusivo sem abrir mão da segurança.
O investimento em acessibilidade se paga com a ampliação do público, a conformidade legal e, principalmente, com o respeito à dignidade de cada usuário que interage com sua plataforma.
Cadastre-se em cpfhub.io
CPFHub.io
Pronto para integrar a API?
50 créditos gratuitos para testar agora. Sem cartão de crédito. Acesso imediato à documentação.




