Aloita tästä.

Ensimmäinen pyyntösi neljässä vaiheessa

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

Yhdistä oma Telegram-tilisi QR code-koodeilla hallintapaneelissa ja synkronoi sen yhteystiedot.

Kopioi SMSMobileAPI-avain kohdasta My API Key ja pidä se palvelimellasi.

Listaa yhteystiedot ja kopioi vastaanottajan contact_id.

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

YOUR TELEGRAM ACCOUNT

Yhdistä, valitse yhteystieto ja seuraa sitten lähettämistä.

Tilin laajennetut

Jokainen asiakas skannaa QR code yhdistääkseen oman Telegram-tilinsä. Synkronoi yhteystiedot hallintapaneelissa, käytä palautettua contact ID:tä viestin jonottamiseen ja tarkista tilanne lähetetystä lokista.

1

Yhdistä

Skannaa QR code Telegram-hallintapaneelin sivulla.

2

Etsi yhteystieto

Synkronoi, etsi sitten contact ID API:n kautta.

3

Lähetä

POST: lähetä yksi JSON-viesti idempotency_key:n kanssa.

4

Seurata

Lue jonotetut, lähetetyt, tuntemattomat tai virhetilat.

Todennus

Pidä tiedot palvelimellasi

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.

Ennen kuin yhdistät

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-linkittää jokaisen asiakkaan oman Telegram-tilin. Viestit lähetetään tuolta tililtä, eivät jaetulta SMSMobileAPI-tililtä.
202-vastaus tarkoittaa, että pyyntö laitettiin jonoon. Se ei todista, että Telegram hyväksyi tai toimitti viestin. Kysy lähetetyn lokista lähetetyn tai virhetilan perään.
Palvelu lähettää tällä hetkellä yhtä synkronoitua yhteystietoa tai tallennettua @käyttäjänimeä kohden per pyynnön. Noudata Telegram-sääntöjä ja vastaanottajan suostumusta.
Pyynnöt on rajoitettu 15 uuteen viestiin minuutissa ja 30 jonotettuun viestiin per yhdistetty tili. Käytä vakaata idempotency_key:tä uudelleenyrityksissä.
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.

SAADA

Listaa Telegram-yhteystiedot

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

Palauttaa yhteystiedot, jotka ovat käytettävissä yhdistetyssä Telegram-tilissäsi.

Milloin sitä käytetään

Etsi näyttönimellä tai @käyttäjänimellä, käytä sitten contact_id:tä lähettämiseen.

Parametrit

Nimi	Tyyppi	Vaatimus	Kuvaus
`q`	jono	Vapaaehtoinen	Valinnainen nimi- tai käyttäjähakukenttä, enintään 80 merkkiä.
`limit`	kokonaisluku	Vapaaehtoinen	Sivun koko 1–100; oletus 50.
`cursor`	kokonaisluku	Vapaaehtoinen	Käytä edellisen vastauksen paging.next_cursor-arvoa; jätä pois ensimmäisellä sivulla.

Esimerkki pyynnön esittämisestä

kiemura

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

Esimerkkivastaus

JSON

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

Haluatko tehdä tämän pyynnön?Yhdistä API-näppäin sivun yläreunaan avataksesi interaktiivisen testin.

Liitä avain ↑

Hyvä tietää

Contact ID:t kuuluvat yhdistetylle tilille; toisen tilin ID:tä ei voi käyttää.
Päivitä yhteystiedot Dashboard → Telegram Contacts, jos joku uusi ei ilmesty.

LÄHETTÄÄ

Lähetä Telegram-viesti

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

Jonottaa yhden tekstiviestin yhteystiedolle yhdeltä yhdistetyltä Telegram-tililtäsi.

Milloin sitä käytetään

Käytä contacts-päätepisteen contact_id:tä. Tallenna message_id seurantaa varten.

Parametrit

Nimi	Tyyppi	Vaatimus	Kuvaus
`contact_id`	kokonaisluku	Pakollinen	Contact ID palautetaan /telegram/contacts/-kutsusta.
`message`	jono	Pakollinen	UTF-8-teksti, 1–4096 merkkiä ja enintään 16 000 tavua.
`idempotency_key`	UUID-merkkijono	Vapaaehtoinen	Vakaa 36 merkin pituinen pienaakkoinen UUID-tyylinen avain. Uudelleenkäytä verkon uudelleenyrittämisissä välttääksesi kaksoislähetykset.

Esimerkki pyynnön esittämisestä

kiemura

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

Esimerkkivastaus

JSON

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

Haluatko tehdä tämän pyynnön?Yhdistä API-näppäin sivun yläreunaan avataksesi interaktiivisen testin.

