View a markdown version of this page

Testen von RCS-Nachrichten - AWS SMS-Nachrichten für Endbenutzer
Was ist ein Testagent?Testgeräte hinzufügenAblauf der Einladungen für TesterTestgeräte anzeigenSenden von TestnachrichtenSMS-Fallback wird getestetProblembehebung bei RCS-Tests

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.

Testen von RCS-Nachrichten

Bevor Sie RCS-Messaging in der Produktion starten, können Sie Ihre Integration mit einem Testagenten testen. Der Testagent ist eine RCS for Business ID, die erstellt wird, wenn Sie eine Testregistrierung für Ihren AWS RCS Agent einreichen. Es bietet vollen API-Zugriff, der mit dem der Produktion identisch ist, beschränkt jedoch die Nachrichtenzustellung nur auf registrierte Testgeräte. Für Tests ist keine Genehmigung durch den Mobilfunkanbieter erforderlich.

Dieses Kapitel konzentriert sich auf den Testagenten selbst, einschließlich der Verwaltung von Testgeräten und der Behebung häufig auftretender Probleme. Eine step-by-step exemplarische Vorgehensweise zum Erstellen Ihres ersten AWS RCS-Agenten und zum Senden einer Testnachricht finden Sie unter. Erste Schritte mit RCS Einzelheiten zur Erstellung eines AWS RCS-Agenten und zum Einreichen einer Testregistrierung finden Sie unterVerwaltung von RCS-Agenten.

Wichtig

Testnachrichten werden zu den standardmäßigen RCS-Tarifen berechnet. Der Testagent stellt eine Testumgebung zur Validierung Ihrer Integration bereit. Für die Nachrichtenübermittlung an Testgeräte fallen jedoch dieselben Gebühren an wie für Produktionsnachrichten.

Was ist ein Testagent?

Ein Testagent ist eine RCS for Business ID, die AWS End User Messaging erstellt, wenn Sie eine Testregistrierung für Ihren AWS RCS Agent einreichen. Der Testagent ermöglicht Ihnen:

  • Senden Sie RCS-Nachrichten ohne Genehmigung des Netzbetreibers an registrierte Testgeräte

  • Verwenden Sie die SendTextMessage API, um Testnachrichten zu senden, dieselbe API, die Sie in der Produktion verwenden

  • Konfigurieren Sie Pools, Konfigurationssätze, Opt-Out-Listen, Schlüsselwörter und andere AWS Endbenutzer-Messaging-Funktionen für Ihren Test-Workflow

  • Testen Sie bidirektionales Messaging, indem Sie Nachrichten mit Schlüsselwörtern für automatische Antworten senden

  • Testen Sie das SMS-Fallback-Verhalten mit oder ohne genehmigte SMS-Telefonnummer

Testgeräte, die Sie für einen Testing Agent registrieren, funktionieren in allen Ländern für diesen AWS RCS Agent. Sie müssen die Testgeräte nicht für jedes Land separat registrieren. Umgekehrt kann der Testagent Nachrichten an Testgeräte in jedem Land senden, unabhängig davon, ob Sie für dieses Land eine Registrierung für die Markteinführung eingereicht haben.

Testgeräte hinzufügen

Bevor Sie RCS-Testnachrichten senden können, müssen Sie ein oder mehrere Testgeräte als verifizierte Zielnummern registrieren. Sie können Testgeräte mithilfe der AWS End User Messaging-Konsole oder der CreateVerifiedDestinationNumber API hinzufügen.

Console

In der Konsole werden Testgeräte als Teil des Workflows zur Erstellung von AWS RCS-Agenten hinzugefügt. Anweisungen für die step-by-step Konsole finden Sie unterSchritt 2: Fügen Sie ein Testgerät hinzu.

AWS CLI

Verwenden Sie den create-verified-destination-number Befehl mit dem --rcs-agent-id Parameter, um ein Testgerät für Ihren AWS RCS Agent zu registrieren:

