Buraya başlayın

İlk isteğiniz dört adımda

Keep your main SMSMobileAPI subscription active; Telegram connection, API access, sending and sent-message history pause when it expires.

Panodaki QR code ile kendi Telegram hesabınızı bağlayın ve kişilerini senkronize edin.

SMSMobileAPI anahtarınızı My API Key bölümünden kopyalayın ve sunucunuzda saklayın.

Kişileri listeleyin ve hedef alıcının contact_id'sini kopyalayın.

Send JSON for text, or multipart/form-data to attach an image or document. Use the returned message_id to check the sent log.

SİZİN TELEGRAM HESABINIZ

Bağlanın, bir kişi seçin, ardından gönderiyi takip edin.

Hesap kapsamı

Her müşteri kendi Telegram hesabını bağlamak için QR code'i tarar. Panoda kişileri senkronize edin, dönen contact ID ile bir mesaj sıraya alın, ardından gönderilenler kaydında durumunu inceleyin.

1

Bağlamak

Telegram kontrol paneli sayfasında QR code'i tarayın.

2

Bir kişi bulun

Senkronize edin, ardından API üzerinden contact ID'yi arayın.

3

Göndermek

Bir idempotency anahtarı ile bir JSON mesajını POST edin.

4

Takip et

Sıradaki (queued), gönderildi (sent), bilinmeyen (unknown) veya hata (error) durumlarını okuyun.

Kimlik doğrulama

Kimlik bilgilerini sunucunuzda tutun

Send X-SMSMobileAPI-Key: YOUR_API_KEY in an HTTPS header. Keep this key on your server, never in browser JavaScript or a public repository. The endpoints are scoped to the Telegram account connected to that SMSMobileAPI account. A short-lived signed download_url can be opened without the key. Access can be disabled in My API Key.

entegre etmeden önce bütünleşmeden önce

An expired SMSMobileAPI subscription blocks Telegram API access with HTTP 402 subscription_expired, including attachment downloads. Renew in the dashboard to restore access; existing connection and history are preserved.
QR code her müşterinin kendi Telegram hesabını bağlar. Mesajlar paylaşılan bir SMSMobileAPI hesabından değil, o hesaptan gönderilir.
202 yanıtı isteğin sıraya alındığı anlamına gelir. Bu, Telegram'in mesajı kabul ettiğini veya teslim ettiğini kanıtlamaz. Gönderilenler kayıtlarını (sent log) gönderildi veya hata durumlarını kontrol etmek için yoklayın.
Hizmet şu anda istekte her seferinde bir senkronize edilmiş kişi veya kaydedilmiş @kullanıcı-adına gönderir. Telegram kurallarına ve alıcının rızasına uyun.
İstekler dakikada 15 yeni mesaj ve bağlı hesap başına 30 sıralı mesaj ile sınırlıdır. Yeniden denemelerde kararlı bir idempotency_key kullanın.
Images and documents can be up to 5 MB. The send queue holds file bytes only until processing finishes; a separate private copy supports later downloads. File bytes are never embedded in the sent log.
Newly sent attachments are kept in private storage for 90 days. The sent log returns a download_url valid for 15 minutes; request the log again to get a new link. Older attachments sent before this feature have no downloadable copy.

ELDE ETMEK

Telegram kişilerini listele

ENDPOINThttps://api.smsmobileapi.com/telegram/contacts/

Bağlı Telegram hesabınızdaki kullanılabilir kişileri döndürür.

Ne zaman kullanılmalı

Görünen ada veya @kullanıcı-adına göre arayın, ardından göndermek için contact_id kullanın.

Parametreler

Ad	Tür	Gereklilik	Tanım
`q`	dize	Seçmeli	İsteğe bağlı isim veya kullanıcı adı araması, en fazla 80 karakter.
`limit`	Tamsa	Seçmeli	Sayfa boyutu 1 ile 100 arası; varsayılan 50.
`cursor`	Tamsa	Seçmeli	İlk sayfa için atlayın; önceki yanıttan paging.next_cursor kullanın.

Örneğin

kıvrımlı

curl -G 'https://api.smsmobileapi.com/telegram/contacts/' \
  -H 'X-SMSMobileAPI-Key: YOUR_API_KEY' \
  --data-urlencode 'q=Alex' \
  --data-urlencode 'limit=50'

Örnek yanıt

JSON

{"ok":true,"data":[{"contact_id":42,"display_name":"Alex Example","username":"alex_example","source":"telegram"}],"paging":{"has_more":false,"next_cursor":null}}

Bu isteği çalıştırmak ister misiniz?API anahtarını interaktif testleyiciyi kilidini açmak için sayfanın başında bağlayın.

Anahtarı bağlayın ↑

