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 Einladung des TestersTestgeräte anzeigenTestnachrichten sendenSMS-Fallback testenProblembehandlung beim RCS-Test

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-Agenten einreichen. Er bietet vollen API-Zugriff, der mit der Produktion identisch ist, beschränkt jedoch die Nachrichtenübermittlung nur auf registrierte Testgeräte. Zum Testen ist keine Genehmigung des Spediteurs erforderlich.

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

Wichtig

Testnachrichten werden zu RCS-Standardtarifen berechnet. Der Testagent stellt eine Testumgebung für die 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-Agenten einreichen. Der Testagent ermöglicht Ihnen:

  • Senden Sie RCS-Nachrichten ohne Genehmigung durch den Netzbetreiber 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 eine zugelassene SMS-Telefonnummer

Testgeräte, die Sie für einen Testagenten registrieren, funktionieren in allen Ländern für diesen AWS RCS-Agenten. Sie müssen 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 Länderregistrierung 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 auf der Unterregisterkarte RBM-Tester-Management auf der Registerkarte Testen Ihres AWS RCS-Agenten verwaltet. Eine schrittweise Anleitung zur Konsole finden Sie unter. Schritt 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 den RCS-Test 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 Einladung des Testers

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 Wartezeit von 120 Sekunden und des OS-specific Verhaltens von „i“, finden Sie unter. Schritt 2: Fügen Sie ein Testgerät hinzu

Testgeräte anzeigen

Sie können die für Ihren AWS RCS Agent registrierten Testgeräte über die AWS End User Messaging-Konsole oder die DescribeVerifiedDestinationNumbers API einsehen.

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. Wählen Sie die Unterregisterkarte RBM-Tester-Management, um alle verifizierten Zielnummern anzuzeigen, die dem Agenten zugeordnet sind, einschließlich des Bestätigungsstatus und der Telefonnummer.

AWS CLI

Verwenden Sie den describe-verified-destination-numbers Befehl, um Testgeräte für Ihren AWS RCS-Agenten 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 weltweit für diesen AWS RCS-Agenten. Ein in einer AWS Region registriertes Testgerät kann Testnachrichten aus jeder AWS Region empfangen, in der Ihr AWS RCS-Agent verfügbar ist.

Testnachrichten senden

Nachdem ein Testgerät die Einladung zum Tester angenommen 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-Agenten 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 ARN des AWS RCS Agents 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 testen

Sie können das SMS-Fallback-Verhalten testen, um sicherzustellen, dass Ihre Nachrichten per SMS zugestellt werden, wenn die RCS-Zustellung nicht möglich ist. Eine vollständige Anleitung zum Testen des SMS-Fallbacks, einschließlich des Testens ohne eine genehmigte SMS-Nummer und des gesamten Durchlaufs, finden Sie unter. SMS-Fallback wird getestet

Problembehandlung beim RCS-Test

In den folgenden Abschnitten werden häufig auftretende Probleme beschrieben, die beim Testen von RCS-Nachrichten 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 zugestellt, nicht über den SMS-Kanal.

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

Nachricht wird 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 AWS RCS Agent-ARN oder einem Pool senden, der den AWS RCS Agent als Absenderidentitä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 zum Tester akzeptiert hat und als verifizierte Zielnummer für den richtigen AWS RCS-Agenten registriert ist.

  • Überprüfen Sie das Zustellungsereignis, um festzustellen, ob die Nachricht ursprünglich über RCS versucht wurde und dann auf SMS zurückfiel, oder ob sie direkt per SMS gesendet wurde.

Die Einladung des Testers wurde nicht erhalten

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

  • Es kann bis zu 20 Minuten dauern, bis die Einladung zum Tester eintrifft, 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.

  • Stellen Sie sicher, dass die Telefonnummer das richtige E.164 Format hat und eine gültige Handynummer ist.

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

iOS: Einladung zum Tester in Unbekannte Absender

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 iOS-Standardverhalten für Nachrichten von unbekannten Kontakten.

Um die Einladung zu finden:

So findest du die Einladung zum Tester auf iOS

  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 Meldung RBM Tester Management und tippen Sie auf Zum Tester ernennen, um die Einladung anzunehmen.