Start her

Din første anmodning i fire trin

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

Forbind din egen Telegram-konto ved QR code i dashboardet og synkroniser dens kontakter.

Kopiér din SMSMobileAPI-nøgle fra My API Key og opbevar den på din server.

List contacts and copy the contact_id of the intended recipient.

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

DIN TELEGRAM-KONTO

Forbind, vælg en kontakt, og følg derefter afsendelsen.

Kontoskopisk

Hver kunde scanner en QR code for at forbinde deres egen Telegram-konto. Synkroniser kontakter i dashboardet, brug det returnerede kontakt-ID til at sætte en besked i kø, og inspicer derefter dens status i sent-loggen.

1

Forbinde

Scan QR code på Telegram-dashboard-siden.

2

Find en kontakt

Synkroniser, og søg derefter efter contact ID via API.

3

Sende

POST one JSON message with an idempotency key.

4

Spore

Læs køede, sendte, ukendte eller fejl-tilstande.

Autentificering

Behold legitimation 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.

Før du integrerer

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 linker hver kundes egen Telegram-konto. Beskeder sendes fra den konto, ikke fra en delt SMSMobileAPI-konto.
Et 202-svar betyder, at anmodningen blev kørt i kø. Det beviser ikke, at Telegram accepterede eller leverede beskeden. Poll sent-loggen for sendt eller fejl.
Tjenesten sender i øjeblikket til en synkroniseret kontakt eller gemt @brugernavn per request. Overhold Telegram-regler og modtagerens samtykke.
Anmodninger er begrænset til 15 nye beskeder per minut og 30 køede beskeder per tilknyttet konto. Brug en stabil idempotency_key ved genforsøg.
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Å

List Telegram contacts

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

Returnerer kontakter tilgængelige i din tilkoblede Telegram-konto.

Hvornår skal du bruge det

Søg efter visningsnavn eller @brugernavn, brug derefter contact_id til at sende.

Parametre

Navn	Type	Krav	Beskrivelse
`q`	snor	Valgfrit	Valgfrit navn- eller brugernavnesøgning, op til 80 tegn.
`limit`	heltal	Valgfrit	Sidestrørrelse fra 1 til 100; standard 50.
`cursor`	heltal	Valgfrit	Brug paging.next_cursor fra det forrige svar; udelad for første side.

Eksempel på anmodning

krølle

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

Eksempel på svar

JSON

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

Vil du køre denne anmodning?Tilslut din API nøgle øverst på siden for at låse den interaktive tester op.

Forbind nøgle ↑

Godt at vide

Kontakt-ID'er tilhører den tilknyttede konto; et ID fra en anden konto kan ikke bruges.
Opdater kontakter fra Dashboard → Telegram Contacts når en ny person ikke dukker op.

STOLPE

Send en Telegram-besked

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

Sætter en tekstbesked i kø for en kontakt fra din tilknyttede Telegram-konto.

Hvornår skal du bruge det

Brug contact_id fra contacts-endpointet. Gem message_id til sporing.

Parametre

Navn	Type	Krav	Beskrivelse
`contact_id`	heltal	Påkrævet	Kontakt-ID returneret af /telegram/contacts/.
`message`	snor	Påkrævet	UTF-8-tekst, 1–4096 tegn og højst 16.000 bytes.
`idempotency_key`	UUID-streng	Valgfrit	Stabil 36-tegns lillebogstavet UUID-stil nøgle. Genbrug ved netværksforsøg for at undgå duplikerede beskeder.

Eksempel på anmodning

krølle

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

Eksempel på svar

JSON

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

Vil du køre denne anmodning?Tilslut din API nøgle øverst på siden for at låse den interaktive tester op.

Forbind nøgle ↑

Godt at vide

HTTP 202 betyder køet; det er ikke en leveringskvittering. Et identisk retry returnerer HTTP 200 med duplicate=true og den oprindelige message_id.
Til genforsøg genbrug samme idempotency_key med samme kontakt og besked. En ændret payload med samme nøgle returnerer HTTP 409.

STOLPE

Send a Telegram image or document

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

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

Hvornår skal du bruge det

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

Parametre

Navn	Type	Krav	Beskrivelse
`contact_id`	heltal	Påkrævet	Kontakt-ID returneret af /telegram/contacts/.
`file`	file	Påkrævet	One JPG, PNG, WebP, PDF, TXT, CSV, JSON, ZIP or Office file, at most 5 MB.
`message`	snor	Valgfrit	Optional caption of at most 1024 characters.
`idempotency_key`	UUID-streng	Valgfrit	Reuse the same key and identical file and caption when retrying.

Eksempel på anmodning

krølle

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'

Eksempel på svar

JSON

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

Vil du køre denne anmodning?Tilslut din API nøgle øverst på siden for at låse den interaktive tester op.

Forbind nøgle ↑

Godt at vide

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.

STOLPE

Send a Telegram file using JSON

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

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

Hvornår skal du bruge det

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

Parametre

Navn	Type	Krav	Beskrivelse
`contact_id`	heltal	Påkrævet	Kontakt-ID returneret af /telegram/contacts/.
`filename`	snor	Påkrævet	Original file name, for example photo.png or invoice.pdf.
`file_base64`	snor	Påkrævet	Raw Base64 file contents or a data URI; decoded file must be 5 MB or smaller.
`message`	snor	Valgfrit	Optional caption of at most 1024 characters.
`idempotency_key`	UUID-streng	Valgfrit	Reuse the same key with identical file contents, filename and caption on retries.

