Autenticação 2FA via SMS e WhatsApp
A API de Autenticação 2FA da SMS Barato permite o envio de
códigos de verificação por SMS ou
WhatsApp (API Oficial da Meta), aumentando a segurança
de logins, acessos e confirmações sensíveis.
Esse tipo de autenticação é ideal para:
- Login de usuários
- Confirmação de identidade
- Reset de senha
- Operações financeiras
- Validação de cadastros
🔐 Funcionamento do 2FA
- Seu sistema gera um código temporário (ex: 6 dígitos)
- O código é enviado via SMS ou WhatsApp pela API
- O usuário informa o código recebido
- Seu sistema valida o código internamente
⚠️ A SMS Barato realiza apenas o envio da mensagem.
A geração, validade e verificação do código devem ser feitas no seu sistema.
📩 Envio de Código 2FA via SMS
Endpoint:
https://sistema81.smsbarato.com.br/send
Exemplo de chamada:
https://sistema81.smsbarato.com.br/send?chave=SUA_CHAVE&dest=11999998888&text=Seu+codigo+de+verificacao+e:+123456
Parâmetros obrigatórios:
- chave: sua chave de identificação
- dest: número do destinatário (DDD + número)
- text: texto da mensagem (sem acentos ou quebras de linha)
Exemplo de mensagem SMS:
Seu codigo de verificacao e: 123456
💬 Envio de Código 2FA via WhatsApp (API Oficial)
O envio de 2FA via WhatsApp utiliza templates de autenticação,
previamente aprovados pela Meta.
📌 Exemplo de Template 2FA
Nome do template: 2fa
Mensagem cadastrada:
Seu código de verificação é: {{1}}. Ele é válido por 5 minutos.
📤 Chamada da API
https://sistema81.smsbarato.com.br/sendwa?chave=SUA_CHAVE&dest=11999998888&template=2fa&prm[]=123456
Parâmetros obrigatórios:
- chave: sua chave de identificação
- dest: número do destinatário (DDD + número)
- template: nome do template aprovado
- prm[]: código de verificação
Mensagem recebida no WhatsApp:
Seu código de verificação é: 123456. Ele é válido por 5 minutos.
📥 Respostas da API
- Número: envio realizado com sucesso (ID da mensagem)
- ERRO1-1: chave inválida
- ERRO1-2: IP não autorizado
- ERRO1-3: saldo insuficiente
- ERRO2: número de destino inválido
- ERRO3: template inexistente ou não aprovado (WhatsApp)
ℹ️ Boas Práticas para 2FA
- Utilize códigos aleatórios de 4 a 6 dígitos
- Defina validade curta (ex: 3 a 5 minutos)
- Não reutilize códigos
- Evite incluir links ou mensagens promocionais