aws pinpoint-sms-voice-v2 create-verified-destination-number \
    --destination-phone-number +12065550100 \
    --rcs-agent-id rcs-a1b2c3d4
Anmerkung

Der Parameter --origination-identity ist nicht erforderlich. Wenn Sie angeben--rcs-agent-id, registriert der Befehl die Telefonnummer für RCS-Tests bei diesem Agenten. Wenn Sie es weglassen --rcs-agent-id und --origination-identity stattdessen verwenden, sendet der Befehl eine OTP-SMS zur SMS-Überprüfung. Die beiden Parameter schließen sich gegenseitig aus.

Ablauf der Einladungen für Tester

Nachdem Sie ein Testgerät hinzugefügt haben, sendet AWS End User Messaging eine Tester-Einladung von einem RCS-Agenten namens RBM Tester Management. Die Einladung enthält Schaltflächen zum Annehmen oder Ablehnen. Einzelheiten zum Ablauf der Tester-Einladungen, einschließlich der 120-Sekunden-Wartezeit und des iOS-spezifischen Verhaltens, finden Sie unter. Schritt 2: Fügen Sie ein Testgerät hinzu

Testgeräte anzeigen

Sie können die Testgeräte, die für Ihren AWS RCS Agent registriert sind, mithilfe der AWS End User Messaging-Konsole oder der DescribeVerifiedDestinationNumbers API anzeigen.

Console

Um Ihre registrierten Testgeräte in der Konsole anzuzeigen, navigieren Sie zur Detailseite für Ihren AWS RCS-Agenten und wählen Sie die Registerkarte Testen. Auf der Registerkarte werden alle verifizierten Zielnummern angezeigt, die dem Agenten zugeordnet sind, einschließlich ihres Bestätigungsstatus und ihrer Telefonnummer.

AWS CLI

Verwenden Sie den describe-verified-destination-numbers Befehl, um Testgeräte für Ihren AWS RCS Agent aufzulisten. Verwenden Sie den --filters Parameter withrcs-agent-id, um nur RCS-Testgeräte anzuzeigen:

aws pinpoint-sms-voice-v2 describe-verified-destination-numbers \
    --filters Name=rcs-agent-id,Values=rcs-a1b2c3d4

Testgeräte, die Sie für einen Testagenten registrieren, funktionieren global für diesen AWS RCS-Agenten. Ein in einer AWS Region registriertes Testgerät kann Testnachrichten empfangen, die aus jeder AWS Region gesendet werden, in der Ihr AWS RCS Agent verfügbar ist.

Senden von Testnachrichten

Nachdem ein Testgerät die Einladung des Testers akzeptiert hat, können Sie RCS-Nachrichten an dieses Gerät senden. Sie können Testnachrichten über die AWS End User Messaging-Konsole oder die SendTextMessage API senden.

Console
Um eine Testnachricht mit der Konsole zu senden

  1. Öffnen Sie die AWS End User Messaging-Konsole.

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

  3. Wählen Sie den AWS RCS Agent aus, den Sie testen möchten.

  4. Wählen Sie die Registerkarte Testen.

  5. Wählen Sie im Abschnitt Testnachricht senden ein verifiziertes Testgerät aus der Liste aus.

  6. Geben Sie Ihren Nachrichtentext ein.

  7. Wählen Sie Testnachricht senden.

AWS CLI

Verwenden Sie den send-text-message Befehl, um eine Testnachricht an eine verifizierte Zielnummer zu senden. Geben Sie den AWS-RCS-Agent-ARN als Ausgangsidentität an:

aws pinpoint-sms-voice-v2 send-text-message \
    --destination-phone-number +12065550100 \
    --origination-identity arn:aws:sms-voice:us-east-1:123456789012:rcs-agent/rcs-a1b2c3d4 \
    --message-body "Hello from RCS testing!"

SMS-Fallback wird getestet

