View a markdown version of this page

Verwaltung von RCS-Agenten - AWS SMS-Nachrichten für Endbenutzer
Den AWS RCS-Agenten verstehenDas zweistufige Identitätsmodell verstehenEinen AWS RCS-Agenten erstellenAktualisierung eines AWS RCS-AgentenAWS RCS-Agenten anzeigenÜberprüfen Sie Ihren TestagentenStatus der Markteinführung im Land anzeigenLöschen eines AWS RCS-Agenten

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.

Verwaltung von RCS-Agenten

Ein AWS RCS-Agent ist die wichtigste Ressource im Bereich AWS End User Messaging, die Ihre Marke für RCS-Messaging repräsentiert. Er dient als einheitliche Ressource, die Ihren Testagenten und Ihre Country Launch Agents (RCS for Business) zusammenhält. IDs Schlüsselwörter und bidirektionale Nachrichtenkonfiguration werden auf dem AWS RCS Agent definiert. Die Markenwerte werden bei jeder Registrierung (Testagent oder Country-Launch-Agent) definiert. Einen Überblick darüber, wie der AWS RCS Agent mit RCS for Business zusammenhängt IDs, finden Sie unter. Was ist RCS?

Der AWS RCS Agent folgt diesem Lebenszyklus:

  1. Erstellen Sie den AWS RCS-Agenten.

  2. Fügen Sie einen Testagenten hinzu (im Erstellungsablauf der Konsole enthalten; optional über CLI).

  3. Testen Sie Ihr RCS-Messaging mit registrierten Testgeräten. Für die Tests ist keine Genehmigung durch den Mobilfunkanbieter erforderlich.

  4. Reichen Sie für jedes Land, in das Sie RCS-Produktionsnachrichten senden möchten, eine Registrierung für die Markteinführung des Landes ein.

  5. Teilweise genehmigt: Mindestens ein Transporteur hat Ihren Agenten zugelassen. Sie können damit beginnen, an Empfänger zugelassener Transporteure zu senden.

  6. Vollständig genehmigt: Alle Spediteure im Land haben Ihren Agenten zugelassen. Volle Reichweite in diesem Land.

Ein AWS RCS-Agent ist einem Testagenten (ein RCS für Business ID) sowie mehreren Länderstartagenten (ein RCS für Business ID pro Land) zugeordnet. Wenn Sie einen AWS RCS-Agenten in der Konsole erstellen, führt Sie der Workflow sofort zur Erstellung eines Testagenten. Die Markenkonfiguration des Testagenten wird dann verwendet, um Registrierungsformulare für die Markteinführung von Ländern vorab auszufüllen, wodurch doppelte Dateneingaben vermieden werden.

Den AWS RCS-Agenten verstehen

Der AWS RCS Agent unterscheidet sich von dem RCS for Business IDs , das er verwaltet. In der folgenden Tabelle sind die Unterschiede zusammengefasst:

AWS RCS Agent im Vergleich zu RCS for Business ID
Attribut AWS-RCS-Agent RCS für Geschäfts-ID
Verwaltet von Sie, über die AWS End User Messaging-Konsole oder API AWS Endbenutzer-Nachrichten während des Registrierungsprozesses
Scope Eine pro Marke oder pro Anwendungsfall Einer pro Markteinführung in einem Land plus ein Testagent
Konfiguration Benutzerfreundlicher Name, Löschschutz, Abmeldeliste, Stichwörter, Zieladresse für bidirektionales Versenden Markeninhalte und andere Einstellungen, die bei der Registrierung definiert wurden
Kennung rcs-a1b2c3d4-Format Wird intern vom RCS-Infrastrukturanbieter verwaltet

Agenten-ID und ARN

Jeder AWS RCS-Agent hat eine eindeutige Kennung im Format rcs-a1b2c3d4 (das Präfix, rcs- gefolgt von einer hexadezimalen Zeichenfolge). Sie verwenden diese ID, wenn Sie API-Operationen wie und aufrufen. UpdateRcsAgent DeleteRcsAgent

Jeder AWS RCS-Agent hat auch einen AWS Ressourcen-ARN im folgenden Format:

arn:aws:sms-voice:region:account-id:rcs-agent/rcs-agent-id

Sie können den ARN verwenden, wenn Sie den AWS RCS-Agenten als Originationsidentität in der SendTextMessage API angeben oder wenn Sie den Agenten zu einem Telefonpool hinzufügen.

Lebenszyklusstati

Ein AWS RCS-Agent durchläuft die folgenden Lebenszyklusstatus:

ERSTELLT

Die AWS RCS Agent-Ressource wurde in AWS End User Messaging erstellt, aber es wurde noch keine Registrierung eingereicht. In diesem Status können Sie Marken-Assets und die Konfiguration aktualisieren.

PENDING

Eine Registrierung wurde eingereicht und wartet auf ihre Bearbeitung. Der Agent ist noch nicht für das Senden von Nachrichten verfügbar.

WIR TESTEN

Die Testregistrierung wurde genehmigt. Der Agent verfügt über einen Testagenten (RCS for Business ID) und kann Nachrichten an registrierte Testgeräte senden. Es wurden keine Registrierungen für die Markteinführung eines Landes abgeschlossen.

TEILWEISE

Die Registrierung für mindestens eine Ländereinführung wurde abgeschlossen, aber nicht alle eingereichten Ländereinführungen sind aktiv. Der Agent kann Nachrichten in Ländern senden, in denen er genehmigt wurde, aber nur an Empfänger der jeweiligen Mobilfunkanbieter, die den Agenten genehmigt haben. Der CountryStatus für ein Land wird auf PARTIAL umgestellt, sobald mindestens ein Mobilfunkanbieter in diesem Land aktiv ist.

ACTIVE

Alle eingereichten Registrierungen für die Markteinführung eines Landes sind vollständig und aktiv. Der Agent ist in allen registrierten Ländern voll funktionsfähig. Beachten Sie, dass ein AKTIV-Agent in den Status PARTIAL zurückkehren kann, wenn eine Registrierung für die Markteinführung eines neuen Landes eingereicht wird, da das neue Land noch nicht zugelassen ist.

GELÖSCHT

Der AWS RCS-Agent wurde gelöscht. Alle zugehörigen RCS for Business IDs (Test- und Country-Launch-Agenten) sind deaktiviert. Diese Aktion kann nicht rückgängig gemacht werden.

Das zweistufige Identitätsmodell verstehen

RCS in AWS End User Messaging verwendet ein zweistufiges Identitätsmodell: den AWS RCS Agent und ein oder mehrere RCS for Business. IDs

AWS-RCS-Agent

Der AWS RCS Agent ist die Ressource der obersten Ebene, die Sie in AWS End User Messaging erstellen und verwalten. Er dient als einheitliche Ressource, die Ihren Testagenten und die für das jeweilige Land zuständigen Mitarbeiter zusammenhält. Schlüsselwörter und bidirektionale Nachrichtenkonfiguration werden auf dem AWS RCS Agent definiert. Markenwerte werden bei jeder Registrierung definiert. Jeder AWS RCS-Agent hat eine eindeutige Kennung im Format rcs-a1b2c3d4 und einen AWS Ressourcen-ARN. Stellen Sie sich den AWS RCS Agent als einheitliche Identität für Ihre Marke in allen Ländern vor, in denen Sie RCS einführen.

RCS für Business ID

Eine RCS for Business ID ist die länderspezifische Agentenidentität, die während des Registrierungsprozesses beim RCS-Infrastrukturanbieter erstellt wird. Bei jeder Markteinführung in einem Land wird eine separate RCS for Business ID unter Ihrem AWS RCS-Agenten erstellt. Sie verwalten RCS for Business nicht direkt. IDs AWS End User Messaging kümmert sich im Rahmen des Registrierungsprozesses um die Erstellung und den Lebenszyklus.

Ein AWS RCS-Agent kann über das folgende RCS for Business verfügen: IDs

  • Ein Testagent — Eine RCS for Business ID, die während der Testregistrierungsphase erstellt wurde. Der Testagent arbeitet mit registrierten Testgeräten und ermöglicht es Ihnen, Ihre RCS-Integration zu validieren, bevor Sie sie in der Produktion starten. Testnachrichten werden zu Standardpreisen berechnet.

  • Launch Agents in mehreren Ländern — Jedes Land, in dem Sie RCS starten, erstellt ein eigenes RCS for Business ID. Wenn Sie beispielsweise sowohl in den Vereinigte Staaten als auch in Kanada starten, verfügt Ihr AWS RCS-Agent zusätzlich zum Testagenten über zwei länderspezifische Launch Agents (einen US RCS für Business ID und einen Kanada RCS für Business ID).