İyi bilmek

Contact ID'ler bağlı hesaba aittir; başka bir hesaba ait bir ID kullanılamaz.
Yeni bir kişi görünmüyorsa Panodan → Telegram Contacts ile kişileri yenileyin.

POSTALAMAK

Bir Telegram mesajı gönderin

ENDPOINThttps://api.smsmobileapi.com/telegram/send/

Bağlı Telegram hesabınızdan bir kişi için bir metin mesajı sıraya alır.

Ne zaman kullanılmalı

Kişiler uç noktasından contact_id kullanın. İzleme için message_id'yi kaydedin.

Parametreler

Ad	Tür	Gereklilik	Tanım
`contact_id`	Tamsa	Gerekli	Contact ID /telegram/contacts/ tarafından döndürülür.
`message`	dize	Gerekli	UTF-8 metin, 1–4096 karakter ve en fazla 16.000 bayt.
`idempotency_key`	UUID dizesi	Seçmeli	Kararlı 36 karakterlik küçük harf UUID-benzeri anahtar. Çoğaltılmış mesajları önlemek için ağ yeniden denemelerinde yeniden kullanın.

Örneğin

kıvrımlı

curl -X POST 'https://api.smsmobileapi.com/telegram/send/' \
  -H 'X-SMSMobileAPI-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"contact_id":42,"message":"Your appointment is confirmed.","idempotency_key":"2d40bb10-cc42-4c30-a282-93fc6dd8e161"}'

Örnek yanıt

JSON

{"ok":true,"message_id":123,"status":"queued","idempotency_key":"2d40bb10-cc42-4c30-a282-93fc6dd8e161","duplicate":false}

Bu isteği çalıştırmak ister misiniz?API anahtarını interaktif testleyiciyi kilidini açmak için sayfanın başında bağlayın.

Anahtarı bağlayın ↑

İyi bilmek

HTTP 202 beklemeye alındığını belirtir; bu bir teslim alındı bildirimi değildir. Aynı isteğin tekrarında HTTP 200 duplicate=true ve orijinal message_id ile döner.
Yeniden denemeler için aynı kişi ve mesaj ile aynı idempotency_key'i yeniden kullanın. Aynı anahtar ile değişen bir yük HTTP 409 döndürür.

POSTALAMAK

Send a Telegram image or document

ENDPOINThttps://api.smsmobileapi.com/telegram/send/

Queue one file for a contact, with an optional caption.

Ne zaman kullanılmalı

Use multipart/form-data. The field name for the attachment is file.

Parametreler

Ad	Tür	Gereklilik	Tanım
`contact_id`	Tamsa	Gerekli	Contact ID /telegram/contacts/ tarafından döndürülür.
`file`	file	Gerekli	One JPG, PNG, WebP, PDF, TXT, CSV, JSON, ZIP or Office file, at most 5 MB.
`message`	dize	Seçmeli	Optional caption of at most 1024 characters.
`idempotency_key`	UUID dizesi	Seçmeli	Reuse the same key and identical file and caption when retrying.

Örneğin

kıvrımlı

curl -X POST 'https://api.smsmobileapi.com/telegram/send/' \
  -H 'X-SMSMobileAPI-Key: YOUR_API_KEY' \
  -F 'contact_id=42' \
  -F 'message=Here is the document.' \
  -F 'file=@./document.pdf' \
  -F 'idempotency_key=2d40bb10-cc42-4c30-a282-93fc6dd8e161'

Örnek yanıt

JSON

{"ok":true,"message_id":124,"status":"queued","idempotency_key":"2d40bb10-cc42-4c30-a282-93fc6dd8e161","duplicate":false}

Bu isteği çalıştırmak ister misiniz?API anahtarını interaktif testleyiciyi kilidini açmak için sayfanın başında bağlayın.

Anahtarı bağlayın ↑

İyi bilmek

Do not set Content-Type manually; cURL adds the multipart boundary.
For JSON clients, send file_base64 with the Base64 file contents and filename, alongside contact_id and an optional message caption.
A queued response is not proof of delivery. Check GET /telegram/sent/?message_id=124.
The connected Telegram account sends the file to one contact.

POSTALAMAK

Send a Telegram file using JSON

ENDPOINThttps://api.smsmobileapi.com/telegram/send/

Queue one image or document using a Base64 string when multipart upload is inconvenient.

Ne zaman kullanılmalı

Encode the original file bytes with Base64. Do not include an API key in the JSON body.

Parametreler

