Ξεκίνα από εδώ.

Η πρώτη σας αίτηση σε τέσσερα βήματα

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

Συνδέστε τον δικό σας λογαριασμό Telegram με QR code στον πίνακα ελέγχου και συγχρονίστε τις επαφές του.

Αντιγράψτε το κλειδί SMSMobileAPI από το My API Key και φυλάξτε το στον διακομιστή σας.

Καταγράψτε τις επαφές και αντιγράψτε το 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.

Ο ΛΟΓΑΡΙΑΣΜΟΣ TELEGRAM ΣΑΣ

Συνδεθείτε, επιλέξτε μια επαφή και στη συνέχεια παρακολουθήστε την αποστολή.

Περιεχόμενα λογαριασμού

Κάθε πελάτης σαρώνει μια QR code για να συνδέσει τον δικό του λογαριασμό Telegram. Συγχρονίστε επαφές στον πίνακα ελέγχου, χρησιμοποιήστε το επιστρεφόμενο ID επαφής για να τοποθετήσετε ένα μήνυμα σε ουρά και έπειτα ελέγξτε την κατάστασή του στο αρχείο αποστολών.

1

Συνδέω

Σκανάρετε το QR code στη σελίδα πίνακα ελέγχου Telegram.

2

Βρείτε μια επαφή

Συγχρονίστε, στη συνέχεια αναζητήστε το contact ID μέσω API.

3

Στέλνω

Κάντε POST ένα μήνυμα JSON με idempotency key.

4

Τροχιά

Αναγνώστε καταστάσεις queued, sent, unknown ή error.

Πιστοποίηση

Κρατήστε τα διαπιστευτήρια στον εξυπηρετητή σας

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.

Πριν την ενσωμάτωση

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 συνδέει τον κάθε πελάτη με τον δικό του λογαριασμό Telegram. Τα μηνύματα αποστέλλονται από εκείνο τον λογαριασμό, όχι από κοινό λογαριασμό SMSMobileAPI.
Μια απάντηση 202 σημαίνει ότι το αίτημα τοποθετήθηκε σε ουρά. Δεν αποδεικνύει ότι η Telegram αποδέχτηκε ή παρέδωσε το μήνυμα. Ελέγξτε το αρχείο αποστολών για αποσταλμένα ή σφάλματα.
Η υπηρεσία αυτή τη στιγμή στέλνει σε μία συγχρονισμένη επαφή ή αποθηκευμένο @username ανά αίτημα. Σεβαστείτε τους κανόνες Telegram και τη συναίνεση του παραλήπτη.
Τα αιτήματα περιορίζονται σε 15 νέα μηνύματα ανά λεπτό και 30 μηνύματα σε ουρά ανά συνδεδεμένο λογαριασμό. Χρησιμοποιήστε ένα σταθερό idempotency_key κατά την επαναπροσπάθεια.
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.

ΠΑΙΡΝΩ

Λίστα επαφών Telegram

ΤΕΛΟΣhttps://api.smsmobileapi.com/telegram/contacts/

Επιστρέφει επαφές διαθέσιμες στον συνδεδεμένο λογαριασμό σας Telegram.

Πότε να το χρησιμοποιήσετε

Αναζητήστε με εμφανιζόμενο όνομα ή @username, στη συνέχεια χρησιμοποιήστε το contact_id για αποστολή.

Παράμετροι

Όνομα	Τύπος	Απαίτηση	Περιγραφή
`q`	σειρά	Προαιρετικό	Προαιρετική αναζήτηση κατά όνομα ή username, μέχρι 80 χαρακτήρες.
`limit`	ακέραιος	Προαιρετικό	Μέγεθος σελίδας από 1 έως 100· προεπιλογή 50.
`cursor`	ακέραιος	Προαιρετικό	Χρησιμοποιήστε paging.next_cursor από την προηγούμενη απόκριση· παραλείψτε για την πρώτη σελίδα.

Παράδειγμα αίτησης

μπούκλα

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

Παράδειγμα απάντησης

JSON

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

Θέλεις να κάνεις αυτό το αίτημα;Συνδέστε το πλήκτρο API στο πάνω μέρος της σελίδας για να ξεκλειδώσετε το διαδραστικό δοκιμαστή.

