View a markdown version of this page

Senden von RCS-Textnachrichten - AWS SMS-Nachrichten für Endbenutzer
Wie unterscheiden sich RCS-Textnachrichten von SMSRcsMessageContent Struktur für TextnachrichtenEine Textnachricht sendenSMS- oder MMS-FallbackGrenzwerte für TextnachrichtenWann sollten Textnachrichten verwendet werden

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 von RCS-Textnachrichten

A TextMessage ist der einfachste Inhaltstyp, den Sie mit der SendRcsMessage API senden können. Er besteht aus einem Klartext-Hauptteil (bis zu 3.072 Zeichen) mit optionalen Vorschlagschips, die als interaktive Schaltflächen unter der Nachricht angezeigt werden.

Wie unterscheiden sich RCS-Textnachrichten von SMS

Per SMS versendete Textnachrichten SendRcsMessage unterscheiden sich in zweierlei Hinsicht von SMS-Nachrichten: SendTextMessage

  • Vorschlags-Chips: Sie können bis zu 11 Vorschlags-Chips an eine RCS-Textnachricht anhängen. Mit diesen Chips können Empfänger in einem Schritt antworten, eine URL öffnen, eine Telefonnummer wählen, einen Standort teilen oder ein Kalenderereignis erstellen. SMS unterstützt keine Vorschläge.

  • Single-message Zustellung: Eine RCS-Textnachricht kommt unabhängig von ihrer Länge als einzelne Nachricht an (bis zu 3.072 Zeichen). Netzbetreiber teilen SMS-Nachrichten, die länger als 160 Zeichen sind, in mehrere Segmente auf, die möglicherweise nicht in der richtigen Reihenfolge oder mit Verzögerungen zwischen den Segmenten ankommen.

Einzelheiten zu allen verfügbaren Vorschlagstypen und ihren Parametern finden Sie unterKonfiguration von RCS-Vorschlägen.

RcsMessageContent Struktur für Textnachrichten

Wenn Sie aufrufenSendRcsMessage, übergeben Sie die Nutzlast der Nachricht als RcsMessageContent Parameter. Bei einer Textnachricht legen Sie das Content Feld auf ein TextMessage Objekt fest, das eine Body Zeichenfolge enthält. Um Vorschlags-Chips einzubeziehen, fügen Sie ein Suggestions Array als gleichrangiges Array von hinzu. Content

Das folgende JSON-Snippet zeigt die Struktur einer RcsMessageContent Textnachricht mit Vorschlägen:

{
  "Content": {
    "TextMessage": {
      "Body": "What would you like to do?"
    }
  },
  "Suggestions": [
    {
      "Reply": {
        "Text": "Check order status",
        "PostbackData": "action=check_order"
      }
    },
    {
      "OpenUrl": {
        "Text": "View details",
        "PostbackData": "action=view",
        "Url": "https://example.com/orders/1234"
      }
    }
  ]
}

In diesem Beispiel:

  • Content.TextMessage.Bodyenthält den Nachrichtentext (erforderlich, 1 bis 3.072 Zeichen).

  • Suggestionsist ein Array der obersten Ebene (optional, bis zu 11 Elemente). Jeder Vorschlag erfordert ein Text Feld (bis zu 25 Zeichen) und ein PostbackData Feld (bis zu 2.048 Zeichen).

Das Suggestions Array unterstützt sechs Aktionstypen:Reply,,OpenUrl, DialPhone ShowLocationRequestLocation, und. CreateCalendarEvent Sie können verschiedene Vorschlagstypen in einer einzigen Nachricht kombinieren. Vollständige Informationen zu den einzelnen Typen finden Sie unterKonfiguration von RCS-Vorschlägen.

Eine Textnachricht senden

Um eine RCS-Textnachricht zu senden, rufen Sie SendRcsMessage mit den folgenden erforderlichen Parametern auf:

  • DestinationPhoneNumber: Die Telefonnummer des Empfängers im E.164 Format.

  • OriginationIdentity: Die Pool-ID oder der AWS RCS-Agent, der die Nachricht sendet.

  • RcsMessageContent: Die JSON-Zeichenfolge, die Content ein TextMessage Objekt enthält.

Sie rufen die API mit der AWS-CLI (aws pinpoint-sms-voice-v2 send-rcs-message) oder einem AWS-SDK wie dem pinpoint-sms-voice-v2 boto3-Client auf.

SMS- oder MMS-Fallback

Wenn das Gerät des Empfängers RCS nicht unterstützt oder auf dem RCS-Kanal vorübergehend nicht erreichbar ist, können Sie die Nachricht so konfigurieren, dass sie auf SMS oder MMS zurückgreift. Um Fallback zu aktivieren, fügen Sie Ihrer Anfrage ein Objekt hinzuFallbackConfiguration. SendRcsMessage Das FallbackConfiguration gibt den Fallback-Kanal (SMSoderMMS), den Text der Fallback-Nachricht und die Absenderidentität (eine Telefonnummer oder Absender-ID) an, die für die Fallback-Nachricht verwendet werden sollen.

Fallback ist optional. Wenn Sie es weglassen FallbackConfiguration und der Empfänger RCS nicht empfangen kann, wird die Nachricht nicht zugestellt.

Weitere Informationen zur Konfiguration des Fallback-Verhaltens finden Sie unter. Senden umfangreicher RCS-Nachrichten

Grenzwerte für Textnachrichten

Ressource Limit Hinweise
Nachrichtentext (Body) 3.072 Zeichen () UTF-8 Erforderlich Muss mindestens 1 Zeichen enthalten.
Vorschläge pro Nachricht 11 Summe der Antworten und Aktionen.
Text für den Vorschlag anzeigen (Text) 25 Zeichen Gilt für alle Arten von Vorschlägen.
Postback-Daten () PostbackData 2,048 Zeichen Für alle Arten von Vorschlägen erforderlich.

Wann sollten Textnachrichten verwendet werden

Verwenden Sie TextMessage für:

  • Benachrichtigungen wie Auftragsbestätigungen, Versandaktualisierungen und Terminerinnerungen.

  • One-time Passwörter und Bestätigungscodes.

  • Konversationsansagen, die Antwortoptionen als Vorschlags-Chips bieten und so geführte Interaktionen ohne Freitexteingabe ermöglichen.

  • Kurze Statusmeldungen, bei denen für den Inhalt keine Bilder oder strukturierte Layouts erforderlich sind.

Verwenden Sie für Nachrichten, die Bilder, Videos oder strukturierte Layouts mit Titeln und Beschreibungen erfordern, stattdessen Rich-Cards oder Karussells. Siehe Senden umfangreicher RCS-Nachrichten.