Como montar um painel de SMS próprio usando a API
Um painel de SMS próprio é um site onde os seus clientes compram números virtuais e veem o código chegar, com a sua marca e o seu preço. Por trás, cada ação do painel vira uma chamada à API do Flash SMS, e o dinheiro sai do saldo da sua conta.
- Monte o catálogo.
- Crie o saldo dos seus clientes.
- Faça a tela de compra.
- Faça a tela de espera.
- Feche o ciclo.
Passo a passo
Como montar um painel de SMS próprio usando a API
Monte o catálogo
Use getServicesList e getCountries para os nomes e códigos, e getPrices para custo e estoque. Guarde em cache por alguns minutos e aplique a sua margem.
Crie o saldo dos seus clientes
Cada cliente tem um saldo no seu sistema, que você controla. A cobrança dele é sua; o Flash SMS só debita o seu saldo de revendedor.
Faça a tela de compra
Ao clicar em comprar, o seu servidor chama getNumber ou getNumberV2, grava o id da ativação e desconta o valor do cliente.
Faça a tela de espera
Mostre o número, um cronômetro de 20 minutos e o código assim que getStatus devolver STATUS_OK.
Feche o ciclo
Finalize com setStatus status=6 depois do código, ou cancele com status=8 a partir de 2 minutos e devolva o valor ao cliente.
As telas que um painel precisa
- Login e cadastro dos seus clientes.
- Recarga do saldo do cliente, com a forma de pagamento que você escolher.
- Lista de serviços com busca, país e preço já com a sua margem.
- Números ativos, com cronômetro, botão de copiar e botões de cancelar e de pedir outro SMS.
- Histórico de compras com data, serviço, número, código e valor.
Onde ficam a chave e as chamadas
A chave da API dá acesso ao seu saldo. Ela fica só no servidor, numa variável de ambiente, nunca no JavaScript do navegador nem no aplicativo do cliente. O navegador conversa com o seu servidor, e o seu servidor conversa com a API.
Grave cada ativação numa tabela própria: id do Flash SMS, cliente, serviço, país, servidor, número, custo, preço cobrado, status e código. Com isso você responde qualquer reclamação e confere o caixa no fim do dia.
Servidores e filtros
A API tem os mesmos três fornecedores do painel do Flash SMS (server=1, 2 ou 3), com estoques e preços diferentes; na API a numeração é outra: server=1 é o Servidor 1 do painel, server=3 é o Servidor 2 e server=2 é o Servidor 3. Você pode esconder isso do cliente e escolher o mais barato com estoque, ou mostrar as opções. No server=2, números do Brasil aceitam operator (sem custo extra) e ddd (com 30% a mais), o que permite oferecer escolha de DDD no seu painel.
Estornos e consistência
Sem SMS, o valor volta para o seu saldo no Flash SMS automaticamente. O seu painel precisa espelhar isso: quando getStatus devolver STATUS_CANCEL, devolva o crédito ao cliente. Um job que roda a cada poucos minutos e revisa ativações antigas sem status final evita saldo preso por queda do servidor.
Dúvidas
Perguntas frequentes
Preciso de muito saldo para começar?
Não há mínimo além da recarga normal. Comece com pouco, teste o fluxo com você mesmo como cliente e aumente conforme as vendas.
O meu cliente vê que o número vem do Flash SMS?
Não precisa ver. O painel é seu, com a sua marca. As regras de uso continuam valendo para os seus clientes.
Posso oferecer outro SMS no mesmo número?
Sim. setStatus com status=3 pede outro SMS sem custo, dentro dos 20 minutos e depois do primeiro código. Depois, continue consultando getStatus.
Como sei que meu saldo vai acabar?
Consulte getBalance periodicamente e crie um alerta abaixo de um valor que você define. Sem saldo, getNumber responde NO_BALANCE.
API e integrações
Continue lendo
API de número virtual para WhatsApp: o fluxo completo
service=wa, do getNumber ao setStatus, com cada resposta possível.
Como precificar a revenda de números virtuais
Custo do getPrices, margem em percentual e regras para quando o custo muda.
Bot do Telegram para vender números virtuais: como estruturar
Comandos, servidor, banco de dados e a rotina que entrega o código.
Como testar o envio de OTP por SMS em homologação
Números reais de operadoras brasileiras para validar o SMS do seu produto.
Como automatizar o recebimento do código SMS pela API
Consulta periódica com getStatus, os estados possíveis e quando parar.
Erros comuns da API do Flash SMS e como resolver
Cada resposta de erro da documentação, com a causa e a correção.
Receba seu primeiro código hoje
Cadastro em menos de um minuto, recarga por Pix, cartão ou cripto e o SMS no painel. Se não chegar, o valor volta.
Criar conta grátis