Σύνδεση κλειδιού ↑

Χαίρομαι που το μαθαίνω.

Τα IDs επαφών ανήκουν στον συνδεδεμένο λογαριασμό· δεν μπορεί να χρησιμοποιηθεί ID από άλλο λογαριασμό.
Ανανέωση επαφών από Dashboard → Telegram Contacts όταν κάποιος νέος δεν εμφανίζεται.

ΘΕΣΗ

Στείλτε ένα Telegram μήνυμα

ΤΕΛΟΣhttps://api.smsmobileapi.com/telegram/send/

Τοποθετεί σε ουρά ένα κείμενο μήνυμα για μια επαφή από τον συνδεδεμένο σας λογαριασμό Telegram.

Πότε να το χρησιμοποιήσετε

Χρησιμοποιήστε το contact_id από το endpoint επαφών. Αποθηκεύστε το message_id για παρακολούθηση.

Παράμετροι

Όνομα	Τύπος	Απαίτηση	Περιγραφή
`contact_id`	ακέραιος	Υποχρεούμαι	Το ID επαφής επιστρέφεται από /telegram/contacts/.
`message`	σειρά	Υποχρεούμαι	Κείμενο UTF-8, 1–4096 χαρακτήρες και το πολύ 16.000 bytes.
`idempotency_key`	Συμβολοσειρά UUID	Προαιρετικό	Σταθερό 36-χαρακτήρων, πεζό, κλειδί τύπου UUID. Επαναχρησιμοποιήστε το σε επαναλήψεις δικτύου για να αποφύγετε διπλές αποστολές.

Παράδειγμα αίτησης

μπούκλα

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

Παράδειγμα απάντησης

JSON

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

Σύνδεση κλειδιού ↑

Χαίρομαι που το μαθαίνω.

HTTP 202 σημαίνει σε ουρά· δεν είναι απόδειξη παράδοσης. Επανεκτέλεση με τα ίδια δεδομένα επιστρέφει HTTP 200 με duplicate=true και το αρχικό message_id.
Για επαναπροσπάθειες, χρησιμοποιήστε ξανά το ίδιο idempotency_key με την ίδια επαφή και μήνυμα. Ένα μεταβαλλόμενο payload με το ίδιο κλειδί επιστρέφει HTTP 409.

ΘΕΣΗ

Send a Telegram image or document

ΤΕΛΟΣhttps://api.smsmobileapi.com/telegram/send/

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

Πότε να το χρησιμοποιήσετε

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

Παράμετροι

Όνομα	Τύπος	Απαίτηση	Περιγραφή
`contact_id`	ακέραιος	Υποχρεούμαι	Το ID επαφής επιστρέφεται από /telegram/contacts/.
`file`	file	Υποχρεούμαι	One JPG, PNG, WebP, PDF, TXT, CSV, JSON, ZIP or Office file, at most 5 MB.
`message`	σειρά	Προαιρετικό	Optional caption of at most 1024 characters.
`idempotency_key`	Συμβολοσειρά UUID	Προαιρετικό	Reuse the same key and identical file and caption when retrying.

Παράδειγμα αίτησης

μπούκλα

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'

Παράδειγμα απάντησης

JSON

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

Σύνδεση κλειδιού ↑

Χαίρομαι που το μαθαίνω.

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.

ΘΕΣΗ

Send a Telegram file using JSON

ΤΕΛΟΣhttps://api.smsmobileapi.com/telegram/send/

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

Πότε να το χρησιμοποιήσετε

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

Παράμετροι

Όνομα	Τύπος	Απαίτηση	Περιγραφή
`contact_id`	ακέραιος	Υποχρεούμαι	Το ID επαφής επιστρέφεται από /telegram/contacts/.
`filename`	σειρά	Υποχρεούμαι	Original file name, for example photo.png or invoice.pdf.
`file_base64`	σειρά	Υποχρεούμαι	Raw Base64 file contents or a data URI; decoded file must be 5 MB or smaller.
`message`	σειρά	Προαιρετικό	Optional caption of at most 1024 characters.
`idempotency_key`	Συμβολοσειρά UUID	Προαιρετικό	Reuse the same key with identical file contents, filename and caption on retries.

Παράδειγμα αίτησης

μπούκλα

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