Sie können das SMS-Fallback-Verhalten testen, um sicherzustellen, dass Ihre Nachrichten per SMS zugestellt werden, wenn eine RCS-Zustellung nicht möglich ist. Vollständige Anweisungen zum Testen von SMS-Fallback, einschließlich Tests ohne eine genehmigte SMS-Nummer und den vollständigen end-to-end Ablauf, finden Sie unter. SMS-Fallback testen

Problembehebung bei RCS-Tests

In den folgenden Abschnitten werden häufig auftretende Probleme beschrieben, die beim Testen von RCS-Meldungen auftreten können, und deren Behebung.

Das Testgerät empfängt keine RCS-Nachrichten

Wenn Ihr Testgerät keine RCS-Nachrichten empfängt, überprüfen Sie Folgendes:

  • Stellen Sie sicher, dass das Testgerät die Einladung des Testers akzeptiert hat. Verwenden Sie die DescribeVerifiedDestinationNumbers API mit dem rcs-agent-id Filter, um den Bestätigungsstatus des Geräts zu überprüfen.

  • Stellen Sie sicher, dass auf dem Testgerät RCS aktiviert ist. Überprüfen Sie auf Android die Einstellungen der Messaging-App für RCS- oder Chat-Funktionen. Auf dem iPhone benötigt RCS iOS 18 oder höher.

  • Stellen Sie sicher, dass das Testgerät über eine aktive Datenverbindung verfügt. RCS-Nachrichten werden über Daten und nicht über den SMS-Kanal zugestellt.

  • Stellen Sie sicher, dass Sie an die richtige Telefonnummer im E.164-Format senden.

Die Nachricht wurde als SMS statt als RCS zugestellt

Wenn Ihre Testnachricht als SMS statt als RCS zugestellt wird, überprüfen Sie Folgendes:

  • Stellen Sie sicher, dass Sie die Nachricht mit dem ARN des AWS RCS-Agenten oder einem Pool senden, der den AWS RCS-Agenten als Ausgangsidentität enthält. Wenn Sie nur eine SMS-Telefonnummer angeben, wird die Nachricht per SMS gesendet.

  • Stellen Sie sicher, dass das Testgerät die Einladung des Testers akzeptiert hat und als verifizierte Zielnummer für den richtigen AWS RCS-Agenten registriert ist.

  • Überprüfen Sie anhand des Zustellereignisses, ob die Nachricht ursprünglich über RCS versucht wurde und dann auf SMS zurückgegriffen wurde, oder ob sie direkt per SMS gesendet wurde.

Die Einladung des Testers wurde nicht erhalten

Wenn ein Testgerät die Einladung des Testers nicht erhält, überprüfen Sie Folgendes:

  • Es kann bis zu 20 Minuten dauern, bis die Tester-Einladung eingeht, nachdem ein Testgerät hinzugefügt wurde. Wenn die Einladung nach 20 Minuten nicht eingetroffen ist, entfernen Sie das Testgerät und fügen Sie es erneut hinzu.

  • Vergewissern Sie sich, dass die Telefonnummer das richtige E.164-Format hat und dass es sich um eine gültige Handynummer handelt.

  • Stellen Sie sicher, dass das Testgerät über eine aktive Datenverbindung verfügt und RCS aktiviert ist.

iOS: Tester-Einladung in Unknown Senders

Auf iOS-Geräten (iPhone mit iOS 18 oder höher) kann die Tester-Einladung von RBM Tester Management in den Ordner Unbekannte Absender in der Nachrichten-App gefiltert werden. Dies ist ein Standardverhalten von iOS für Nachrichten von unbekannten Kontakten.

Um die Einladung zu finden:

Um die Tester-Einladung auf iOS zu finden

  1. Öffnen Sie die Nachrichten-App auf dem iPhone.

  2. Tippe in der oberen linken Ecke auf Filter (oder wische in der Nachrichtenliste nach rechts).

  3. Tippe auf Unbekannte Absender.

  4. Suchen Sie nach der Nachricht von RBM Tester Management und tippen Sie auf Machen Sie mich zum Tester, um die Einladung anzunehmen.