Kurze Antwort
Um SMS-Versand in eine App einzubauen, rufen Sie die SMS-API des Anbieters aus Ihrem Backend auf, mit Zugriffstoken, der Empfängernummer im internationalen Format, einer freigegebenen Absenderkennung (Sender-ID) und dem Nachrichtentext. Speichern Sie die zurückgegebene Message-ID, empfangen Sie Zustellstatus per Webhook und behandeln Sie Fehler, Wiederholungen und Ratenlimits vor dem Go-live.
Schritte zur Integration
- Besorgen Sie Test-Zugangsdaten und registrieren Sie die Testnummern, an die Sie senden.
- Speichern Sie das API-Token in einem Secrets-Manager oder einer Umgebungsvariablen auf Ihrem Server, niemals in einer mobilen App oder im Browser-Code.
- Speichern Sie Nummern im E.164-Format und wandeln Sie sie in das Format um, das die API erwartet.
- Wählen Sie die Kodierung: GSM-7-Text oder Unicode für Arabisch, Emoji und andere Schriften.
- Senden Sie die Nachricht und speichern Sie die zurückgegebene Message-ID zusammen mit Ihrem eigenen Datensatz.
- Richten Sie einen Webhook für Zustellstatus ein.
- Bauen Sie Wiederholungen mit Backoff für 429- und 5xx-Antworten ein und registrieren Sie Absenderkennungen für jedes Land, das sie verlangt.
Fehler, die Sie vermeiden sollten
- Die API aus der Client-App aufrufen, wodurch das Token für jeden sichtbar wird.
- Nummern mit Pluszeichen, Leerzeichen oder nationaler führender Null senden, obwohl die API nur Ziffern erwartet.
- Zulassen, dass ein einziges typografisches Anführungszeichen oder Emoji die ganze Nachricht auf Unicode umstellt und so die Zeichen pro Segment reduziert.
- Nach einem Timeout blind wiederholen. Bietet die API keinen Idempotenzschlüssel, protokollieren Sie jeden Versand zuerst und prüfen Sie den Status, bevor Sie erneut senden.
- 429-Antworten ignorieren, statt den Retry-After-Header abzuwarten.
Beispiel: eine einzelne SMS-Anfrage
Bei OmniChannels.ai senden Sie eine SMS mit POST https://api.broadnet.me/sms/sendSms, einem Authorization: Bearer-Header und einem JSON-Body. Ein erfolgreicher Aufruf liefert 200 mit der Message-ID als Klartext. Testzugang gibt es nach einer kurzen Anfrage, und er sendet an Ihre eigenen verifizierten Nummern; eine sofortige Self-Service-Registrierung gibt es nicht.
| Feld | Beispiel | Hinweis |
|---|---|---|
| senderId | OmniDemo | Ihre freigegebene Absenderkennung |
| destinationNumber | 447700900123 | Ländervorwahl plus Nummer, nur Ziffern |
| message | Your code is 482913 | Der Text |
| messageType | TEXT | TEXT für GSM-7, UNICODE für Arabisch und Emoji |