Hier beginnen

Ihre erste Anfrage in vier Schritten

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

Verbinden Sie Ihr eigenes Telegram-Konto durch QR code im Dashboard und synchronisieren Sie dessen Kontakte.

Kopieren Sie Ihren SMSMobileAPI-Schlüssel aus My API Key und bewahren Sie ihn auf Ihrem Server auf.

Listen Sie Kontakte und kopieren Sie die contact_id des vorgesehenen Empfängers.

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

IHR TELEGRAM-KONTO

Verbinden, einen Kontakt wählen und dann dem Sendevorgang folgen.

Kontoumfang

Jeder Kunde scannt einen QR code, um sein eigenes Telegram-Konto zu verbinden. Kontakte im Dashboard synchronisieren, die zurückgegebene Kontakt-ID verwenden, um eine Nachricht in die Warteschlange zu stellen, und dann den Status im Sendeprotokoll prüfen.

1

Verbinden

Scannen Sie die QR code auf der Telegram-Dashboard-Seite.

2

Kontakt finden

Synchronisieren Sie, suchen Sie dann die Kontakt-ID über API.

3

Schicken

POSTen Sie eine JSON-Nachricht mit einem Idempotency-Key.

4

Schiene

Gelesene Zustände: queued, sent, unknown oder error.

Authentifizierung

Bewahren Sie Ihre Anmeldeinformationen auf Ihrem Server auf

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.

Bevor Sie integrieren

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.
Die QR code verknüpft das jeweilige Telegram-Konto des Kunden. Nachrichten werden von diesem Konto gesendet, nicht von einem gemeinsamen SMSMobileAPI-Konto.
Eine 202-Antwort bedeutet, die Anfrage wurde in die Warteschlange gestellt. Sie beweist nicht, dass Telegram die Nachricht akzeptiert oder zugestellt hat. Abfrage des Sendeprotokolls auf gesendet oder Fehler.
Der Dienst sendet derzeit pro Anfrage an einen synchronisierten Kontakt oder einen gespeicherten @Benutzernamen. Beachten Sie die Telegram-Regeln und das Einverständnis des Empfängers.
Anfragen sind begrenzt auf 15 neue Nachrichten pro Minute und 30 wartende Nachrichten pro verbundenem Konto. Verwenden Sie bei Wiederholungen einen stabilen 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.

ERHALTEN

List Telegram contacts

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

Gibt Kontakte zurück, die in Ihrem verbundenen Telegram-Konto verfügbar sind.

Wann man es benutzt

Suchen Sie nach Anzeigename oder @Benutzername, verwenden Sie dann contact_id zum Senden.

Parameter

Name	Typ	Anforderungen	Beschreibung
`q`	Zeichenkette	Fakultativ	Optionale Namens- oder Benutzersuche, bis zu 80 Zeichen.
`limit`	Ganzzahl	Fakultativ	Seitengröße von 1 bis 100; Standard 50.
`cursor`	Ganzzahl	Fakultativ	Verwenden Sie paging.next_cursor aus der vorherigen Antwort; weglassen für die erste Seite.

Anfordern Beispiel

CURL

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

Beispielantwort

JSON

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

Möchten Sie diese Anfrage ausführen?Verbinden Sie Ihren API-Schlüssel oben auf der Seite, um den interaktiven Tester zu entsperren.

Schlüssel verbinden ↑

Gut zu wissen

Kontakt-IDs gehören zum verbundenen Konto; eine ID aus einem anderen Konto kann nicht verwendet werden.
Kontakte aktualisieren im Dashboard → Telegram Contacts, wenn jemand Neues nicht erscheint.

STRASSE

Senden Sie eine Telegram-Nachricht

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

Stellt eine Textnachricht für einen Kontakt aus Ihrem verbundenen Telegram-Konto in die Warteschlange.

Wann man es benutzt

Verwenden Sie contact_id vom Kontakte-Endpunkt. Speichern Sie message_id zur Nachverfolgung.

Parameter

Name	Typ	Anforderungen	Beschreibung
`contact_id`	Ganzzahl	Erforderlich	Kontakt-ID, zurückgegeben von /telegram/contacts/.
`message`	Zeichenkette	Erforderlich	UTF-8-Text, 1–4096 Zeichen und maximal 16.000 Bytes.
`idempotency_key`	UUID-String	Fakultativ	Stabiler 36-stelliger, kleingeschriebener UUID-ähnlicher Schlüssel. Bei Netzwerk-Wiederholungen wiederverwenden, um doppelte Nachrichten zu vermeiden.