Παράδειγμα απάντησης

JSON

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

Σύνδεση κλειδιού ↑

Χαίρομαι που το μαθαίνω.

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.

ΠΑΙΡΝΩ

Λίστα αποσταλμένων μηνυμάτων Telegram

ΤΕΛΟΣhttps://api.smsmobileapi.com/telegram/sent/

Επιστρέφει πρόσφατα σε ουρά, σε αποστολή, αποσταλμένα και αποτυχημένα μηνύματα, πρώτα τα νεότερα.

Πότε να το χρησιμοποιήσετε

Κάντε polling σε αυτό το endpoint με το message_id για να παρακολουθήσετε ένα μήνυμα που επιστρέφεται από το /telegram/send/.

Παράμετροι

Όνομα	Τύπος	Απαίτηση	Περιγραφή
`message_id`	ακέραιος	Προαιρετικό	Επιστρέψτε το συγκεκριμένο αναγνωριστικό μηνύματος από το /telegram/send/.
`contact_id`	ακέραιος	Προαιρετικό	Περιορίστε τα αποτελέσματα σε ένα αναγνωριστικό επαφής.
`status`	queued \| sending \| sent \| error \| unknown	Προαιρετικό	Φιλτράρισμα κατά κατάσταση αποστολής.
`limit`	ακέραιος	Προαιρετικό	Μέγεθος σελίδας από 1 έως 100· προεπιλογή 50.
`cursor`	ακέραιος	Προαιρετικό	Χρησιμοποιήστε paging.next_cursor για να ανακτήσετε παλαιότερα μηνύματα.

Παράδειγμα αίτησης

μπούκλα

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

Παράδειγμα απάντησης

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

Σύνδεση κλειδιού ↑

Χαίρομαι που το μαθαίνω.

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 αποδέχθηκε το μήνυμα από τον συνδεδεμένο λογαριασμό· η παράδοση στον παραλήπτη και οι αποδείξεις ανάγνωσης δεν αναφέρονται.
unknown σημαίνει ότι το αποτέλεσμα αποστολής δεν μπόρεσε να επιβεβαιωθεί. Μην επαναστέλνετε τυφλά ένα μήνυμα σε αυτή την κατάσταση.

ΠΑΙΡΝΩ

Download a sent Telegram attachment

ΤΕΛΟΣhttps://api.smsmobileapi.com/telegram/media/

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

Πότε να το χρησιμοποιήσετε

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

Παράμετροι

Όνομα	Τύπος	Απαίτηση	Περιγραφή
`message_id`	ακέραιος	Υποχρεούμαι	Message ID returned by /telegram/send/.

Παράδειγμα αίτησης

μπούκλα

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

Παράδειγμα απάντησης

JSON

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

Σύνδεση κλειδιού ↑

Χαίρομαι που το μαθαίνω.

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.

Αντιμετώπιση προβλημάτων

Σφάλματα και ασφαλείς επαναλήψεις

Διαβάστε την κατάσταση HTTP και το πεδίο σφάλματος JSON πριν από την επανάληψη. Μην ξαναδοκιμάσετε τις αποτυχίες επικύρωσης ή ταυτοποίησης χωρίς να διορθώσετε πρώτα το αίτημα.

HTTP	Κωδικός	Τι να κάνετε
401	`api_key_required / invalid_api_key`	Στείλτε μια έγκυρη κεφαλίδα X-SMSMobileAPI-Key.
402	`subscription_expired`	Renew the SMSMobileAPI subscription linked to the API key. Telegram API access resumes after renewal.
403	`API_ENDPOINT_DISABLED`	Ενεργοποιήστε το Telegram API ή αυτό το συγκεκριμένο endpoint στο My API Key.
404	`contact_not_found`	Συγχρονίστε επαφές και χρησιμοποιήστε ένα ID από τη δική σας σύνδεση Telegram.
409	`telegram_not_connected / idempotency_conflict`	Συνδεθείτε στη Telegram ή επιλέξτε νέο κλειδί ιδιομορφίας (idempotency) για αλλαγμένο περιεχόμενο.
422	`invalid_message / invalid_pagination`	Διορθώστε το μήνυμα, το ID επαφής ή τις παραμέτρους σελιδοποίησης.
429	`queue_full / rate_limited`	Περιμένετε να καθαρίσουν οι εκκρεμείς αποστολές ή το όριο ανά λεπτό.
503	`sending_unavailable / service_unavailable`	Ο εργαζόμενος αποστολής ή η αποθήκευση είναι προσωρινά μη διαθέσιμα· δοκιμάστε ξανά αργότερα.
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.