Liitä avain ↑

Hyvä tietää

HTTP 202 tarkoittaa jonotettua; se ei ole toimituskuittaus. Täsmälleen sama uudelleenyrittäminen palauttaa HTTP 200 with duplicate=true ja alkuperäisen message_id:n.
Uudelleenyrityksiä varten käytä samaa idempotency_key:tä saman yhteystiedon ja viestin kanssa. Muutettu payload samalla avaimella palauttaa HTTP 409:n.

LÄHETTÄÄ

Send a Telegram image or document

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

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

Milloin sitä käytetään

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

Parametrit

Nimi	Tyyppi	Vaatimus	Kuvaus
`contact_id`	kokonaisluku	Pakollinen	Contact ID palautetaan /telegram/contacts/-kutsusta.
`file`	file	Pakollinen	One JPG, PNG, WebP, PDF, TXT, CSV, JSON, ZIP or Office file, at most 5 MB.
`message`	jono	Vapaaehtoinen	Optional caption of at most 1024 characters.
`idempotency_key`	UUID-merkkijono	Vapaaehtoinen	Reuse the same key and identical file and caption when retrying.

Esimerkki pyynnön esittämisestä

kiemura

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'

Esimerkkivastaus

JSON

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

Haluatko tehdä tämän pyynnön?Yhdistä API-näppäin sivun yläreunaan avataksesi interaktiivisen testin.

Liitä avain ↑

Hyvä tietää

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.

LÄHETTÄÄ

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.

Milloin sitä käytetään

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

Parametrit

Nimi	Tyyppi	Vaatimus	Kuvaus
`contact_id`	kokonaisluku	Pakollinen	Contact ID palautetaan /telegram/contacts/-kutsusta.
`filename`	jono	Pakollinen	Original file name, for example photo.png or invoice.pdf.
`file_base64`	jono	Pakollinen	Raw Base64 file contents or a data URI; decoded file must be 5 MB or smaller.
`message`	jono	Vapaaehtoinen	Optional caption of at most 1024 characters.
`idempotency_key`	UUID-merkkijono	Vapaaehtoinen	Reuse the same key with identical file contents, filename and caption on retries.

Esimerkki pyynnön esittämisestä

kiemura

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

Esimerkkivastaus

JSON

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

Haluatko tehdä tämän pyynnön?Yhdistä API-näppäin sivun yläreunaan avataksesi interaktiivisen testin.

Liitä avain ↑

Hyvä tietää

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.

SAADA

Listaa lähetetyt Telegram-viestit

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

Palauttaa äskettäiset jonossa olevat, lähetyksessä olevat, lähetetyt ja epäonnistuneet viestit, uusimmat ensin.

Milloin sitä käytetään

Kysy tätä päätepistettä message_id:llä seurataaksesi /telegram/send/ -palauttamaa viestiä.

Parametrit

Nimi	Tyyppi	Vaatimus	Kuvaus
`message_id`	kokonaisluku	Vapaaehtoinen	Palauta tietty viestin tunnus (/telegram/send/).
`contact_id`	kokonaisluku	Vapaaehtoinen	Rajoita tulokset yhteen kontaktitunnukseen.
`status`	queued \| sending \| sent \| error \| unknown	Vapaaehtoinen	Suodata lähetyksen tilan mukaan.
`limit`	kokonaisluku	Vapaaehtoinen	Sivun koko 1–100; oletus 50.
`cursor`	kokonaisluku	Vapaaehtoinen	Käytä paging.next_cursor-arvoa hakemaan vanhempia viestejä.

Esimerkki pyynnön esittämisestä

kiemura

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

Esimerkkivastaus

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

Haluatko tehdä tämän pyynnön?Yhdistä API-näppäin sivun yläreunaan avataksesi interaktiivisen testin.

Liitä avain ↑

Hyvä tietää

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 tarkoittaa, että Telegram hyväksyi viestin yhdistetystä tilistä; vastaanottajan toimitus- ja lukukuittauksia ei raportoida.
unknown tarkoittaa, että lähetyksen lopputulosta ei voitu varmentaa. Älä lähetä viestiä automaattisesti uudelleen tässä tilassa.

SAADA

Download a sent Telegram attachment

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

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

Milloin sitä käytetään

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

Parametrit

Nimi	Tyyppi	Vaatimus	Kuvaus
`message_id`	kokonaisluku	Pakollinen	Message ID returned by /telegram/send/.

Esimerkki pyynnön esittämisestä

kiemura

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

Esimerkkivastaus

JSON

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