Anfordern Beispiel

CURL

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

Beispielantwort

JSON

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

Möchten Sie diese Anfrage ausführen?Verbinden Sie Ihren API-Schlüssel oben auf der Seite, um den interaktiven Tester zu entsperren.

Schlüssel verbinden ↑

Gut zu wissen

HTTP 202 bedeutet in Warteschlange; es ist keine Zustellbestätigung. Ein exakter Wiederholungsaufruf liefert HTTP 200 mit duplicate=true und der ursprünglichen message_id.
Bei Wiederholungsversuchen denselben idempotency_key mit demselben Kontakt und derselben Nachricht wiederverwenden. Ein geänderter Payload mit demselben Key liefert HTTP 409.

STRASSE

Send a Telegram image or document

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

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

Wann man es benutzt

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

Parameter

Name	Typ	Anforderungen	Beschreibung
`contact_id`	Ganzzahl	Erforderlich	Kontakt-ID, zurückgegeben von /telegram/contacts/.
`file`	file	Erforderlich	One JPG, PNG, WebP, PDF, TXT, CSV, JSON, ZIP or Office file, at most 5 MB.
`message`	Zeichenkette	Fakultativ	Optional caption of at most 1024 characters.
`idempotency_key`	UUID-String	Fakultativ	Reuse the same key and identical file and caption when retrying.

Anfordern Beispiel

CURL

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'

Beispielantwort

JSON

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

Möchten Sie diese Anfrage ausführen?Verbinden Sie Ihren API-Schlüssel oben auf der Seite, um den interaktiven Tester zu entsperren.

Schlüssel verbinden ↑

Gut zu wissen

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.

STRASSE

Send a Telegram file using JSON

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

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

Wann man es benutzt

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

Parameter

Name	Typ	Anforderungen	Beschreibung
`contact_id`	Ganzzahl	Erforderlich	Kontakt-ID, zurückgegeben von /telegram/contacts/.
`filename`	Zeichenkette	Erforderlich	Original file name, for example photo.png or invoice.pdf.
`file_base64`	Zeichenkette	Erforderlich	Raw Base64 file contents or a data URI; decoded file must be 5 MB or smaller.
`message`	Zeichenkette	Fakultativ	Optional caption of at most 1024 characters.
`idempotency_key`	UUID-String	Fakultativ	Reuse the same key with identical file contents, filename and caption on retries.

Anfordern Beispiel

CURL

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

Beispielantwort

JSON

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

Möchten Sie diese Anfrage ausführen?Verbinden Sie Ihren API-Schlüssel oben auf der Seite, um den interaktiven Tester zu entsperren.

Schlüssel verbinden ↑

Gut zu wissen

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.

ERHALTEN

List sent Telegram messages

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

Gibt kürzlich wartende, sendende, gesendete und fehlgeschlagene Nachrichten zurück, neueste zuerst.

Wann man es benutzt

Abfragen Sie diesen Endpunkt mit message_id, um einer von /telegram/send/ zurückgegebenen Nachricht zu folgen.

Parameter

Name	Typ	Anforderungen	Beschreibung
`message_id`	Ganzzahl	Fakultativ	Geben Sie die spezifische Nachrichten-ID von /telegram/send/ zurück.
`contact_id`	Ganzzahl	Fakultativ	Ergebnisse auf eine Kontakt-ID beschränken.
`status`	queued \| sending \| sent \| error \| unknown	Fakultativ	Nach Sendezustand filtern.
`limit`	Ganzzahl	Fakultativ	Seitengröße von 1 bis 100; Standard 50.
`cursor`	Ganzzahl	Fakultativ	Verwenden Sie paging.next_cursor, um ältere Nachrichten abzurufen.

Anfordern Beispiel

CURL

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

Beispielantwort

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

Möchten Sie diese Anfrage ausführen?Verbinden Sie Ihren API-Schlüssel oben auf der Seite, um den interaktiven Tester zu entsperren.

Schlüssel verbinden ↑

Gut zu wissen

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 bedeutet, dass Telegram die Nachricht vom verbundenen Konto akzeptiert hat; Zustellung an den Empfänger und Lesebestätigungen werden nicht gemeldet.
unknown bedeutet, dass das Versandergebnis nicht bestätigt werden konnte. Senden Sie in diesem Zustand eine Nachricht nicht automatisch erneut.

ERHALTEN

Download a sent Telegram attachment

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

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

Wann man es benutzt

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

Parameter

Name	Typ	Anforderungen	Beschreibung
`message_id`	Ganzzahl	Erforderlich	Message ID returned by /telegram/send/.

