View a markdown version of this page

Senden umfangreicher RCS-Nachrichten von der Konsole - AWSSMS-Nachrichten für Endbenutzer

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Senden umfangreicher RCS-Nachrichten von der Konsole

Die AWS End User Messaging-Konsole bietet einen visuellen Nachrichteneditor, mit dem Sie umfangreiche RCS-Nachrichten erstellen und versenden können, ohne Code schreiben zu müssen. Der Composer ist direkt der SendRcsMessage API zugeordnet und unterstützt alle Inhaltstypen: Textnachrichten, Dateinachrichten, Rich Cards und Karussells. Sie können interaktive Vorschläge an jeden Nachrichtentyp anhängen, Time-to-Live-Einstellungen (TTL) konfigurieren und SMS- oder MMS-Fallback für Empfänger einrichten, deren Geräte RCS nicht unterstützen.

Sie können umfangreiche Nachrichten auf der Registerkarte Ausgehende Testnachrichten der RCS-Testoberfläche verfassen und versenden. Nachrichten werden an verifizierte RBM-Tester gesendet, sodass Sie das Rendern und die Übermittlung überprüfen können, bevor Sie die SendRcsMessage API in Ihre Anwendung integrieren.

Während Sie die Nachricht konfigurieren, wird in Echtzeit in einer Telefonvorschau angezeigt, wie die Nachricht auf dem Gerät des Empfängers wiedergegeben wird. Sie können auch den entsprechenden JSON-Payload- oder AWS CLI-Befehl kopieren, um dieselbe Nachrichtenstruktur in Ihrem Anwendungscode zu verwenden.

Weitere Informationen zu den Nachrichtentypen und ihrer API-Struktur finden Sie unterSenden umfangreicher RCS-Nachrichten. Einzelheiten zu den Arten und zum Verhalten von Vorschlägen finden Sie unterKonfiguration von RCS-Vorschlägen.

Voraussetzungen

Bevor Sie umfangreiche RCS-Nachrichten von der Konsole aus senden, sollten Sie Folgendes überprüfen:

  • Ihr RCS-Agent befindet sich im Status „Testen“ oder „Aktiv“.

  • Ihrem Agenten ist mindestens eine verifizierte RBM-Tester-Telefonnummer zugeordnet. Anweisungen zur Einrichtung finden Sie unterTesten von RCS-Nachrichten.

  • Wenn Sie Mediendateien von Amazon S3 aus versenden möchten, muss der S3-Bucket über eine Bucket-Richtlinie verfügen, die sms-voice.amazonaws.com Lesezugriff gewährt. Details hierzu finden Sie unter RCS-Dateinachrichten senden.

Senden einer umfangreichen RCS-Nachricht

