> ## Documentation Index > Fetch the complete documentation index at: https://docs.orbit.devotel.io/llms.txt > Use this file to discover all available pages before exploring further. # SMS – weltweit senden und empfangen > SMS auf Orbit produktionsreif einrichten: Absender anbinden, wo nötig registrieren, Kodierung und Segmentkosten vorhersagen, Zustellstatus lesen und mit Absenderpools skalieren. # SMS Senden Sie SMS weltweit über Orbits SMPP-Gateway-Infrastruktur. Orbit bindet Tier-1-Carrier und Aggregatoren in über 190 Ländern an und behandelt Verkettung, Kodierung und Zustellverfolgung automatisch. ## Eine SMS senden ```bash theme={null} curl -X POST https://api.orbit.devotel.io/api/v1/messages/sms \ -H "X-API-Key: dv_live_sk_..." \ -H "Content-Type: application/json" \ -d '{ "to": "+14155552671", "from": "+18005551234", "body": "Hallo von Orbit!" }' ``` Sowohl `to` als auch `from` werden als [E.164](https://de.wikipedia.org/wiki/E.164) validiert – vollständiges internationales Format mit Ländervorwahl. Wie Orbit Nummern validiert und normalisiert, beschreibt der [Rufnummern-Lebenszyklus](/concepts/number-lifecycle). ### Antwort Der Endpunkt antwortet mit **HTTP 202 Accepted** – die Nachricht ist persistiert und zur Zustellung eingereiht. Die `id` ist eine Plattform- Nachrichten-ID der Form `msg_` gefolgt von 32 Hex-Zeichen; verfolgen Sie ihren Lebenszyklus über [Zustell-Webhooks](/webhooks/overview). ```json theme={null} { "data": { "id": "msg_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6", "status": "queued", "channel": "sms", "segments": 1, "encoding": "GSM-7" } } ``` Lesen Sie `segments` und `encoding` bei jedem Versand – das berechnet die Abrechnung. ## Zustellbarkeit-Grundlagen SMS-Zustellbarkeit hängt in dieser Reihenfolge von drei Dingen ab: **von wem Sie senden**, **wohin** und **wie schnell**. Ein nicht registrierter Absender wird vom Carrier herausgefiltert, bevor ein Segment etwas kostet. ### Absendertyp wählen | Absendertyp | Am besten für | Einschränkung | | ------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | | **Alphanumerische Absender-ID** (`MyBrand`) | Markenerkennung; Märkte, in denen numerische IDs unterdrückt werden | Registrierung in vielen Ländern erforderlich; keine Antworten (nur sendend) | | **Numerischer Long-Code** (`+14155550123`) | Zwei-Wege-SMS, Antworten, Konversations-Support | Durchsatz länderspezifisch (US: über [10DLC](#10dlc-registrierung--kampagnentypen-us) für vollen Durchsatz registrieren) | | **Short-Code** (`12345`) | Hochdurchsatz-Kampagnen, einprägsame OTP-Sendungen | Lange Carrier-Vorlaufzeit, höhere Kosten | | **Absenderpool** | Hohes Volumen, lokale Präsenz, Rotation degradierter Absender | Siehe [Absenderpools](/guides/sender-pools) | Welche Registrierung Ihr Zielland verlangt, listen die [Länderspezifischen Compliance-Anforderungen](/compliance/country-requirements). ## 10DLC-Registrierung & Kampagnentypen (US) Für US-Ziele über numerische Long-Codes verlangen die Carrier eine Registrierung; nicht registrierter Verkehr wird gefiltert, mit Zuschlägen belegt oder beides. Orbit reicht die Registrierung über The Campaign Registry für Sie ein – der vollständige Ablauf (Marke → Kampagne → Freigabe → Durchsatzstufen) steht im [10DLC-Registrierungs-Leitfaden](/guides/10dlc-registration). Der maßgebliche Punkt für die USA: der Durchsatz nach Registrierung wird als **Segment-Obergrenze pro Tag und Nummer** anhand Ihres Marken-Vetting-Scores vergeben – nicht als Rate pro Sekunde. Für Nicht-US-Ziele, die alphanumerische Absender-IDs gate-keeping (große Teile Europas, Brasilien, Bangladesch, Teile von APAC), ist der parallele Ablauf die [Absender-ID-Registrierung](/compliance/sender-id-registration). Indien ist die Ausnahme: dort laufen Absender-IDs („Headers") über DLT/TRAI – siehe [DLT-Indien-Onboarding](/compliance/dlt-india). ## Kodierung & Verkettung Die Kodierung ist die einzige Kostenvariable, die einen sauber registrierten Absender überlebt. SMS wird pro Segment abgerechnet, und die Segmentzahl hängt vollständig davon ab, in welches Alphabet der Text passt. ### GSM-7 vs. UCS-2 * **GSM-7** – das 7-Bit-GSM-Alphabet (ASCII plus einige Extras: `@`, `£`, `€`, einige griechische Zeichen). Ein passender Text erhält bis zu **160 Zeichen pro Segment**, bzw. **153 Zeichen** bei Mehrteilsendungen (7 Zeichen pro Segment gehen in den UDH-Verkettungsheader). * **UCS-2** – jedes Zeichen außerhalb von GSM-7 (Emoji, CJK, typografische Anführungszeichen, die meisten nicht-lateinischen Schriften) schaltet die gesamte Nachricht auf 16-Bit-Kodierung. Bis zu **70 Zeichen pro Segment**, **67** bei Mehrteil. Ein einzelnes Nicht-GSM-7-Zeichen stuft die gesamte Nachricht um. Orbit normalisiert die häufigen Auslöser – kopiert typografische Anführungszeichen, Gedankenstriche, geschwungene Apostrophe, unsichtbare Zero-Width-Zeichen – vor dem Zählen zu GSM-7-kompatiblen Entsprechungen, so dass Kopierfehler Ihre Segmentrechnung nicht verdoppeln. Das vollständige Kodierungs- und Segmentierungsmodell liegt im [SMS-Segmente- und -Kodierungskonzept](/concepts/sms-segments-and-encoding). ### Konkretes Beispiel `Ihre Bestellung wurde versendet — antworten Sie JA` – 30 Zeichen, alles GSM-7 → **1 Segment, `GSM-7`**. Ein einziges angehängtes Emoji kippt das Alphabet; ein 160-Zeichen-ASCII-Newsletter wird sofort zu **2 UCS-2-Segmenten**. Obergrenze: **10 Segmente** (1.530 GSM-7- oder 670 UCS-2-Zeichen); darüber wird gekürzt und `wasTruncated: true` gesetzt. ## Status-Lebenszyklus Jede ausgehende SMS trägt einen `status`, der sich weiterbewegt: `queued` → `sending` → `sent` → `delivered` (oder `failed` / `undelivered` / `rejected` / `expired`) Abonnieren Sie die Übergänge per [Webhooks](/webhooks/overview) mit den Ereignissen `message.sent`, `message.delivered` und `message.failed`. Die Feinheiten, die Betreiber erwischen: * `submitted_no_receipt` – der Anbieter hat den Versand angenommen, aber im 30-minütigen SMPP-Gnadenfenster kam keine DLR. Als *Ausgang unbekannt* behandeln, nicht als Zustellung und nicht als Fehler. * `expired` – eine DLR kam nach dem Gnadenfenster an; der Vorgang ist abgeschlossen. * `rejected` – Absender-Gate: fehlende Registrierung oder Inhaltspolitik. Deterministisch, bis das Gate freigegeben ist. Die Zustandsmaschine im Konzept: [Zustell-Lebenszyklus](/concepts/delivery-lifecycle); die Fehlerbehandlung: [Troubleshooting: Nachricht nicht zugestellt oder fehlgeschlagen](/troubleshooting/message-undelivered-failed). ## Preisgestaltung SMS-Preise sind pro Segment und länderspezifisch. Aktuelle Preise finden Sie auf der [Preisseite](https://orbit.devotel.io/pricing) oder über `GET /api/v1/pricing/messaging?country=`. Zwei identische Sendungen werden unterschiedlich abgerechnet, sobald die Kodierung einer von ihnen auf UCS-2 kippt – siehe [Kodierung & Verkettung](#kodierung--verkettung). ## Ratenlimits SMS-Sendungen sind standardmäßig auf **100 Anfragen/Minute und Mandant** begrenzt; die Obergrenze ist pro Mandant (Organisation) gekennzeichnet, nicht pro IP oder Plan. Überschreiten liefert `429 RATE_LIMITED`; siehe [Ratenlimits-Leitfaden](/guides/rate-limits). Die Pro-Kanal-Standardlimits (SMS 100, WhatsApp 80, E-Mail 200, Fax 20 u. a.) sind je Kanal über `channel_rate_overrides` in den Messaging-Einstellungen Ihrer Organisation anhebbar. ## Funktionen * **A2P- und P2P-Nachrichten** – sowohl anwendungs- als auch person-zu-person * **Globale Reichweite** – über 190 Länder über Devotels Aggregator-Netzwerk * **Zustellberichte** – Echtzeit-Status-Webhooks für jede Nachricht * **Verkettete Nachrichten** – Mehrteil-SMS transparent verarbeitet (bis zu 10 Segmente) * **E.164-Validierung** – automatische Validierung des Nummernformats * **Unicode-Unterstützung** – GSM-7- und UCS-2-Kodierung mit automatischer Erkennung und Smart-Punctuation-Normalisierung