Anfordern Beispiel

CURL

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

Beispielantwort

JSON

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

Möchten Sie diese Anfrage ausführen?Verbinden Sie Ihren API-Schlüssel oben auf der Seite, um den interaktiven Tester zu entsperren.

Schlüssel verbinden ↑

Gut zu wissen

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.

Fehlerbehebung

Fehler und sichere Versuche

Lesen Sie den HTTP-Status und das JSON-Fehlerfeld, bevor Sie es erneut versuchen. Versuchen Sie keine Validierungs- oder Authentifizierungsfehler erneut, ohne die Anforderung zuerst zu korrigieren.

HTTP	Code	Was zu tun ist
401	`api_key_required / invalid_api_key`	Senden Sie einen gültigen 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`	Aktivieren Sie den Telegram API oder diesen spezifischen Endpunkt in My API Key.
404	`contact_not_found`	Synchronisieren Sie Kontakte und verwenden Sie eine ID aus Ihrer eigenen Telegram-Verbindung.
409	`telegram_not_connected / idempotency_conflict`	Telegram verbinden oder einen neuen Idempotency-Key für geänderte Inhalte wählen.
422	`invalid_message / invalid_pagination`	Nachricht, Kontakt-ID oder Paging-Parameter korrigieren.
429	`queue_full / rate_limited`	Warten Sie, bis wartende Sendungen oder das Limit pro Minute abgebaut sind.
503	`sending_unavailable / service_unavailable`	Der sendende Worker oder Speicher ist vorübergehend nicht verfügbar; bitte später erneut versuchen.
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.

Retro-RegelReproduzieren Sie nur vorübergehende 429 und 5xx Antworten. Beginnen Sie nach 1 Sekunde, dann wieder auf 2, 4 und 8 Sekunden.

Brauchen Sie Hilfe?

Bringen Sie den Anfragekontext mit - nicht Ihre Geheimnisse.

Teilen Sie den Endpunkt, den Zeitstempel, den HTTP-Status und die desinfizierte Antwort. Fügen Sie niemals API-Schlüssel, Token oder private Nachrichteninhalte hinzu.

Kontakt API Unterstützung

Die sichere mobile App SMSMobileAPI, die ein Telefon mit dem Web-Dashboard und REST API für SMS- und Anrufvorgänge verbindet — Verschlüsselte Mobile-to-Plattform-Verbindung

Offizielle mobile Anwendung

Die sichere Brücke zwischen Ihrem Telefon, Dashboard und API.

SMS- und Anrufvorgänge werden über die offizielle SMSMobileAPI-App abgewickelt, die auf Ihrem angeschlossenen Telefon installiert ist. Die App koppelt das Gerät sicher mit Ihrem Konto, synchronisiert autorisierte Ereignisse und verbindet das Mobilfunknetz mit dem Dashboard und REST API.

1Mobile App AppPairs das Telefon und seine SIM 2Verschlüsselte VerbindungAuthentifizierung und Schutz von Daten im Transit 3Dashboard und APISteuerung von Workflows und Aktivitäten

Signierte Releases, die über die offiziellen Google Play- und Apple App Store-Listen verteilt werden
Google und Apple Plattform Überprüfung, Signierung und Verteilungskontrollen
Sichere Gerätepaarung, HTTPS-Transport und authentifizierter API-Zugang
Nur die Berechtigungen, die für die von Ihnen aktivierten mobilen Funktionen erforderlich sind

Holen Sie sich die offizielle SMSMobileAPI App auf Google Play

Laden Sie die offizielle SMSMobileAPI App im Apple App Store herunter

Die Fähigkeiten hängen von den Berechtigungen und dem Hintergrundzugriff ab, die von Android oder iOS erlaubt werden.

Telegram API Dokumentation

Ihre erste Anfrage in vier Schritten

Verbinden

Kontakt finden

Schicken

Schiene

Bewahren Sie Ihre Anmeldeinformationen auf Ihrem Server auf

Parameter

Anfordern Beispiel

Beispielantwort

Parameter

Anfordern Beispiel

Beispielantwort

Parameter

Anfordern Beispiel

Beispielantwort

Parameter

Anfordern Beispiel

Beispielantwort

Parameter

Anfordern Beispiel

Beispielantwort

Parameter

Anfordern Beispiel

Beispielantwort

Fehler und sichere Versuche

Bringen Sie den Anfragekontext mit - nicht Ihre Geheimnisse.

Die sichere Brücke zwischen Ihrem Telefon, Dashboard und API.