Ad	Tür	Gereklilik	Tanım
`contact_id`	Tamsa	Gerekli	Contact ID /telegram/contacts/ tarafından döndürülür.
`filename`	dize	Gerekli	Original file name, for example photo.png or invoice.pdf.
`file_base64`	dize	Gerekli	Raw Base64 file contents or a data URI; decoded file must be 5 MB or smaller.
`message`	dize	Seçmeli	Optional caption of at most 1024 characters.
`idempotency_key`	UUID dizesi	Seçmeli	Reuse the same key with identical file contents, filename and caption on retries.

Örneğin

kıvrımlı

curl -X POST 'https://api.smsmobileapi.com/telegram/send/' \
  -H 'X-SMSMobileAPI-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"contact_id":42,"filename":"photo.png","file_base64":"BASE64_ENCODED_FILE","message":"See attached","idempotency_key":"2d40bb10-cc42-4c30-a282-93fc6dd8e161"}'

Örnek yanıt

JSON

{"ok":true,"message_id":125,"status":"queued","idempotency_key":"2d40bb10-cc42-4c30-a282-93fc6dd8e161","duplicate":false}

Bu isteği çalıştırmak ister misiniz?API anahtarını interaktif testleyiciyi kilidini açmak için sayfanın başında bağlayın.

Anahtarı bağlayın ↑

İyi bilmek

Replace BASE64_ENCODED_FILE with the actual Base64 of a supported file.
Use multipart/form-data instead if your client supports direct file upload; it avoids Base64 size overhead.

ELDE ETMEK

Gönderilmiş Telegram mesajlarını listele

ENDPOINThttps://api.smsmobileapi.com/telegram/sent/

En yeni önce olacak şekilde beklemedeki, gönderilen, gönderiliyor ve başarısız mesajları döndürür.

Ne zaman kullanılmalı

Bu uç noktayı /telegram/send/ tarafından döndürülen bir mesajı takip etmek için message_id ile sorgulayın.

Parametreler

Ad	Tür	Gereklilik	Tanım
`message_id`	Tamsa	Seçmeli	/telegram/send/ tarafından döndürülen belirli mesaj kimliğini döndürün.
`contact_id`	Tamsa	Seçmeli	Sonuçları tek bir iletişim kimliğiyle sınırlandırın.
`status`	queued \| sending \| sent \| error \| unknown	Seçmeli	Gönderim durumuna göre filtrele.
`limit`	Tamsa	Seçmeli	Sayfa boyutu 1 ile 100 arası; varsayılan 50.
`cursor`	Tamsa	Seçmeli	Daha eski mesajları almak için paging.next_cursor kullanın.

Örneğin

kıvrımlı

curl -G 'https://api.smsmobileapi.com/telegram/sent/' \
  -H 'X-SMSMobileAPI-Key: YOUR_API_KEY' \
  --data-urlencode 'message_id=123'

Örnek yanıt

JSON

{"ok":true,"data":[{"message_id":123,"contact_id":42,"contact_name":"Alex Example","username":"alex_example","message":"Your appointment is confirmed.","type":"text","media":null,"status":"sent","telegram_message_id":781,"error_code":null,"error_detail":null,"attempts":1,"queued_at":"2026-11-06T09:42:00+00:00","sent_at":"2026-11-06T09:42:04+00:00"}],"paging":{"has_more":false,"next_cursor":null}}

Bu isteği çalıştırmak ister misiniz?API anahtarını interaktif testleyiciyi kilidini açmak için sayfanın başında bağlayın.

Anahtarı bağlayın ↑

İyi bilmek

The top-level type is text, image or file. For an attachment, media contains the filename, MIME type, size, download_url and available_until; media is null for text messages. File bytes are not embedded in the log.
The download_url opens in a browser for 15 minutes. Refresh this endpoint for a new link while the file remains available.
sent, Telegram'in bağlı hesaptan mesajı kabul ettiği anlamına gelir; alıcı teslimatı ve okuma makbuzları raporlanmaz.
unknown, gönderim sonucunun doğrulanamadığı anlamına gelir. Bu durumda mesajı otomatik olarak yeniden göndermeyin.

ELDE ETMEK

Download a sent Telegram attachment

ENDPOINThttps://api.smsmobileapi.com/telegram/media/

Downloads a previously sent image or document while it remains available.

Ne zaman kullanılmalı

Use media.download_url from the sent log, or call this endpoint with the account API key.

Parametreler

Ad	Tür	Gereklilik	Tanım
`message_id`	Tamsa	Gerekli	Message ID returned by /telegram/send/.

Örneğin

kıvrımlı

curl -L 'https://api.smsmobileapi.com/telegram/media/?message_id=124' \
  -H 'X-SMSMobileAPI-Key: YOUR_API_KEY' \
  -o attachment

Örnek yanıt

JSON

Binary image or document bytes (Content-Type matches the file)