Das folgende Diagramm zeigt die Beziehung zwischen diesen Identitäten:


AWS RCS Agent (rcs-a1b2c3d4)
├── Testing agent (RCS for Business ID)
├── US country launch agent (US RCS for Business ID)
└── CA country launch agent (Canada RCS for Business ID)

Schlüsselwörter und bidirektionale Messaging-Ziele werden auf dem AWS RCS Agent konfiguriert und gelten für alle zugehörigen RCS for Business. IDs Die Markenressourcen sind für jede Registrierung spezifisch (Testagent oder Country-Launch Agent). Der AWS RCS Agent enthält auch Einstellungen auf Kontoebene wie den Anzeigenamen, den Löschschutz und die Opt-Out-Liste.

Einen AWS RCS-Agenten erstellen

Sie können einen AWS RCS-Agenten mithilfe der AWS End User Messaging-Konsole oder der CreateRcsAgent API erstellen. Wenn Sie einen Agenten erstellen, geben Sie in der Konsole einen benutzerfreundlichen Namen ein (ein Etikett, das nur für die Konsole bestimmt ist und als Tag gespeichert wird, nicht über die API sichtbar ist oder auf den Telefonen der Empfänger angezeigt wird) und optionale Einstellungen wie den Löschschutz und die Zuordnung von Opt-Out-Listen konfigurieren. Marken-Assets werden bei der Registrierung definiert, nicht auf dem AWS RCS Agent selbst.

Anforderungen an Marken-Assets

Ihre Markeninhalte werden den Empfängern zusammen mit Ihren RCS-Nachrichten angezeigt. Markeninhalte werden im Rahmen der Testregistrierung eingereicht, die in der Konsole als Fortsetzung des Workflows zur Agentenerstellung angezeigt wird. Die folgenden Ressourcen sind für die Erstellung eines AWS RCS-Agenten erforderlich:

Logo

Ein quadratisches Bild, das Ihre Marke repräsentiert. Das Logo erscheint in der Messaging-App neben Ihren Nachrichten.

  • Abmessungen: 224 × 224 Pixel

  • Format: PNG mit Transparenz

  • Maximale Dateigröße: 50 KB

Banner-Bild

Ein breites Bild, das oben im Profil Ihres Agenten in der Messaging-App angezeigt wird. Das Bannerbild wird nur auf Android-Geräten angezeigt.

  • Abmessungen: 1440 × 448 Pixel

  • Format: PNG oder JPEG

  • Maximale Dateigröße: 200 KB

Farbe der Marke

