Revenda números virtuais privados com a API do SMS Activate App: compre ao nosso preço na sua conta, some sua margem e atenda clientes no seu bot ou site.
Este guia é para você que quer oferecer números virtuais privados aos seus próprios clientes por meio de um serviço white-label, um bot do Telegram ou um site pequeno. Ele explica como a estrutura funciona, como definir o preço de cada número, quais chamadas da API você precisa, como funciona a cobrança e até onde vai a nossa responsabilidade.
Como a revenda funciona
Você tem uma conta no SMS Activate App e uma chave de API. Você compra números nessa conta pela API. Depois, seu bot ou site mostra a cada cliente o número dele e os códigos de verificação por SMS que chegam nesse número.
Cada número é um número real, móvel ou local, da faixa de uma operadora, conforme o país. Sua conta fica com ele por um período de 28 dias. Ele recebe SMS e chamadas.
Seus clientes são seus. Você recebe os pagamentos deles, responde às dúvidas e define suas próprias condições. Eles não precisam de uma conta conosco. Veja mais sobre esse modelo na página de revenda.
Defina seu preço e sua margem
Nosso preço é definido por número e por país. Você consulta o valor atual pela API:
- GET /v1/public/countries retorna minPriceCents, maxPriceCents e availableNumbers de cada país.
- GET /v1/public/numbers/search?country=US&limit=20 retorna os números à venda no momento. O campo priceCents de cada um é o seu preço.
Todos os valores em dinheiro na API estão em centavos de dólar (USD), como números inteiros.
Seu preço é o nosso preço para aquele número mais a sua margem. Se um número custa C para você e você o vende por P, sua margem é P menos C. Seu percentual de margem é (P menos C) dividido por P. O markup é outro valor: (P menos C) dividido por C. O markup é sempre o maior dos dois, então decida qual deles você quer usar antes de definir uma meta.
Recalcule a partir do preço atual a cada venda. Não trabalhe com uma tabela fixa, porque os preços podem mudar conforme o país. Não existe desconto para revendedor nem faixa por volume: você compra pelo preço normal, o mesmo que aparece em preços.
Inclua também estes custos no seu orçamento:
- Compras definitivas. Depois de emitido, o número é definitivo e não tem reembolso, mesmo que uma plataforma o recuse.
- Decisões da plataforma. Quem decide se aceita um número é a plataforma, não nós. Deixe seus clientes verificarem primeiro se o número funciona no serviço deles, ou inclua esse risco no seu preço.
- Renovação automática. O número é renovado e cobrado a cada 28 dias, a menos que você desative a renovação automática.
- Taxas de pagamento. O seu processador de pagamentos cobra de você uma taxa por cada pagamento de cliente.
- Tempo de suporte. Seus clientes vão fazer perguntas a você, e respondê-las toma o seu tempo.
O fluxo da API, passo a passo
A URL base é https://api.sms-activate.app/v1/public. Toda chamada, inclusive a do catálogo, exige sua chave no cabeçalho Authorization: Bearer vpn_xxx.
- Liste os países. Chame GET /countries para ver quais países têm números e a faixa de preço de cada um.
- Encontre números. Chame GET /numbers/search?country=US&limit=20 para listar os números disponíveis de um país, cada um com o seu preço em priceCents.
- Compre um número. Chame POST /numbers com o corpo JSON {"phone": "+15551234567", "country": "US"} e um cabeçalho Idempotency-Key com um UUID. Se você enviar a mesma chave numa nova tentativa, não será cobrado duas vezes. Uma compra bem-sucedida retorna 201 com o número, chargedCents e balanceAfterCents. Dois campos são opcionais: autoRenew (padrão true) e note. Use note para guardar a referência do seu cliente.
- Leia os códigos. Chame GET /numbers/{id}/sms para um número, ou GET /sms para todos os seus números. As duas chamadas usam paginação por cursor. Para receber os códigos sem precisar consultar, chame PATCH /numbers/{id} com {"forwardWebhookUrl": "https://your-app.example.com/sms"}: a partir daí, cada SMS e cada ligação para esse número são enviados ao seu servidor, assinados com HMAC-SHA256. Associe cada código ao cliente certo antes de mostrá-lo.
- Gerencie o período. Se um cliente não renovar, chame PATCH /numbers/{id} com {"autoRenew": false}. Para liberar um número de que você não precisa mais, chame DELETE /numbers/{id}.
Outras duas chamadas ajudam na contabilidade. GET /balance retorna seu saldo em centavos. GET /v1/me/transactions lista o seu extrato.
Os erros têm sempre o mesmo formato: {"error": "<code>", "message": "...", "reqId": "..."}. Tome decisões com base no código em error, não no status HTTP. Algumas recusas, como insufficientbalance, nonumbers e priceexceeded, são respostas. Mostre-as ao seu cliente em vez de repetir a chamada às cegas. Em ratelimited, espere o tempo indicado no cabeçalho Retry-After.
A especificação completa está no arquivo OpenAPI, e a documentação da API explica cada chamada.
Cobrança: seu saldo conosco
Suas compras são pagas com o saldo da sua conta. No site, você recarrega com cripto (USDT). O bot do Telegram também aceita cartão bancário em rublos e Telegram Stars. Depois que você vincula sua conta, os dois usam um único saldo.
Mantenha saldo suficiente antes dos seus horários de maior movimento. Uma compra feita com saldo insuficiente é recusada com insufficient_balance, e seu cliente fica esperando enquanto você recarrega.
Os saques são pagos somente em USDT (TRON, BSC ou TON). Você mesmo faz o saque na sua conta no site ou no bot do Telegram: até US$ 100 por dia é pago automaticamente em poucos minutos, e um valor maior o suporte paga manualmente mediante solicitação. O dinheiro pago com cartão, recebido como bônus ou por transferência pode ser sacado 180 dias depois de creditado; recargas em cripto, na hora. O mínimo é US$ 10. A taxa é de 10% do valor, com mínimo de 5 USDT, descontada do próprio valor.
Suas próprias compras e o programa de parceiros
Compras na sua própria conta, ou em qualquer conta que você controle, nunca geram comissão de parceiro.
Alguns clientes vão preferir ter uma conta própria. Envie a eles o seu link de parceiro. Você passa a receber de 10% a 30% da nossa margem (não do preço) sobre as compras e renovações deles enquanto a conta deles existir; a parte sobe conforme quantas das pessoas que você trouxe já compraram, de 10% para os primeiros 3 compradores a 30% a partir do comprador 3001. Cada comissão é creditada no seu saldo 30 dias após a compra. Veja os detalhes nas páginas do programa de afiliados e de revenda.
Suporte
Seus clientes falam com você. Você fala conosco. Uma pessoa responde por e-mail em support@sms-activate.app ou no Telegram em t.me/BestVoipTelegram, normalmente em até 24 horas.
Não prometa aos seus clientes mais do que nós prometemos a você. Não prometemos que todo código chegue, nem que uma plataforma aceite um número. A maioria dos códigos chega poucos minutos depois de a plataforma enviá-los. Oriente seus clientes a testar um número no serviço deles antes de depender dele.
Vídeos úteis
Vídeos de terceiros sobre preços, bots do Telegram e design de APIs. Eles ensinam técnicas gerais e não tratam do nosso serviço.
- Markup vs Margin, they are not the same thing! (Brad Flynn): a diferença entre markup e margem, com exemplos numéricos.
- The 6 Components of a SaaS Pricing Model (Willingness to Pay): a métrica, o período, os descontos e o ponto de preço de um modelo de precificação.
- Aiogram Basics: Build Your First Telegram Bot with Python (Almaz | Coding): os conceitos de um bot do Telegram e um primeiro bot funcionando em Python.
- Build a Python Telegram Bot that Accepts Stars Payment (2025) (Nikandr Surkov): como receber pagamentos em Telegram Stars dentro de um bot em Python.
- What is API Idempotency and Why Is It Important? (Be A Better Dev): por que uma compra repetida não pode cobrar duas vezes e como uma chave de idempotência evita isso.
- Polling vs Webhooks | System Design Tradeoffs (SoftwareDude): quando buscar dados novos em intervalos regulares e quando recebê-los automaticamente.
Comece
- Crie uma conta gratuita na página de cadastro.
- Crie uma chave de API no painel da conta, na aba de chaves de API.
- Leia a documentação da API e o arquivo OpenAPI.
- Confira os preços atuais em preços.
- Compre um número e teste seu fluxo do início ao fim antes de abrir as vendas.