RCS-Text- und Mediennachrichtenarten
Wenn Sie RCS mit der Vonage Messages API verwenden, können Sie wirkungsvolle, reichhaltige Nachrichten versenden, die das Kundenerlebnis weit über Standard-SMS hinaus verbessern. Dieser Leitfaden konzentriert sich auf RCS-Nachrichtentypen, die Text und Medien übermitteln, und hilft Ihnen zu verstehen, wann und wie Sie jeden einzelnen effektiv nutzen können.
Die folgenden RCS-Text- und Mediennachrichtentypen werden von der Messages API unterstützt:
textimagevideofile
Jeder Nachrichtentyp hat die gleichen erforderlichen (to, from, channel, message_type) und optional (webhook_url, client_ref, ttl, failover) Parameter.
Textnachrichten
Textnachrichten sind der einfachste und flexibelste RCS-Nachrichtentyp. Sie eignen sich am besten für einfache, informative oder zeitkritische Nachrichten, die keine Medien erfordern. Verwenden Sie sie, um Aktualisierungen oder Servicewarnungen zu übermitteln, Transaktionsnachrichten ohne visuelle Werbung oder Auftragsbestätigungen zu senden.
Für Textnachrichten gibt es einige Einschränkungen:
- Die
textParameter ist auf 3072 Zeichen begrenzt.
{
"message_type": "text",
"text": "Hello from Vonage!",
"to": "447700900000",
"from": "Vonage",
"channel": "rcs"
}
RCS-Nachrichten mit einem message_type von text akzeptieren auch eine suggestions Array als Top-Level-Parameter. Das Array kann bis zu elf Vorschlagsobjekte enthalten, die Folgendes definieren vorgeschlagene Antworten und/oder Maßnahmen.
Bildnachrichten
Mit Bildnachrichten können Sie hochauflösendes Bildmaterial wie Werbegrafiken, QR-Codes oder Screenshots versenden, um eine ansprechende Interaktion zu unterstützen. Nutzen Sie sie, um ein neues Produkt anzukündigen, zu einem visuellen Event einzuladen oder Inhalte mit visuellen Anleitungen zu unterstützen.
Es gibt einige Einschränkungen für Bildnachrichten:
- Die Bild-URL muss öffentlich zugänglich sein.
- Das gelieferte Bild muss entweder ein
JPGoderPNG.
{
"message_type": "image",
"image": {
"url": "https://example.com/image.jpg"
},
"to": "447700900000",
"from": "Vonage",
"channel": "rcs"
}
Video-Botschaften
Mit Videonachrichten können Sie kurze Videoclips versenden, die komplexere Ideen in einem ansprechenden Format vermitteln. Verwenden Sie Videonachrichten für Produktdemos und Anleitungen, Veranstaltungsankündigungen oder persönliche Mitteilungen.
Es gibt einige Einschränkungen für Videobotschaften:
- Das gelieferte Video muss in einem
.mp4,.webm, oder.m4vFormat - Halten Sie Videos kurz und optimieren Sie sie für mobile Geräte.
{
"message_type": "video",
"video": {
"url": "https://example.com/video.webm"
},
"to": "447700900000",
"from": "Vonage",
"channel": "rcs"
}
Datei-Nachrichten
Mithilfe von Dateinachrichten können Sie herunterladbare Dokumente wie PDFs versenden und so Formulare, Rechnungen oder Referenzmaterialien leicht weitergeben. Verwenden Sie Dateinachrichten zum Senden von E-Tickets, Verträgen, Rechnungen, Onboarding-Dokumenten oder anderen rechtlichen Formularen.
Für Dateinachrichten gibt es Einschränkungen:
- Es wird nur PDF unterstützt.
- Die Datei muss unter einer öffentlich zugänglichen URL gehostet werden.
- Berücksichtigen Sie die Dateigröße für die mobile Datennutzung und Leistung.
{
"message_type": "file",
"file": {
"url": "https://example.com/file.pdf"
},
"to": "447700900000",
"from": "Vonage",
"channel": "rcs"
}
Code-Schnipsel
Nachfolgend finden Sie eine Liste von Codeschnipseln zum Senden von Nachrichtenanforderungen für verschiedene Nachrichtentypen: