Börja här

Din första förfrågan i fyra steg

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

Anslut ditt eget Telegram-konto genom QR code i kontrollpanelen och synkronisera dess kontakter.

Kopiera din SMSMobileAPI-nyckel från My API Key och förvara den på din server.

Lista kontakter och kopiera contact_id för avsedd mottagare.

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

DITT TELEGRAMKONTO

Anslut, välj en kontakt och följ sedan sändningen.

Kontot som omfattas

Varje kund skannar en QR code för att ansluta sitt eget Telegram-konto. Synkronisera kontakter i kontrollpanelen, använd det returnerade kontakt-ID:t för att köa ett meddelande och granska sedan dess status i skickade-loggen.

1

Ansluta

Skanna QR code på sidan för Telegram-instrumentpanelen.

2

Hitta en kontakt

Synkronisera och sök sedan efter kontakt-ID via API.

3

Skicka

POSTa ett JSON-meddelande med en idempotency-nyckel.

4

Spåra

Läs köade, skickade, okända eller felaktiga tillstånd.

Autentisering

Hålla referenser på din server

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.

Innan du integrerar

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 länkar varje kunds eget Telegram-konto. Meddelanden skickas från det kontot, inte från ett delat SMSMobileAPI-konto.
Ett 202-svar betyder att förfrågan köades. Det bevisar inte att Telegram accepterade eller levererade meddelandet. Poll:a loggen för skickade för status skickat eller fel.
Tjänsten skickar för närvarande till en synkroniserad kontakt eller sparad @username per förfrågan. Respektera Telegram-regler och mottagarens samtycke.
Förfrågningar är begränsade till 15 nya meddelanden per minut och 30 köade meddelanden per anslutet konto. Använd en stabil idempotency_key vid omförsök.
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.

FÅ

Lista Telegram-kontakter

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

Returnerar kontakter som finns i ditt anslutna Telegram-konto.

När man ska använda den

Sök efter visningsnamn eller @username, använd sedan contact_id för att skicka.

Parametrar

Namn	Typ	Krav	Beskrivning
`q`	Sträng	Optionell	Valfritt namn- eller användarnamnssök, upp till 80 tecken.
`limit`	Integer	Optionell	Sidstorlek från 1 till 100; standard 50.
`cursor`	Integer	Optionell	Använd paging.next_cursor från föregående svar; utelämna för första sidan.

Begär exempel

ringla

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

Exempel svar

JSON

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

Vill du köra denna begäran?Anslut din API-nyckel högst upp på sidan för att låsa upp den interaktiva testaren.

Anslut nyckel ^

Bra att veta

Kontakt-ID:n tillhör det anslutna kontot; ett ID från ett annat konto kan inte användas.
Uppdatera kontakter från Dashboard → Telegram Contacts när någon ny inte syns.

POSTA

Skicka ett Telegram-meddelande

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

Köar ett textmeddelande för en kontakt från ditt anslutna Telegram-konto.

När man ska använda den

Använd contact_id från contacts-endpointen. Spara message_id för spårning.

Parametrar

Namn	Typ	Krav	Beskrivning
`contact_id`	Integer	Nödvändig	Kontakt-ID som returneras av /telegram/contacts/.
`message`	Sträng	Nödvändig	UTF-8-text, 1–4096 tecken och högst 16 000 byte.
`idempotency_key`	UUID-sträng	Optionell	Stabil 36-tecken lång liten bokstavs-UUID-stil nyckel. Återanvänd vid nätverksomförsök för att undvika dubbletter.

Begär exempel

ringla

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"}'

Exempel svar

JSON

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

Vill du köra denna begäran?Anslut din API-nyckel högst upp på sidan för att låsa upp den interaktiva testaren.

Anslut nyckel ^

Bra att veta

HTTP 202 betyder köad; det är inte en leveransbekräftelse. En exakt omförsök returnerar HTTP 200 med duplicate=true och original message_id.
För omförsök, återanvänd samma idempotency_key med samma kontakt och meddelande. Ett ändrat payload med samma nyckel returnerar HTTP 409.

POSTA

Send a Telegram image or document

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

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

När man ska använda den

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

Parametrar

Namn	Typ	Krav	Beskrivning
`contact_id`	Integer	Nödvändig	Kontakt-ID som returneras av /telegram/contacts/.
`file`	file	Nödvändig	One JPG, PNG, WebP, PDF, TXT, CSV, JSON, ZIP or Office file, at most 5 MB.
`message`	Sträng	Optionell	Optional caption of at most 1024 characters.
`idempotency_key`	UUID-sträng	Optionell	Reuse the same key and identical file and caption when retrying.

Begär exempel

ringla

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'

Exempel svar

JSON

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

Vill du köra denna begäran?Anslut din API-nyckel högst upp på sidan för att låsa upp den interaktiva testaren.

Anslut nyckel ^

Bra att veta

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.

POSTA

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.

När man ska använda den

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

Parametrar

Namn	Typ	Krav	Beskrivning
`contact_id`	Integer	Nödvändig	Kontakt-ID som returneras av /telegram/contacts/.
`filename`	Sträng	Nödvändig	Original file name, for example photo.png or invoice.pdf.
`file_base64`	Sträng	Nödvändig	Raw Base64 file contents or a data URI; decoded file must be 5 MB or smaller.
`message`	Sträng	Optionell	Optional caption of at most 1024 characters.
`idempotency_key`	UUID-sträng	Optionell	Reuse the same key with identical file contents, filename and caption on retries.

Begär exempel

