SMS Activate App API'siyle özel sanal numara bayiliği: hesabınızda fiyatımızla alın, marjınızı ekleyin, müşterilere botunuz veya sitenizden sunun.
Kendi müşterilerinize beyaz etiket (white-label) bir hizmet, bir Telegram botu veya küçük bir site üzerinden özel sanal numara sunmak istiyorsanız bu rehber sizin için. Rehber; kurulumun nasıl işlediğini, her numaranın nasıl fiyatlandırılacağını, ihtiyacınız olan API çağrılarını, faturalandırmanın nasıl yürüdüğünü ve sorumluluğumuzun nerede bittiğini anlatır.
Bayilik nasıl işler
SMS Activate App'te bir hesabınız ve bir API anahtarınız olur. Numaraları bu hesap üzerinden API ile satın alırsınız. Ardından botunuz veya siteniz her müşteriye kendi numarasını ve o numaraya gelen SMS doğrulama kodlarını gösterir.
Her numara, ülkeye göre bir operatörün numara aralığından gelen gerçek bir mobil veya yerel numaradır. Hesabınız numarayı 28 günlük bir süre boyunca elinde tutar. Numara SMS ve arama alır.
Müşterileriniz sizin müşterilerinizdir. Ödemelerini siz alırsınız, sorularını siz yanıtlarsınız, koşullarınızı siz belirlersiniz. Müşterilerinizin bizde hesap açması gerekmez. Bu model hakkında daha fazlası bayi sayfasında.
Fiyatınızı ve marjınızı belirleyin
Fiyatımız numara ve ülke bazında belirlenir. Fiyatı API'den canlı olarak okursunuz:
- GET /v1/public/countries her ülke için minPriceCents, maxPriceCents ve availableNumbers değerlerini döndürür.
- GET /v1/public/numbers/search?country=US&limit=20 satışta olan canlı numaraları döndürür. Her birinin priceCents alanı sizin fiyatınızdır.
API'deki tüm tutarlar tam sayı olarak ABD doları sentidir.
Sizin fiyatınız, o numara için bizim fiyatımız artı marjınızdır. Bir numaranın size maliyeti C ise ve onu P fiyatına satıyorsanız, marjınız P eksi C olur. Marj yüzdeniz (P eksi C) bölü P'dir. Kâr ekleme oranı (markup) farklı bir değerdir: (P eksi C) bölü C. Kâr ekleme oranı her zaman ikisinden büyük olanıdır. Bu yüzden bir hedef belirlemeden önce hangisini kastettiğinize karar verin.
Her satışta canlı fiyattan yeniden hesaplayın. Sabit bir listeyle çalışmayın, çünkü fiyatlar ülkeye göre değişebilir. Bayi indirimi veya hacim kademesi yoktur: fiyatlar sayfasında gösterilen normal fiyattan satın alırsınız.
Şu maliyetleri de bütçenize katın:
- Kesin satın almalar. Bir numara verildiği anda kesinleşir ve iade edilmez, platform numarayı reddetse bile.
- Platform kararları. Bir numarayı kabul edip etmeyeceğine biz değil, platform karar verir. Müşterilerinizin önce numaranın kendi hizmetinde çalışıp çalışmadığını kontrol etmesine izin verin ya da bu riski fiyatınıza yansıtın.
- Otomatik yenileme. Otomatik yenilemeyi kapatmadığınız sürece numara her 28 günde bir yenilenir ve ücretlendirilir.
- Ödeme komisyonları. Kendi ödeme sağlayıcınız her müşteri ödemesi için sizden ücret alır.
- Destek süresi. Müşterileriniz size soru soracak ve bunları yanıtlamak zamanınızı alacak.
Adım adım API akışı
Temel URL: https://api.sms-activate.app/v1/public. Katalog dahil her çağrı, Authorization: Bearer vpn_xxx başlığında anahtarınızı gerektirir.
- Ülkeleri listeleyin. Hangi ülkelerde numara olduğunu ve fiyat aralıklarını görmek için GET /countries çağrısını yapın.
- Numara bulun. Bir ülkenin canlı numaralarını listelemek için GET /numbers/search?country=US&limit=20 çağrısını yapın. Her numaranın priceCents alanında sizin fiyatınız yer alır.
- Numara satın alın. POST /numbers çağrısını {"phone": "+15551234567", "country": "US"} JSON gövdesiyle ve bir UUID'ye ayarlanmış Idempotency-Key başlığıyla yapın. Yeniden denemede aynı anahtarı gönderirseniz sizden iki kez ücret alınmaz. Başarılı bir satın alma, numarayla birlikte chargedCents ve balanceAfterCents değerlerini içeren 201 yanıtı döndürür. İki alan isteğe bağlıdır: autoRenew (varsayılan değer true) ve note. Müşterinizin referansını saklamak için note alanını kullanın.
- Kodları okuyun. Tek bir numara için GET /numbers/{id}/sms, tüm numaralarınız için GET /sms çağrısını yapın. İkisi de imleç (cursor) tabanlı sayfalama kullanır. Kodların size kendiliğinden gelmesini istiyorsanız {"forwardWebhookUrl": "https://your-app.example.com/sms"} gövdesiyle PATCH /numbers/{id} çağrısını yapın: bundan sonra o numaraya gelen her SMS ve her arama, HMAC-SHA256 ile imzalanarak sunucunuza gönderilir. Her kodu göstermeden önce doğru müşteriyle eşleştirin.
- Süreyi yönetin. Bir müşteri yenilemezse {"autoRenew": false} gövdesiyle PATCH /numbers/{id} çağrısını yapın. Artık ihtiyacınız olmayan bir numarayı bırakmak için DELETE /numbers/{id} çağrısını yapın.
Muhasebe için iki çağrı daha işinize yarar. GET /balance bakiyenizi sent cinsinden döndürür. GET /v1/me/transactions hesap ekstrenizi listeler.
Hatalar tek bir biçimde gelir: {"error": "<code>", "message": "...", "reqId": "..."}. Mantığınızı HTTP durum koduna göre değil, error koduna göre kurun. insufficientbalance, nonumbers ve priceexceeded gibi bazı retler birer yanıttır. İsteği körü körüne tekrarlamak yerine bunları müşterinize gösterin. ratelimited yanıtında Retry-After başlığının belirttiği süre kadar bekleyin.
Tam şartname OpenAPI dosyasında yer alır. API belgeleri her çağrıyı açıklar.
Faturalandırma: bizdeki bakiyeniz
Satın almalarınız hesap bakiyenizden ödenir. Web sitesinde bakiyenizi kripto parayla (USDT) yüklersiniz. Telegram botu ayrıca ruble banka kartı ve Telegram Stars kabul eder. Hesabınızı bağladığınızda ikisi aynı bakiyeyi kullanır.
Yoğun saatlerinizden önce yeterli bakiye bulundurun. Bakiye yetersizse satın alma insufficient_balance hatasıyla reddedilir ve siz bakiye yüklerken müşteriniz bekler.
Para çekme işlemleri yalnızca USDT (TRON, BSC veya TON) ile ödenir. Çekimi sitedeki hesabınızda veya Telegram botunda kendiniz yaparsınız: günde 100 dolara kadar olan çekimler birkaç dakika içinde otomatik ödenir, daha yüksek tutarı ise destek talep üzerine elle öder. Kartla ödenen, bonus olarak verilen veya aktarımla gelen para, geldikten 180 gün sonra çekilebilir; kripto yüklemeleri hemen çekilir. Alt sınır 10 dolardır. Ücret tutarın %10'udur, ancak 5 USDT'den az olamaz ve tutardan düşülür.
Kendi satın alımlarınız ve ortaklık programı
Kendi hesabınızda veya kontrol ettiğiniz herhangi bir hesapta yaptığınız satın alımlar hiçbir zaman ortaklık komisyonu kazandırmaz.
Bazı müşterileriniz kendi hesaplarını kullanmayı tercih eder. Onlara ortaklık bağlantınızı gönderin. Böylece onların satın alımları ve yenilemeleri üzerinden, hesapları var olduğu sürece kâr marjımızdan (fiyattan değil) %10 ile %30 arası bir pay kazanırsınız; pay, getirdiğiniz kişilerden satın alanlar arttıkça ilk 3 alıcı için %10'dan 3001. alıcıdan başlayarak %30'a yükselir. Her komisyon, satın alımdan 30 gün sonra bakiyenize eklenir. Ayrıntılar ortaklık programı ve bayi sayfalarında.
Destek
Müşterileriniz size ulaşır. Siz de bize ulaşırsınız. support@sms-activate.app adresine e-posta gönderdiğinizde veya Telegram'da t.me/BestVoipTelegram üzerinden yazdığınızda size bir kişi yanıt verir, genellikle 24 saat içinde.
Müşterilerinize, bizim size verdiğimizden fazla söz vermeyin. Her kodun geleceğine söz vermiyoruz. Bir platformun numarayı kabul edeceğine de söz vermiyoruz. Çoğu kod, platform gönderdikten sonra birkaç dakika içinde gelir. Müşterilerinize, bir numaraya güvenmeden önce onu kendi hizmetleri için test etmelerini söyleyin.
Faydalı videolar
Fiyatlandırma, Telegram botları ve API tasarımı üzerine üçüncü taraf videoları. Genel teknikleri anlatırlar, hizmetimizi kapsamazlar.
- Markup vs Margin, they are not the same thing! (Brad Flynn): maliyet üzerinden kâr oranı (markup) ile kâr marjı arasındaki fark, hesaplanmış örneklerle.
- The 6 Components of a SaaS Pricing Model (Willingness to Pay): bir fiyatlandırma modelinin ölçütü, dönemi, indirimleri ve fiyat noktası.
- Aiogram Basics: Build Your First Telegram Bot with Python (Almaz | Coding): Telegram botu kavramları ve Python ile çalışan ilk bot.
- Build a Python Telegram Bot that Accepts Stars Payment (2025) (Nikandr Surkov): bir Python botunun içinde Telegram Stars ile ödeme almak.
- What is API Idempotency and Why Is It Important? (Be A Better Dev): yeniden denenen bir satın almanın neden iki kez ücretlendirilmemesi gerektiği ve bir idempotency anahtarının bunu nasıl önlediği.
- Polling vs Webhooks | System Design Tradeoffs (SoftwareDude): yeni verileri ne zaman bir zamanlayıcıyla sorgulamanız, ne zaman size gönderilmesini sağlamanız gerektiği.
Başlayın
- Kayıt sayfasında ücretsiz bir hesap oluşturun.
- Hesap panelinde, API anahtarları sekmesinden bir API anahtarı oluşturun.
- API belgelerini ve OpenAPI dosyasını okuyun.
- Güncel fiyatları fiyatlandırma sayfasında kontrol edin.
- Satışa başlamadan önce bir numara satın alın ve akışınızı baştan sona test edin.