Επανάληψη κανόναΕπαναλάβετε μόνο παροδικές αντιδράσεις 429 και 5xx. Ξεκινάς μετά από 1 δευτερόλεπτο, μετά επιστρέφεις στα 2, 4 και 8 δευτερόλεπτα.

Χρειάζεστε βοήθεια;

Φέρτε το πλαίσιο της αίτησης— όχι τα μυστικά σας.

Μοιραστείτε το τελικό σημείο, timestamp, HTTP κατάσταση και αποστειρωμένη απάντηση. Ποτέ μην συμπεριλάβετε τα πλήκτρα API, τα σημεία ή το περιεχόμενο ιδιωτικών μηνυμάτων.

Επαφή API υποστήριξης →

Η ασφαλής εφαρμογή SMSMobileAPI για κινητά που συνδέουν ένα τηλέφωνο με το ταμπλό ιστού και REST API για SMS και λειτουργίες κλήσεων — Κρυπτογραφημένη σύνδεση κινητού- σε-πλατφόρμα

Επίσημη εφαρμογή για κινητά

Η ασφαλής γέφυρα μεταξύ του τηλεφώνου σας, ταμπλό και API.

Οι λειτουργίες SMS και κλήσεων περνούν από την επίσημη εφαρμογή SMSMobileAPI που είναι εγκατεστημένη στο συνδεδεμένο τηλέφωνό σας. Η εφαρμογή συνδυάζει με ασφάλεια τη συσκευή με το λογαριασμό σας, συγχρονίζει εξουσιοδοτημένα γεγονότα και συνδέει το δίκτυο κινητής τηλεφωνίας με το ταμπλό και REST API.

1Εφαρμογή για κινητάΖεύγη του τηλεφώνου και της SIM του 2Κρυπτογραφημένος δεσμόςΤαυτοποιεί και προστατεύει τα δεδομένα κατά τη διαμετακόμιση 3Πίνακας & APIΈλεγχος των ροών εργασίας και της δραστηριότητας

Υπογεγραμμένες εκδόσεις που διανέμονται μέσω των επίσημων καταχωρήσεων Google Play και Apple App Store
Ανασκόπηση, υπογραφή και έλεγχος της πλατφόρμας Google και Apple
Ασφαλής ζεύξη συσκευών, μεταφορά HTTPS και αυθεντική πρόσβαση API
Μόνο οι άδειες που απαιτούνται για τα χαρακτηριστικά του κινητού που ενεργοποιείτε

Αποκτήστε την επίσημη εφαρμογή SMSMobileAPI στο Google Play

Κατεβάστε την επίσημη εφαρμογή SMSMobileAPI στο Apple App Store

Οι δυνατότητες εξαρτώνται από τις άδειες και την πρόσβαση στο φόντο που επιτρέπονται από Android ή iOS.

Τεκμηρίωση Telegram API

Η πρώτη σας αίτηση σε τέσσερα βήματα

Συνδέω

Βρείτε μια επαφή

Στέλνω

Τροχιά

Κρατήστε τα διαπιστευτήρια στον εξυπηρετητή σας

Παράμετροι

Παράδειγμα αίτησης

Παράδειγμα απάντησης

Παράμετροι

Παράδειγμα αίτησης

Παράδειγμα απάντησης

Παράμετροι

Παράδειγμα αίτησης

Παράδειγμα απάντησης

Παράμετροι

Παράδειγμα αίτησης

Παράδειγμα απάντησης

Παράμετροι

Παράδειγμα αίτησης

Παράδειγμα απάντησης

Παράμετροι

Παράδειγμα αίτησης

Παράδειγμα απάντησης

Σφάλματα και ασφαλείς επαναλήψεις

Φέρτε το πλαίσιο της αίτησης— όχι τα μυστικά σας.

Η ασφαλής γέφυρα μεταξύ του τηλεφώνου σας, ταμπλό και API.