Haluatko tehdä tämän pyynnön?Yhdistä API-näppäin sivun yläreunaan avataksesi interaktiivisen testin.

Liitä avain ↑

Hyvä tietää

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.

Vianetsintä

Virheet ja turvalliset korjaukset

Lue HTTP- tila ja JSON- virhekenttä ennen kuin yrität uudelleen. Älä yritä uudelleen validointi- tai tunnistusvirheitä korjaamatta ensin pyyntöä.

HTTP	Koodi	Mitä tehdä?
401	`api_key_required / invalid_api_key`	Lähetä kelvollinen X-SMSMobileAPI-Key-otsikko.
402	`subscription_expired`	Renew the SMSMobileAPI subscription linked to the API key. Telegram API access resumes after renewal.
403	`API_ENDPOINT_DISABLED`	Ota käyttöön Telegram API tai tämä tietty päätepiste kohdassa My API Key.
404	`contact_not_found`	Synkronoi yhteystiedot ja käytä omaan Telegram-yhteyteesi kuuluvaa ID:tä.
409	`telegram_not_connected / idempotency_conflict`	Yhdistä Telegram tai valitse uusi idempotenssiavain muutetulle sisällölle.
422	`invalid_message / invalid_pagination`	Korjaa viesti, contact ID tai sivutusparametrit.
429	`queue_full / rate_limited`	Odota, että jonotetut lähetykset tai minuuttikohtainen rajoitus vapautuvat.
503	`sending_unavailable / service_unavailable`	Lähetysgemma tai tallennus ei ole väliaikaisesti käytettävissä; yritä myöhemmin uudelleen.
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.

Yritä uudelleen sääntöKokeile vain ohimeneviä 429 ja 5xx-vasteita. Aloita 1 sekunnin jälkeen ja peräänny 2, 4 ja 8 sekunnin kuluttua.

Tarvitsetko apua?

Tuo pyyntö kontekstia. Ei salaisuuksia.

Jaa päätepiste, aikaleima, HTTP-status ja puhdistava vaste. Älä koskaan sisälly API-näppäimiin, rahakkeisiin tai yksityiseen viestisisältöön.

Ota yhteyttä API-tukeen →

Turvallinen SMSMobileAPI-mobiilisovellus, joka yhdistää puhelimen verkkokojelautaan ja REST API-sovellus SMS- ja puhelutoimintoihin — Salattu mobiili-lautalta-liitäntä

Virallinen mobiilisovellus

Turvallinen silta puhelimen, kojelauta ja API:n välillä.

SMS- ja puhelutoiminnot kulkevat puhelimeen asennetun virallisen SMSMobileAPI-sovelluksen kautta. Sovellus yhdistää laitteen turvallisesti tiliisi, synkronoi hyväksytyt tapahtumat ja linkittää mobiiliverkon kojelautaan ja REST API:iin.

1MobiilisovellusParittele puhelin ja sen SIM 2Salattu linkkiTunnistaa ja suojaa tietoja kauttakulussa 3& APIHallitsee työnkulkua ja toimintaa

Allekirjoitetut tiedotteet, jotka on jaettu virallisten Google Play- ja Apple App Store -listausten kautta
Google ja Apple -alustan katselmointi, allekirjoittaminen ja jakelun valvonta
Turvalaiteparitus, HTTPS-kuljetus ja aito API-yhteys
Vain mobiiliominaisuuksille tarvittavat oikeudet

Hanki virallinen SMSMobileAPI-sovellus Google Playsta

Lataa Apple App Storen virallinen SMSMobileAPI-sovellus

Kyvyt riippuvat Android:n tai iOS:n sallimista käyttöoikeuksista ja tausta-aineistoista.

Telegram API -dokumentaatio

Ensimmäinen pyyntösi neljässä vaiheessa

Yhdistä

Etsi yhteystieto

Lähetä

Seurata

Pidä tiedot palvelimellasi

Parametrit

Esimerkki pyynnön esittämisestä

Esimerkkivastaus

Parametrit

Esimerkki pyynnön esittämisestä

Esimerkkivastaus

Parametrit

Esimerkki pyynnön esittämisestä

Esimerkkivastaus

Parametrit

Esimerkki pyynnön esittämisestä

Esimerkkivastaus

Parametrit

Esimerkki pyynnön esittämisestä

Esimerkkivastaus

Parametrit

Esimerkki pyynnön esittämisestä

Esimerkkivastaus

Virheet ja turvalliset korjaukset

Tuo pyyntö kontekstia. Ei salaisuuksia.

Turvallinen silta puhelimen, kojelauta ja API:n välillä.