Eksempel på anmodning

krølle

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

Eksempel på svar

JSON

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

Vil du køre denne anmodning?Tilslut din API nøgle øverst på siden for at låse den interaktive tester op.

Forbind nøgle ↑

Godt at vide

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Å

List sent Telegram messages

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

Returnerer nyligt kørende, afsendte, sendte og mislykkede beskeder, nyeste først.

Hvornår skal du bruge det

Poll dette endpoint med message_id for at følge en besked returneret af /telegram/send/.

Parametre

Navn	Type	Krav	Beskrivelse
`message_id`	heltal	Valgfrit	Returner det specifikke message ID fra /telegram/send/.
`contact_id`	heltal	Valgfrit	Begræns resultater til ét kontakt-id.
`status`	queued \| sending \| sent \| error \| unknown	Valgfrit	Filtrer efter afsendelsesstatus.
`limit`	heltal	Valgfrit	Sidestrørrelse fra 1 til 100; standard 50.
`cursor`	heltal	Valgfrit	Brug paging.next_cursor til at hente ældre beskeder.

Eksempel på anmodning

krølle

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

Eksempel på 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}}

Vil du køre denne anmodning?Tilslut din API nøgle øverst på siden for at låse den interaktive tester op.

Forbind nøgle ↑

Godt at vide

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, at Telegram accepterede beskeden fra den tilkoblede konto; modtagers levering og læsekvitteringer rapporteres ikke.
unknown betyder, at afsendelsesresultatet ikke kunne bekræftes. Genafsend ikke blindt en besked i denne tilstand.

FÅ

Download a sent Telegram attachment

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

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

Hvornår skal du bruge det

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

Parametre

Navn	Type	Krav	Beskrivelse
`message_id`	heltal	Påkrævet	Message ID returned by /telegram/send/.

Eksempel på anmodning

krølle

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

Eksempel på svar

JSON

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

Vil du køre denne anmodning?Tilslut din API nøgle øverst på siden for at låse den interaktive tester op.

Forbind nøgle ↑

Godt at vide

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.

Fejlfinding

Fejl og sikre forsøg på at vende tilbage

Læs HTTP status og JSON fejlfeltet før genforsøg. Fortryd ikke validerings- eller autentificeringsfejl uden først at korrigere anmodningen.

HTTP	Kode	Hvad skal man gøre?
401	`api_key_required / invalid_api_key`	Send en gyldig 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`	Aktivér Telegram API eller dette specifikke endpoint i My API Key.
404	`contact_not_found`	Synkroniser kontakter og brug et ID fra din egen Telegram-forbindelse.
409	`telegram_not_connected / idempotency_conflict`	Forbind Telegram eller vælg en ny idempotency key for ændret indhold.
422	`invalid_message / invalid_pagination`	Ret beskeden, kontakt-ID eller sideinddelingsparametre.
429	`queue_full / rate_limited`	Vent på at kørte afsendelser eller minutgrænsen rydder.
503	`sending_unavailable / service_unavailable`	Den afsendende worker eller lagring er midlertidig utilgængelig; prøv igen senere.
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.

Foretag at genfinde regelPrøv kun forbigående 429 - og 5xx - respons igen. Start efter 1 sekund, og træk så tilbage til 2, 4 og 8 sekunder.

Brug for hjælp?

Medbring forespørgslen kontekst - ikke dine hemmeligheder.

Del endepunkt, tidsstempel, HTTP status og renset respons. Aldrig inkludere API nøgler, tokens eller privat besked indhold.

Kontakt API support →

Den sikre SMSMobileAPI mobil app, der forbinder en telefon til web dashboard og REST API til SMS og opkald operationer — Krypteret mobil- to- platform- forbindelse

Officiel mobilapplikation

Den sikre bro mellem telefonen, instrumentbrættet og API.

SMS og opkald operationer passere gennem den officielle SMSMobileAPI app installeret på din tilsluttede telefon. App sikkert parrer enheden med din konto, synkroniserer godkendte begivenheder og forbinder mobilnetværket til instrumentbrættet og REST API.

1Mobil appParerer telefonen og dens SIM 2Krypteret linkAutentificerer og beskytter data i transit 3Dashboard & # API #Styrer arbejdsgange og aktivitet

Signerede udgivelser distribueret gennem de officielle Google Play og Apple App Store lister
Google og Apple platform gennemgang, signaturer og distribution kontrol
Sikker parring af enheden, HTTPS transport og autentificeret API adgang
Kun de tilladelser, der kræves for de mobile funktioner, du aktiverer

Få den officielle SMSMobileAPI app på Google Play

Download den officielle SMSMobileAPI app på Apple App Store

Kapacitet afhænger af tilladelser og baggrundsadgang tilladt af Android eller iOS.

Telegram API-dokumentation

Din første anmodning i fire trin

Forbinde

Find en kontakt

Sende

Spore

Behold legitimation på din server

Parametre

Eksempel på anmodning

Eksempel på svar

Parametre

Eksempel på anmodning

Eksempel på svar

Parametre

Eksempel på anmodning

Eksempel på svar

Parametre

Eksempel på anmodning

Eksempel på svar

Parametre

Eksempel på anmodning

Eksempel på svar

Parametre

Eksempel på anmodning

Eksempel på svar

Fejl og sikre forsøg på at vende tilbage

Medbring forespørgslen kontekst - ikke dine hemmeligheder.

Den sikre bro mellem telefonen, instrumentbrættet og API.