Revenda números virtuais com a nossa API: preços e margem

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.

Comece