ringla

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"}'

Exempel svar

JSON

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

Vill du köra denna begäran?Anslut din API-nyckel högst upp på sidan för att låsa upp den interaktiva testaren.

Anslut nyckel ^

Bra att veta

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.

FÅ

Lista skickade Telegram-meddelanden

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

Returnerar nyligen köade, skickande, skickade och misslyckade meddelanden, senaste först.

När man ska använda den

Kontrollera denna endpoint med message_id för att följa ett meddelande som returnerades av /telegram/send/.

Parametrar

Namn	Typ	Krav	Beskrivning
`message_id`	Integer	Optionell	Returnera det specifika meddelande-ID:t från /telegram/send/.
`contact_id`	Integer	Optionell	Begränsa resultaten till ett kontakt-ID.
`status`	queued \| sending \| sent \| error \| unknown	Optionell	Filtrera efter sändningsstatus.
`limit`	Integer	Optionell	Sidstorlek från 1 till 100; standard 50.
`cursor`	Integer	Optionell	Använd paging.next_cursor för att hämta äldre meddelanden.

Begär exempel

ringla

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

Exempel svar

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}}

Vill du köra denna begäran?Anslut din API-nyckel högst upp på sidan för att låsa upp den interaktiva testaren.

Anslut nyckel ^

Bra att veta

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 betyder att Telegram accepterade meddelandet från det anslutna kontot; mottagarleverans och läskvitton rapporteras inte.
unknown betyder att sändningsresultatet inte kunde bekräftas. Skicka inte om ett meddelande blint i detta tillstånd.

FÅ

Download a sent Telegram attachment

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

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

När man ska använda den

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

Parametrar

Namn	Typ	Krav	Beskrivning
`message_id`	Integer	Nödvändig	Message ID returned by /telegram/send/.

Begär exempel

ringla

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

Exempel svar

JSON

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

Vill du köra denna begäran?Anslut din API-nyckel högst upp på sidan för att låsa upp den interaktiva testaren.

Anslut nyckel ^

Bra att veta

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.

Felsökning

Fel och säkra retries

Läs HTTP status och JSON felfältet innan du retryerar. Försök inte att fördröja validering eller autentiseringsfel utan att korrigera begäran först.

HTTP	Kodkod	Vad ska man göra
401	`api_key_required / invalid_api_key`	Skicka en giltig X-SMSMobileAPI-Key-header.
402	`subscription_expired`	Renew the SMSMobileAPI subscription linked to the API key. Telegram API access resumes after renewal.
403	`API_ENDPOINT_DISABLED`	Aktivera Telegram API eller denna specifika endpoint i My API Key.
404	`contact_not_found`	Synkronisera kontakter och använd ett ID från din egen Telegram-anslutning.
409	`telegram_not_connected / idempotency_conflict`	Anslut Telegram eller välj en ny idempotensnyckel för ändrat innehåll.
422	`invalid_message / invalid_pagination`	Korrigera meddelandet, kontakt-ID eller sidinställningar.
429	`queue_full / rate_limited`	Vänta på att köade utskick eller minutbegränsningen ska rensas.
503	`sending_unavailable / service_unavailable`	Den sändande arbetaren eller lagringen är tillfälligt otillgänglig; försök igen senare.
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.

Retry ruleRetry endast övergående 429 och 5xx svar. Börja efter 1 sekund, sedan tillbaka till 2, 4 och 8 sekunder.

Behöver du hjälp?

Ta med begäran kontext - inte dina hemligheter.

Dela slutpunkten, timestamp, HTTP status och sanitetssvar. Aldrig inkludera API nycklar, tokens eller privat meddelandeinnehåll.

Kontakta API support

Den säkra SMSMobileAPI mobilappen ansluter en telefon till webben instrumentpanelen och REST API för SMS och samtalsoperationer — Krypterad mobil-till-plattform-anslutning

Officiell mobilapplikation

Den säkra bron mellan din telefon, instrumentpanel och API.

SMS och samtalsoperationer passerar genom den officiella SMSMobileAPI-appen installerad på din anslutna telefon. Appen parar säkert enheten med ditt konto, synkroniserar auktoriserade händelser och länkar mobilnätet till instrumentpanelen och REST API.

1Mobilapp appPar telefonen och dess SIM 2Krypterad länkAutentiserar och skyddar data i transit 3Dashboard och APIKontroller arbetsflöden och aktivitet

Signerade releaser som distribueras via de officiella listorna Google Play och Apple App Store
Google och Apple plattformsgranskning, signering och distributionskontroller
Säkra enhet parning, HTTPS transport och autentiserad API tillgång
Endast de behörigheter som krävs för de mobila funktionerna du aktiverar

Få den officiella SMSMobileAPI-appen på Google Play

Ladda ner den officiella SMSMobileAPI-appen på Apple App Store

Förmågor beror på behörigheter och bakgrundsåtkomst som tillåts av Android eller iOS.

Telegram API-dokumentation

Din första förfrågan i fyra steg

Ansluta

Hitta en kontakt

Skicka

Spåra

Hålla referenser på din server

Parametrar

Begär exempel

Exempel svar

Parametrar

Begär exempel

Exempel svar

Parametrar

Begär exempel

Exempel svar

Parametrar

Begär exempel

Exempel svar

Parametrar

Begär exempel

Exempel svar

Parametrar

Begär exempel

Exempel svar

Fel och säkra retries

Ta med begäran kontext - inte dina hemligheter.

Den säkra bron mellan din telefon, instrumentpanel och API.