Ein Hex-Farbcode (z. B.#1A73E8), der in der Messaging-App als Akzentfarbe verwendet wird. Die Farbe muss ein Mindestkontrastverhältnis von 4, 5:1 vor einem weißen Hintergrund aufweisen, um die Barrierefreiheit zu erfüllen. Wenn das Kontrastverhältnis nicht richtig eingestellt ist, wird Ihr Agent möglicherweise nicht zugelassen.

Wichtig

Marken-Assets können nach der Erstellung des Agenten nur eingeschränkt geändert werden. Einige Markeninhalte können nicht mehr geändert werden, sobald der Agent zur Registrierung eingereicht wurde. Bereiten Sie Ihre endgültigen Markenressourcen vor, bevor Sie Ihren AWS RCS Agent erstellen.

Console

Die AWS End User Messaging-Konsole präsentiert die Erstellung und Testregistrierung von AWS RCS-Agenten in einem einzigen geführten Workflow. Anweisungen zur step-by-step Konsole finden Sie unterSchritt 1: Erstellen Sie Ihren AWS RCS-Agenten und reichen Sie eine Testregistrierung ein.

AWS CLI

Verwenden Sie den create-rcs-agent Befehl, um einen AWS RCS-Agenten zu erstellen. Markenelemente (Anzeigename, Beschreibung, Logo, Banner und Markenfarbe) sind keine Parameter dieses Befehls. Sie werden als Registrierungsfelder übermittelt, wenn Sie eine Testregistrierung erstellen.

aws pinpoint-sms-voice-v2 create-rcs-agent \
    --deletion-protection-enabled

Die folgenden optionalen Parameter sind verfügbar:

  • --deletion-protection-enabled— Verhindert, dass der Agent gelöscht wird, bis der Löschschutz deaktiviert ist.

  • --opt-out-list-name— Ordnet dem Agenten eine bestehende Opt-Out-Liste zu.

  • --tags— Schlüssel-Wert-Paare zur Organisation und Identifizierung Ihres AWS RCS-Agenten.

Aktualisierung eines AWS RCS-Agenten

Verwenden Sie die UpdateRcsAgent API, um die Einstellungen eines vorhandenen AWS RCS-Agenten zu ändern. Sie können die folgenden Einstellungen aktualisieren:

  • Löschschutz — Aktiviert oder deaktiviert den Löschschutz für den Agenten.

  • Opt-Out-Liste — Ordnen Sie dem Agenten eine Opt-Out-Liste zu oder trennen Sie die Verknüpfung.

  • Ziel für bidirektionale Nachrichtenübermittlung — Konfigurieren Sie das Amazon SNS SNS-Thema und die IAM-Rolle, an die eingehende Nachrichten zugestellt werden. Bidirektionales Messaging ist für RCS immer aktiviert. Den Kunden werden alle eingehenden RCS-Nachrichten zu Standardtarifen in Rechnung gestellt. Diese Einstellung steuert, wohin eingehende Nachrichten zugestellt werden, nicht, ob sie empfangen werden.

Anmerkung

Änderungen an Ihren AWS RCS Agent-Einstellungen über die API sind sofort verfügbar. Aktualisierungen der Markenressourcen (Registrierungsfelder wie Logo, Banner und Anzeigename) werden jedoch vom RCS-Infrastrukturanbieter geprüft und es kann einige Zeit dauern, bis sie auf den Geräten der Empfänger angezeigt werden. Um zu überprüfen, ob Ihre API-Änderungen übernommen wurden, verwenden Sie die DescribeRcsAgents API, um die aktuelle Agentenkonfiguration in AWS End User Messaging zu bestätigen.

AWS RCS-Agenten anzeigen

Sie können Ihre AWS RCS-Agenten über die AWS End User Messaging-Konsole oder die DescribeRcsAgents API anzeigen.

Console

Um Ihre AWS RCS-Agenten in der Konsole anzuzeigen, navigieren Sie im Navigationsbereich unter Konfigurationen zur Seite RCS-Agenten. Auf der Listenseite werden alle AWS RCS-Agenten in Ihrem Konto angezeigt, einschließlich ihres aktuellen Lebenszyklusstatus, ihrer Agenten-ID und ihres Anzeigenamens.

Wählen Sie einen Agenten aus, um dessen Details, einschließlich Markenressourcen, Konfigurationseinstellungen und zugehörigen Registrierungen, einzusehen.

AWS CLI

Verwenden Sie den describe-rcs-agents Befehl, um alle AWS RCS-Agenten in Ihrem Konto aufzulisten:

aws pinpoint-sms-voice-v2 describe-rcs-agents

Verwenden Sie den folgenden --rcs-agent-ids Parameter, um Details für einen bestimmten Agenten abzurufen:

aws pinpoint-sms-voice-v2 describe-rcs-agents \
    --rcs-agent-ids rcs-a1b2c3d4

Überprüfen Sie Ihren Testagenten

Bevor Sie eine Registrierung für die Markteinführung eines Landes einreichen, überprüfen Sie die Konfiguration Ihres Testagenten, um sicherzustellen, dass Ihre Markeninhalte, Keywords und Messaging-Einstellungen korrekt sind. Der Testagent dient als Vorlage für Registrierungen zur landesspezifischen Markteinführung. Daher sollten alle Probleme gelöst werden, bevor Sie fortfahren.

Um Ihren Testagenten zu überprüfen, navigieren Sie in der AWS End User Messaging-Konsole zu Ihrem AWS RCS-Agenten und wählen Sie den Tab Registrierungen. Die Testregistrierung zeigt Ihre aktuelle Markenkonfiguration, einschließlich des Logos, des Bannerbilds, der Markenfarbe und des Anzeigenamens, so wie sie auf den Geräten der Empfänger erscheinen.

Sie können die DescribeRegistrationFieldValues API auch verwenden, um die aktuellen Feldwerte für Ihre Testregistrierung programmgesteuert abzurufen.

Status der Markteinführung im Land anzeigen

Nachdem Sie eine Länderstartregistrierung für Ihren AWS RCS-Agenten eingereicht haben, können Sie den Genehmigungsstatus für jeden Transporteur in diesem Land verfolgen.

Console

Um den Länderstartstatus in der Konsole einzusehen, navigieren Sie zur Detailseite für Ihren AWS RCS-Agenten und wählen Sie die Registerkarte Länderstartstatus. Auf dieser Registerkarte wird der Genehmigungsstatus für jeden Transporteur in jedem Land angezeigt, in dem Sie eine Startregistrierung eingereicht haben.

AWS CLI

Verwenden Sie den describe-rcs-agent-country-launch-status Befehl, um den Startstatus pro Mobilfunkanbieter abzurufen:

aws pinpoint-sms-voice-v2 describe-rcs-agent-country-launch-status \
    --rcs-agent-id rcs-a1b2c3d4

Die Antwort enthält den Genehmigungsstatus für jeden Mobilfunkanbieter in jedem Land, in dem Sie eine Startregistrierung eingereicht haben.

Jeder Transporteur überprüft und genehmigt Ihren Agenten unabhängig. Ihr AWS RCS-Agent kann Nachrichten in einem Land versenden, sobald mindestens ein Transporteur in diesem Land den Agenten zugelassen hat. Sie müssen nicht warten, bis alle Transporteure die Genehmigung erteilt haben, bevor Sie mit dem Senden von RCS-Nachrichten beginnen können. Je mehr Transporteure Ihren Agenten genehmigen, desto größer wird Ihre Reichweite in diesem Land.

Anmerkung

Auf dem Bildschirm mit dem Status des jeweiligen Landes können Sie weitere Markteinführungen in verschiedenen Ländern beantragen. Für jede Markteinführung eines neuen Landes ist eine separate Registrierung erforderlich und es wird ein eigenes Genehmigungsverfahren durch den jeweiligen Mobilfunkanbieter durchlaufen.

Löschen eines AWS RCS-Agenten

Verwenden Sie die DeleteRcsAgent API, um einen AWS RCS-Agenten dauerhaft zu löschen. Wenn Sie einen Agenten löschen, werden alle zugehörigen RCS for Business IDs (einschließlich des Testagenten und aller Ländereinführungsagenten) deaktiviert.

Warnung

Das Löschen eines AWS RCS-Agenten ist dauerhaft und kann nicht rückgängig gemacht werden. Alle Registrierungen, Ländereinführungen und Testkonfigurationen, die mit dem Agenten verknüpft sind, gehen verloren.

Bevor Sie einen AWS RCS-Agenten löschen können, müssen Sie zuerst alle zugehörigen Registrierungen (sowohl Testregistrierungen als auch Ländereinführungsregistrierungen) löschen und dann den Löschschutz deaktivieren. Wenn der Löschschutz aktiviert ist, gibt die DeleteRcsAgent API einen Fehler zurück. Um den Löschschutz zu deaktivieren, verwenden Sie die UpdateRcsAgent API mit aktiviertem Löschschutzfalse.

So löschen Sie einen AWS RCS-Agenten

  1. Wenn der Löschschutz aktiviert ist, deaktivieren Sie ihn, indem Sie die UpdateRcsAgent API aufrufen, wobei der Löschschutz auf false eingestellt ist.

  2. Rufen Sie die DeleteRcsAgent API mit der Agenten-ID oder dem ARN des AWS RCS-Agenten auf, den Sie löschen möchten.

  3. Stellen Sie sicher, dass der Agent gelöscht wurde, indem Sie die DescribeRcsAgents API aufrufen. Der Agent sollte nicht mehr in den Ergebnissen erscheinen, oder sein Status sollte GELÖSCHT lauten.