Bu isteği çalıştırmak ister misiniz?API anahtarını interaktif testleyiciyi kilidini açmak için sayfanın başında bağlayın.

Anahtarı bağlayın ↑

İyi bilmek

A download_url returned by /telegram/sent/ is signed and works without an API key for 15 minutes. Keep it private.
The authenticated endpoint requires the Telegram sent-log API access switch.
Files are retained for 90 days; the type and filename remain in the log after expiry.

Sorun giderme

Hatalar ve güvenli yenidenrries

HTTP statüsünü ve JSON hata alanını yeniden denemeden önce okuyun. İstekyi ilk önce düzeltmeden doğrulama veya doğrulama başarısızlıklarını yeniden denemeyin.

HTTP	Kod Kodu Kodu	Ne yapmalı
401	`api_key_required / invalid_api_key`	Geçerli bir X-SMSMobileAPI-Key başlığı gönderin.
402	`subscription_expired`	Renew the SMSMobileAPI subscription linked to the API key. Telegram API access resumes after renewal.
403	`API_ENDPOINT_DISABLED`	My API Key içinde Telegram API'i veya bu özel endpoint'i etkinleştirin.
404	`contact_not_found`	Kişileri senkronize edin ve kendi Telegram bağlantınızdan bir ID kullanın.
409	`telegram_not_connected / idempotency_conflict`	Değişen içerik için Telegram bağlayın veya yeni bir idempotency anahtarı seçin.
422	`invalid_message / invalid_pagination`	Mesajı, contact ID'yi veya sayfalama (paging) parametrelerini düzeltin.
429	`queue_full / rate_limited`	Bekleyen gönderimler veya dakikalık limit temizlenene kadar bekleyin.
503	`sending_unavailable / service_unavailable`	Gönderim görevlisi veya depolama geçici olarak kullanılamıyor; daha sonra yeniden deneyin.
503	`media_not_ready`	File sending requires the current Telegram service update. Text sending remains available.
404 / 410	`media_not_found / media_expired`	The file is unavailable or past its 90-day retention period.

Yeniden deneme kuralıYeniden deneme sadece 429 ve 5xx yanıtlarını geçici olarak yeniden deneyin. 1 saniye sonra, sonra 2, 4 ve 8 saniyeye kadar geri başlayın.

Yardıma mı ihtiyacınız var?

İstek bağlamını getir - sırlarınız değil.

Son noktayı paylaşın, zamantamp, HTTP durumu ve sanitized yanıt. API anahtarlarını, jetonları veya özel mesaj içeriğini asla dahil etmeyin.

İletişim API destek

Güvenli SMSMobileAPI mobil uygulama bir telefona web paniğe ve REST API'e SMS için bir telefon ve operasyon çağrısı — Şifrelenmiş mobil platform bağlantı bağlantı bağlantı

Resmi mobil uygulama

Telefonunuz, kontrol paneliniz ve API arasındaki güvenli köprü.

SMS ve çağrı işlemleri, bağlı telefonunuza yüklenen resmi SMSMobileAPI uygulaması üzerinden geçer. Uygulama, cihazı güvenli bir şekilde hesabınızla eşleştirir, yetkili etkinlikleri senkronize eder ve mobil ağı kontrol paneline ve REST API'ye bağlar.

1Mobil uygulamaTelefonu ve SIM'ini eşler 2Şifreli bağlantıAktarım halindeki verileri doğrular ve korur 3Kontrol Paneli ve APIİş akışlarını ve etkinliği kontrol eder

Resmi Google Play ve Apple App Store listeleri aracılığıyla dağıtılan imzalı sürümler
Google ve Apple platform incelemesi, imzalama ve dağıtım kontrolleri
Güvenli cihaz eşleştirme, HTTPS aktarımı ve kimlik doğrulamalı API erişimi
Yalnızca etkinleştirdiğiniz mobil özellikler için gerekli izinler

Google Play'de resmi SMSMobileAPI uygulamasını alın

Apple App Store'da resmi SMSMobileAPI uygulamasını indirin

Yetenekler, Android

Telegram API belgeleri

İlk isteğiniz dört adımda

Bağlamak

Bir kişi bulun

Göndermek

Takip et

Kimlik bilgilerini sunucunuzda tutun

Parametreler

Örneğin

Örnek yanıt

Parametreler

Örneğin

Örnek yanıt

Parametreler

Örneğin

Örnek yanıt

Parametreler

Örneğin

Örnek yanıt

Parametreler

Örneğin

Örnek yanıt

Parametreler

Örneğin

Örnek yanıt

Hatalar ve güvenli yenidenrries

İstek bağlamını getir - sırlarınız değil.

Telefonunuz, kontrol paneliniz ve API arasındaki güvenli köprü.