Ein Benachrichtigungsdienst braucht sowohl einen Weg, Texte einzureichen, als auch eine Route zu den Telefonen der Empfänger. Die Wahl einer Schnittstelle beantwortet nur den ersten Teil dieses Problems.
Was leistet jeder Teil?
Eine API nimmt programmatische Anfragen entgegen. Ein Gateway verbindet Ihre Anwendung mit Mobilfunknetzen.
Ihre Anwendung übermittelt Empfänger, Absender und Nachricht über die Schnittstelle. Das Gateway leitet Nachrichten an die Netzwerkdienste weiter, die sie zustellen. Ein Anbieter kann beide Teile in einem Dienst bereitstellen.
Die SMPP-Gateway-Referenz beschreibt Gateways, die Anwendungen mit mobilen Nachrichtenzentralen verbinden. Sie beschreibt auch Gateways, die mehrere Schnittstellen anbieten, darunter HTTP und SMPP.
Die Schnittstelle bestimmt nicht jede Zustellfähigkeit. Ein praktisches Anfrageformat kann einen nicht unterstützten Absender in einem Zielland nicht gültig machen.
Welche Schnittstelle sollte ich wählen?
Wählen Sie HTTP für eine neue Anwendung, es sei denn, eine bestehende SMPP-Integration oder eine spezifische Verbindungsanforderung rechtfertigt die Verwaltung von SMPP.
Mit HTTP sendet Ihre Anwendung Anfragen und verarbeitet Antworten. Sie braucht dennoch Wiederholungsversuche, Schutz vor doppeltem Versand und Zustellereignis-Verarbeitung.
SMPP verwendet eine dauerhaft geöffnete Verbindung. Ihr Client authentifiziert eine Sitzung und behandelt Verbindungsverluste, Bestätigungen und eingehende Operationen. SMPP erläutert diese Arbeit.
Ein bestehendes SMPP-System kann diese Schnittstelle zur praktischen Wahl machen. Testen Sie die unterstützten Operationen und Limits des Anbieters, bevor Sie annehmen, dass eine weitere SMPP-Verbindung sich identisch verhält.
Welche Zustellfähigkeiten sollte ich vergleichen?
Vergleichen Sie Zielabdeckung, erlaubte Absender, Durchsatz und aussagekräftige Fehlerberichte mit den Anforderungen Ihrer Anwendung.
- Ziele: Bestätigen Sie die Unterstützung für jedes Land, das Sie bedienen, da eine funktionierende Route keine andere garantiert.
- Absender: Prüfen Sie Verfügbarkeit und Registrierung, bevor Sie sich auf die Identität festlegen, die Empfänger sehen werden.
- Durchsatz: Unterscheiden Sie Anfragelimits von der Rate, mit der der Zustellweg Datenverkehr transportieren kann.
- Ereignisse: Prüfen Sie, wie eingehende Nachrichten und Zustellfehler Ihre Anwendung erreichen.
Die Zielseiten von Bird veröffentlichen länderspezifische Anforderungen. Absendertypen erläutert die Identitätsoptionen.
Warum erfolgt die Zustellung getrennt von der Annahme?
Das Netzwerk kann die Zustellung abschließen, nachdem Ihre Sendeanfrage beendet ist.
Eine Nachrichtenzentrale kann einen Text aufbewahren, solange ein Telefon nicht erreichbar ist. Nachrichtenzentralen erläutert diese Wartephase.
Behandeln Sie Einreichung und Zustellung als getrennte Ergebnisse in Ihrer Anwendung. Andernfalls kann eine angenommene Anfrage erfolgreich erscheinen, obwohl ein späterer Zustellbericht einen Fehler meldet.
Wie sende ich über die HTTP API von Bird?
Sie reichen eine Nachricht ein, speichern deren Kennung und verarbeiten die darauf folgenden Zustellereignisse.
Verwenden Sie POST /v1/sms/messages mit to, from, text und category für einen Freitext-Versand. Setzen Sie category auf marketing, transactional, authentication oder service. Der Versandleitfaden dokumentiert die unterstützten Felder.
Eine 202-Antwort bestätigt die Annahme. Sie bestätigt nicht die Zustellung an das Telefon. Verfolgen Sie die zurückgegebene id über SMS-Ereignisse, damit das endgültige Ergebnis die richtige Anfrage aktualisiert.
Welcher Weg passt zu meiner Anwendung?
Wählen Sie die Schnittstelle, die Ihre Anwendung zuverlässig betreiben kann, und prüfen Sie die Zustellfähigkeiten separat.
- Verwenden Sie HTTP für eine neue Integration ohne spezifische SMPP-Anforderung.
- Verwenden Sie SMPP, wenn ein bestehendes System oder ein erforderliches Verbindungsverhalten die Sitzungsverwaltung rechtfertigt.
- Testen Sie Ziele, Absender und Zustellereignisse, bevor Sie Datenverkehr auf einen der beiden Wege leiten.
Kurz gesagt
API und Gateway erfüllen unterschiedliche Aufgaben.
Die API nimmt Ihre Anfrage entgegen, während das Gateway den Weg zum Mobilfunknetz bereitstellt.
HTTP vermeidet die Verwaltung einer SMPP-Sitzung.
SMPP erfordert zusätzlich zu Ihrem Nachrichten-Workflow Verbindungswiederherstellung und Sitzungsverwaltung.
Annahme und Zustellung bleiben getrennt.
Eine erfolgreiche Sendeanfrage belegt nicht, dass der Empfänger die Nachricht erhalten hat.
Vergleichen Sie neben der Schnittstelle auch den Zustellweg.
Prüfen Sie Zielunterstützung, Absenderanforderungen, Durchsatz und Fehlerberichte, bevor Sie sich für eine Integration entscheiden.