Autenticação 2FA via SMS OTP e WhatsApp (API Oficial)

A API de Autenticação 2FA da SMS Barato permite o envio de códigos de verificação por SMS (rota rápida) 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 OTP

A API pode ser utilizada em dois modos:

Manual: Seu sistema gera e valida os códigos, a SMSBarato apenas envia.
Automático: A SMS Barato gera e valida os códigos através de 2 endpoints diferentes.

Após criar sua conta peça a sua chave/token ao nosso suporte por WhatsApp

📩 Envio de Código 2FA "Manual"

Seu sistema gera um código temporário (ex: 6 dígitos)
A SMSBarato envia o código para o usuário via SMS ou WhatsApp (você escolhe pelo template)
O usuário informa o código recebido e 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.

Endpoint:


	  https://sistema81.smsbarato.com.br/2fasend?chave=SUA_CHAVE&dest=11999998888&template=TEMPLATE&empresa=SUA_EMPRESA&codigo=123456

Parâmetros obrigatórios:

chave: sua chave de identificação
dest: número do destinatário (DDD + número)
template: Template da mensagem (veja lista abaixo)
empresa: O nome da sua empresa que vai na mensagem (depende do template)
codigo: O codigo alfanumérico que você quer enviar

📥 Respostas da API

200: { "sent":true }
401: Chave inválida
402: Saldo insuficiente
400: Template/numero/empresa/codigo inválidos
500: Falha interna, tentar novamente

📤 Envio do Código Automático

Seu sistema solicita o envio de código utilizando codigo=auto
A SMSBarato gera um código aleatorio e envia para o usuário por SMS ou WhatsApp (você escolhe pelo template)
O usuário informa no seu sistema o código recebido
Seu sistema consulta o endpoint da SMSBarato /2faverify

⚠️ A SMS Barato gera o código e envia pro usuario.
Seu sistema coleta o número digitado pelo usuario.
A SMSBarato informa se está correto ou não.

Endpoint:


	https://sistema81.smsbarato.com.br/2fasend?chave=SUA_CHAVE&dest=11999998888&template=sms_codigo_simples&empresa=SUA_EMPRESA&codigo=auto

Ao utilizar codigo=auto, a API gera automaticamente um código temporário e o envia ao usuário.

📥 Validar Código Informado pelo Usuário

Endpoint:


	https://sistema81.smsbarato.com.br/2faverify?chave=SUA_CHAVE&dest=11999998888&template=sms_codigo_simples&codigo=123456

Parâmetros:

chave: sua chave de identificação
dest: número utilizado no envio
template: template utilizado no envio
codigo: código digitado pelo usuário

✅ Respostas da Validação

{ "verified":true }

Templates aprovados WhatsApp:

whatsapp_2fa: Seu código de verificação é {{code}}.
whatsapp_otp: Código OTP: {{code}}. Este é o seu código de senha descartável para {{empresa}}. Para sua segurança, não compartilhe este código.
whatsapp_recuperacao: {{code}} é o código de recuperação da sua senha.
whatsapp_autorizar: Use o código {{code}} para autorizar a sua transação.

Templates aprovados SMS:

sms_codigo_simples: Seu codigo de acesso para {{empresa}}: {{code}}
sms_login_simples: {{code}} e seu codigo de verificacao. Nao compartilhe.
sms_login_empresa: {{code}} e seu codigo de verificacao para {{empresa}}. Nao compartilhe.
sms_acesso_rapido: {{code}} - Codigo de acesso para {{empresa}}.
sms_cadastro: {{code}} e o codigo para confirmar sua conta {{empresa}}.
sms_recuperacao_senha: {{code}} e seu codigo para redefinir a senha {{empresa}}. Nao compartilhe.
sms_transacao: {{code}} confirma a operacao na {{empresa}}. Nao compartilhe.
sms_verificacao: Codigo de verificacao: {{code}} para {{empresa}}
sms_login_servico: {{code}} e o codigo para {{empresa}}.
sms_codigo_acesso: Seu codigo de acesso para {{empresa}} e {{code}}. Valido por 5 min.
sms_confirmacao: {{code}} e o codigo de confirmacao {{empresa}}. Nao compartilhe com ninguem.
sms_curto_empresa: {{empresa}}: {{code}} (codigo de verificacao)
sms_financial: {{code}} confirma transacao {{empresa}}.
sms_boas_vindas: {{code}} - Bem-vindo(a) a {{empresa}}. Codigo de ativacao.
sms_2fa_padrao: {{code}} e seu codigo 2FA {{empresa}}.

📌 Exemplo completo de envio 2FA

Nome do template: whatsapp_verificar_empresa

📤 Chamada da API


	  https://sistema81.smsbarato.com.br/2fasend?chave=SUA_CHAVE&dest=11999998888&template=whatsapp_verificar_empresa&empresa=SUA_EMPRESA&codigo=123456

Mensagem recebida no WhatsApp:

Use o código 123456 para verificar sua transação de SUA_EMPRESA.

📥 Respostas da API

200: Envio realizado com sucesso
401: Chave inválida
402: Saldo insuficiente
400: Template/numero/empresa/codigo inválidos
500: Falha interna, tentar novamente

Consultar seu saldo

https://sistema81.smsbarato.com.br/saldo?chave=SUA_CHAVE

ℹ️ 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