MMS-Nachrichten verstehen

Mit MMS (Multimedia Messaging Service) können Sie multimediale Inhalte wie Bilder, Videos und Audiodateien sowie längere Textinhalte versenden, als in einer einzigen SMS-Nachricht möglich sind. Die Nachrichten werden über das Mobilfunknetz zugestellt, ohne dass der Empfänger eine Daten- oder WLAN-Verbindung haben muss.

Es gibt viele Anwendungsmöglichkeiten für MMS-Nachrichten, darunter Marketing, politische Kampagnen, Werbeaktionen und Benachrichtigungen.

Verfügbarkeit

Die Vonage Messages API unterstützt derzeit den Versand von MMS-Nachrichten in den USA und Kanada. US Short Codes, 10DLC Nummern und SMS Enabled Toll Free Numbers werden derzeit für den Versand von MMS unterstützt. Für US Short Codes können MMS-Nachrichten an die Netze von AT&T, T-Mobile (früher Sprint) und Verizon in den USA gesendet werden. Der Nachrichtendurchsatz, die Zustellbarkeit und das SMS-Nachrichtenvolumen können je nach Art der verwendeten Numbers variieren.

10DLC

Um MMS-Nachrichten über 10-stellige Vorwahlen in den USA zu versenden, müssen Sie die Nummer mit einer 10DLC-Marke und -Kampagne registrieren. Siehe dieses Dokument um mehr über die Einrichtung von 10DLC Numbers zu erfahren (Hinweis: Das Dokument bezieht sich auf die SMS API, aber der Inhalt des Abschnitts 10 DLC Richtlinien gilt auch für die Messages API).

Messaging-Funktionen

Der MMS-Kanal der Messages API unterstützt sowohl ausgehende Nachrichten (vom Unternehmen an den Kunden gesendete Nachrichten) als auch eingehende Nachrichten (vom Kunden an das Unternehmen gesendete Nachrichten als Antwort auf eine ausgehende Nachricht). Innerhalb dieser beiden Kategorien gibt es mehrere verschiedene Arten von Nachrichten.

Ausgehende Nachrichtentypen

Es gibt sieben Arten ausgehender Nachrichten:

• text
• image
• audio
• video
• vcard
• file
• content

Alle Nachrichtentypen außer text kann einen Medien- oder Dateianhang enthalten. Die Website image, audio, video, vcardund file Typen können einen einzelnen Anhang eines bestimmten Typs enthalten; die content Nachrichtentyp kann mehrere Anhänge beliebigen Typs enthalten. Alle Anhangsdateien müssen in der API-Nutzlast über eine öffentlich zugängliche URL angegeben werden.

Eingehende Nachrichtentypen

Es gibt sechs Arten von eingehenden Nachrichten:

• text
• image
• audio
• video
• vcard
• file

Alle Nachrichtentypen mit Ausnahme von Text können einen oder mehrere Medien- oder Dateianhänge enthalten. Die Hauptanlage ist von einem durch den Nachrichtentyp festgelegten Typ. Alle weiteren Anlagen können von beliebigem Typ sein. Der Zugriff auf Anhänge erfolgt über (eine) URL(s), die in der Webhook-Nutzlast der eingehenden Nachricht angegeben sind.

Status Webhook

Zusätzlich zu den ausgehenden und eingehenden Nachrichten bietet der MMS-Kanal Statusmeldungen über einen Webhook. Diese Nachrichten werden durch Änderungen des Zustellungsstatus einer ausgehenden Nachricht ausgelöst. Die verfügbaren Status für ausgehende Nachrichten sind:

• submitted
• delivered
• rejected
• undeliverable

Weitere Einzelheiten zu ausgehenden und eingehenden Nachrichten sowie zum Status-Webhook finden Sie in der Messages API-Spezifikation.

Technische Daten

Ausführliche Informationen zur Authentifizierung, zu den Eigenschaften der JSON-Nutzdaten, zu Antworten und Fehlern für die verschiedenen ausgehenden und eingehenden RCS-Nachrichtentypen sowie zu den Statusmeldungen finden Sie in Messages API-Spezifikation.

Es gibt noch einige andere technische Details zu beachten, die im Folgenden erläutert werden.

Unterstützte Medientypen

Für die Nachrichtentypen, die Medien wie Bilder, Videos und Dateien enthalten können, werden die folgenden Medientypen unterstützt:

Nachrichten- und Mediengrößen

Es gibt einige Größenbeschränkungen und Richtlinien, die für Nachrichten und Medien zu beachten sind.

• Begrenzung der Textzeichen:
  • 1600 Zeichen im Textfeld eines Textnachrichtentyps
  • 300 Zeichen im Beschriftungsfeld anderer MMS-Nachrichtentypen
• Empfehlungen zur Dateigröße
  • Bis zu 200KB: Optimieren Sie die Zustellung. Vermeiden Sie Verzögerungen bei der Zustellung und Komprimierung.
  • Bis zu 600KB: Größte Unterstützung. Vermeiden Sie Ablehnungen oder Nichtzustellungen.
  • 1MB: Nur IMI-Kurzcodes. Kann zu erheblichen Verarbeitungs- und Lieferverzögerungen und/oder Komprimierung und verminderter Qualität der Originaldatei führen.

TTL

TTL steht für Time-To-Live, d. h. für die Zeit, die eine Nachricht bestehen sollte, bevor sie erfolgreich zugestellt wird. Wenn sie nicht delivered innerhalb der TTL-Zeit erfolgreich, gilt die Nachricht als abgelaufen und wird rejected wenn TTL unterstützt wird.

TTL wird als numerischer Wert in Sekunden in der ttl Parameter der JSON-Nutzdaten. Für MMS ist das Minimum ttl Wert ist 300 Sekunden (5 Minuten), und der Höchstwert beträgt 259200 (oder 3 Tage).

Wenn der TTL-Wert überschritten wird, erhält die Nachricht den Status rejected. A Webhook "Nachrichtenstatus wird über diese Statusänderung informiert und enthält Fehlerdetails für Fehlercode 1360.

Weitere Informationen

• Messages API-Spezifikation
• Code-Beispiel: Senden einer MMS-Bildnachricht