Gehen Sie wie folgt vor, um eine umfangreiche RCS-Nachricht von der AWS End User Messaging-Konsole aus zu verfassen und zu senden.

  1. Öffnen Sie die AWS End User Messaging-Konsole unterhttps://console.aws.amazon.com/sms-voice/.

  2. Wählen Sie im Navigationsbereich unter Konfigurationen die Option RCS-Agenten aus.

  3. Wählen Sie den Agenten aus, den Sie als Originationsidentität verwenden möchten. Der Agentenstatus muss „Testen“ oder „Aktiv“ lauten.

  4. Wählen Sie die Registerkarte Testen.

  5. Wählen Sie in der RCS-Testoberfläche die Registerkarte Ausgehende Testnachrichten.

  6. Wählen Sie im Abschnitt RCS-Testnachricht senden für Select RBM-Tester eine verifizierte RBM-Tester-Telefonnummer aus.

  7. (Optional) Wählen Sie unter Konfigurationssatz einen Konfigurationssatz für die Nachverfolgung von Nachrichtenereignissen aus.

  8. Wählen Sie für Select API die Option SendRcsMessage.

  9. Wählen Sie unter Nachrichtenformat auswählen den Nachrichtentyp aus, den Sie senden möchten:

    • Text: Geben Sie einen Nachrichtentext ein (bis zu 3.072 Zeichen).

    • Datei: Wählen Sie als Medienquelle S3-Bucket oder Öffentliche URL und geben Sie dann die S3-URI (oder HTTPS-URL) der zu sendenden Datei ein. Wählen Sie „S3 durchsuchen“, um eine Datei aus einem Bucket auszuwählen, oder „Anzeigen“, um die referenzierte Datei in einem neuen Browser-Tab zu öffnen. Die maximale -Dateigröße ist 100 MB. Geben Sie optional eine Miniaturansicht-URL für Video- oder PDF-Dateien an.

    • Rich Card: Konfigurieren Sie die folgenden Kartenfelder. Mindestens ein Titel, eine Beschreibung oder ein Medium ist erforderlich.

      • Ausrichtung der Karte: Wählen Sie VERTICAL oderHORIZONTAL.

      • Kartentitel: Geben Sie einen Titel ein (bis zu 200 Zeichen).

      • Kartenbeschreibung: Geben Sie eine Beschreibung ein (bis zu 2.000 Zeichen).

      • Medien-URL: Wählen Sie als Medienquelle S3-Bucket oder Öffentliche URL und geben Sie dann die S3-URI (oder HTTPS-URL) ein. Wählen Sie „S3 durchsuchen“, um eine Datei auszuwählen, oder „Anzeigen“, um sie in einem neuen Browser-Tab zu öffnen. Die maximale -Dateigröße ist 100 MB.

      • (Optional) URL der Medien-Miniaturansicht: Ein Vorschaubild, das angezeigt wird, bevor das gesamte Medium geladen wird.

      • (Nur HORIZONTALE Ausrichtung) Ausrichtung der Miniaturansicht: Wählen Sie LEFT oderRIGHT, um das Miniaturbild zu positionieren.

      • Kartenvorschläge: Fügen Sie bis zu 4 Vorschläge hinzu, die als Schaltflächen innerhalb der Kartenbegrenzung dargestellt werden. Informationen zu den Arten von Vorschlägen finden Sie unterKonfiguration von RCS-Vorschlägen.

    • Karussell: Konfigurieren Sie Folgendes:

      • Kartenbreite: Wählen Sie SMALL oder. MEDIUM

      • Medienhöhe (alle Karten): Wählen Sie SHORT oderMEDIUM. Alle Karten in einem Karussell verwenden dieselbe Medienhöhe.

      • Karten: Füge zwischen 2 und 10 Karten hinzu. Jede Karte enthält einen Kartentitel, eine Kartenbeschreibung, eine Medien-URL (S3-Bucket oder öffentliche URL, maximal 100 MB) und bis zu 4 Kartenvorschläge. Für jede Karte ist mindestens ein Titel, eine Beschreibung oder ein Medium erforderlich.

    • JSON: Fügt eine rohe RcsMessageContent JSON-Nutzlast direkt ein. Wählen Sie Format JSON, um die Payload zu formatieren. Die Konsole validiert die Struktur und aktualisiert die Telefonvorschau in Echtzeit.

  10. (Optional) Konfigurieren Sie Mediendateien mit dem S3-Browser:

    1. Wählen Sie S3 durchsuchen.

    2. Wählen Sie einen Bucket aus der Drop-down-Liste aus.

    3. Navigieren Sie durch die Präfixe (Ordner), um Ihre Datei zu finden.

    4. Wählen Sie die -Datei aus. Das URL-Feld wird automatisch aufgefüllt.

    Anmerkung

    Der S3-Bucket muss über eine Bucket-Richtlinie verfügen, die sms-voice.amazonaws.com Lesezugriff auf die Objekte gewährt. Die erforderliche Richtlinie finden Sie unterRCS-Dateinachrichten senden.

  11. (Optional) Fügen Sie Vorschläge auf Nachrichtenebene hinzu. Gehen Sie im Abschnitt Vorschläge wie folgt vor:

    1. Wählen Sie Vorschlag hinzufügen.

    2. Wählen Sie als Vorschlagstyp eine der Optionen „Antwort“, „URL öffnen“, „Telefon wählen“, „Standort anzeigen“, „Standort anfordern“ oder „Kalenderereignis“.

    3. Geben Sie die erforderlichen Felder für den ausgewählten Typ ein. Alle Vorschlagstypen erfordern einen Text Wert (bis zu 25 Zeichen) und PostbackData (bis zu 2.048 Zeichen).

    4. Wiederholen Sie den Vorgang, um bis zu 11 Vorschläge auf Nachrichtenebene hinzuzufügen.

    Message-level Vorschläge werden als Chip-Liste unter der gesamten Nachricht angezeigt. Sie können Vorschläge auf Nachrichtenebene an jeden Inhaltstyp anhängen (Text, Datei, Rich Card oder Karussell). Details hierzu finden Sie unter Konfiguration von RCS-Vorschlägen.

  12. (Optional) Konfigurieren Sie die Einstellung für die Gültigkeitsdauer (TTL). Erweitern Sie Erweiterte Optionen und geben Sie einen Wert in das Feld Gültigkeitsdauer (Sekunden) ein. Gültige Werte liegen zwischen 1 und 172.800 Sekunden (48 Stunden). Ein Mindestwert von 10 Sekunden wird empfohlen.

    Wenn die Nachricht nicht zugestellt wird, bevor die TTL abläuft, löst der Dienst ein TTL-Ablaufereignis aus. Wenn Sie Fallback konfiguriert haben, wird die Fallback-Nachricht zu diesem Zeitpunkt gesendet.

    Der Abschnitt „Erweiterte Optionen“ enthält außerdem Höchstpreis (USD), Testlauf, Nachrichtenfeedback, Protect-Konfiguration und Kontext (optionale Schlüsselwertmetadaten).

  13. (Optional) Konfigurieren Sie den SMS- oder MMS-Fallback. Erweitern Sie den Abschnitt Fallback-Konfiguration:

    1. Wählen Sie als Fallback-Kanal SMS oder MMS.

    2. Geben Sie als Fallback-Nachrichtentext den Nachrichtentext ein (bis zu 1.600 Zeichen). Ein Nachrichtentext ist erforderlich, wenn ein Fallback-Kanal ausgewählt wird.

    3. Für MMS können Sie auch eine oder mehrere Medien-URLs angeben.

    4. Geben Sie für Origination Identity die Telefonnummer oder Absender-ID ein, die für die Fallback-SMS- oder MMS-Nachricht verwendet werden soll. Dies ist erforderlich, wenn der Versand von einem RCS-Agenten aus erfolgt.

    Fallback wird ausgelöst, wenn die Nachricht nicht über RCS zugestellt werden kann (z. B. wenn das Gerät des Empfängers RCS nicht unterstützt oder wenn die TTL abläuft). Weitere Informationen finden Sie unter Senden umfangreicher RCS-Nachrichten.

  14. (Optional) Aktivieren Sie in den erweiterten Optionen die Option Testlauf, um die Nachrichtenstruktur zu überprüfen, ohne sie zu senden. Dadurch fallen keine Gebühren an und die Nachricht wird dem Empfänger nicht zugestellt.

  15. Sehen Sie sich die Telefonvorschau auf der rechten Seite des Composers an. Die Vorschau wird in Echtzeit aktualisiert und zeigt:

    • Rendern von Inhalten (Text, Medien, Kartenlayout, Karussell-Scroll)

    • Vorschläge werden unter der Nachricht angezeigt

    • Card-level Knöpfe innerhalb der Karten

    Anmerkung

    Die Vorschau entspricht in etwa dem Android-Rendering. Die Anzeige auf iOS oder anderen RCS-Clients kann abweichen. Die Vorschau simuliert nicht das Verhalten bei der Auswahl von Vorschlägen.

  16. Wählen Sie Testnachricht senden, um die Nachricht an den ausgewählten RBM-Tester zu senden, oder verwenden Sie eine der folgenden Optionen:

    • JSON kopieren: Kopiert das Nachrichten-JSON in Ihre Zwischenablage. Wählen Sie RcsMessageContent, ob nur der Inhaltsteil oder Vollständige API-Anfrage kopiert werden soll, um den gesamten SendRcsMessage Anfragetext zu kopieren.

    • CLI-Befehl kopieren: Kopiert den entsprechenden aws pinpoint-sms-voice-v2 send-rcs-message Befehl.

Überprüfung von Eingaben

Die Konsole führt während der Konfiguration der Nachricht eine Echtzeitvalidierung durch. Validierungsfehler werden direkt neben dem betroffenen Feld angezeigt. In der folgenden Tabelle sind die Validierungsregeln zusammengefasst.

Regeln für die Konsolenvalidierung
Feld Regel
Phone number (Telefonnummer) Muss E.164 formatiert sein
Medien-URL Muss mit https:// oder beginnen s3://
Größe der Mediendatei Maximal 100 MB
Text des Vorschlags Maximal 25 Zeichen
Postback-Daten Maximal 2.048 Zeichen
Titel der Karte Maximal 200 Zeichen
Beschreibung der Karte Maximal 2.000 Zeichen
Karussell-Karten Mindestens 2, maximal 10
Card-level Vorschläge Maximal 4 pro Karte
Message-level Vorschläge Maximal 11
Hauptteil der Textnachricht Maximal 3.072 Zeichen
TTL 1 bis 172.800 Sekunden
Hauptteil der Fallback-Nachricht Maximal 1.600 Zeichen