View a markdown version of this page

Verwaltung von AWS RCS-Agenten in Pools - AWS SMS-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.

Verwaltung von AWS RCS-Agenten in Pools

Sie können einen AWS RCS-Agenten als Originationsidentität in einem Telefonpool neben Ihren SMS-Telefonnummern hinzufügen. Wenn ein Pool sowohl einen AWS RCS-Agenten als auch SMS-Telefonnummern enthält, versucht AWS End User Messaging zuerst die RCS-Zustellung und greift automatisch auf SMS zurück, wenn eine RCS-Zustellung nicht möglich ist. Einzelheiten zur Funktionsweise von Fallback finden Sie unter. Fallback von RCS zu SMS mithilfe von Telefonpools

Anmerkung

Wenn Sie einen AWS RCS-Agenten zu einem Pool hinzufügen, verwenden Sie ZZ ihn als ISO-Ländercode. Der ZZ Code gibt an, dass der RCS-Agent auf Poolebene nicht länderspezifisch ist. Das landesspezifische Routing wird über die landesspezifischen Startregistrierungen des Agenten abgewickelt. Ein Pool kann neben dem RCS-Agenten auch Telefonnummern aus mehreren Ländern enthalten.

Der ISO-Ländercode wird bei der Erstellung des Pools bereitgestellt, aber nicht dauerhaft im Pool gespeichert. Wenn Sie anrufenDescribePools, erscheint der ISO-Ländercode nicht in der Antwort.

Einen Pool mit einem AWS RCS-Agenten erstellen

Sie können mithilfe der AWS End User Messaging-Konsole oder der CreatePool API einen neuen Pool erstellen, der Ihren AWS RCS-Agenten enthält.

Console
So erstellen Sie mithilfe der Konsole einen Pool mit einem AWS RCS-Agenten
  1. Öffnen Sie die AWS End User Messaging-Konsole.

  2. Wählen Sie im Navigationsbereich Telefonpools aus.

  3. Wählen Sie Pool erstellen.

  4. Wählen Sie für Origination Identity Ihren AWS RCS Agent aus. Der Pool erbt seine Konfiguration von der von Ihnen ausgewählten Originationsidentität.

  5. Konfigurieren Sie die Pooleinstellungen nach Bedarf und wählen Sie dann Create Pool aus.

  6. Nachdem der Pool erstellt wurde, fügen Sie dem Pool Ihre SMS-Telefonnummern hinzu, um SMS-Fallback zu aktivieren. Alle Originationsidentitäten im Pool müssen eine passende Konfiguration haben. Details hierzu finden Sie unter Anforderungen an die Pool-Konfiguration für RCS.

AWS CLI

Verwenden Sie die CreatePool API, um einen Pool mit Ihrem AWS RCS-Agenten als ursprüngliche Originationsidentität zu erstellen. Geben Sie bei der Erstellung des Pools den ARN des AWS RCS-Agenten als Originationsidentität an.

Das folgende Beispiel erstellt einen Pool mit der AWS CLI:

aws pinpoint-sms-voice-v2 create-pool \ --origination-identity arn:aws:sms-voice:region:account-id:rcs-agent/rcs-agent-id \ --iso-country-code ZZ \ --message-type TRANSACTIONAL

Nachdem der Pool erstellt wurde, verwenden Sie die AssociateOriginationIdentity API, um dem Pool SMS-Telefonnummern als Fallback hinzuzufügen.

Hinzufügen von AWS RCS-Agenten zu vorhandenen Pools

Wenn Sie bereits über einen Pool mit SMS-Telefonnummern verfügen, können Sie Ihren AWS RCS-Agenten zum Pool hinzufügen, um RCS-Messaging mit SMS-Fallback zu aktivieren. Sie können einem Pool, der bereits einen AWS RCS-Agenten enthält, auch zusätzliche SMS-Telefonnummern hinzufügen.

Wichtig

Bevor Sie einem vorhandenen Pool eine Originationsidentität hinzufügen, stellen Sie sicher, dass die Konfiguration des Pools mit der Identität übereinstimmt, die Sie hinzufügen. Alle Originationsidentitäten in einem Pool müssen identische Metadaten haben. Liegt eine Nichtübereinstimmung vor, schlägt der Vorgang mit einer fehl. ConflictException Weitere Informationen darüber, welche Felder übereinstimmen müssen und wie Diskrepanzen behoben werden können, finden Sie unter. Anforderungen an die Pool-Konfiguration für RCS

Console

Bevor Sie mithilfe der Konsole einen AWS RCS-Agenten zu einem Pool hinzufügen, überprüfen Sie die Pool-Detailseite, um die aktuelle Konfiguration zu überprüfen. Vergewissern Sie sich, dass der Nachrichtentyp, der ISO-Ländercode und andere Einstellungen des Pools mit dem AWS RCS-Agenten kompatibel sind, den Sie hinzufügen möchten.

So fügen Sie mithilfe der Konsole einen AWS RCS-Agenten zu einem vorhandenen Pool hinzu
  1. Öffnen Sie die AWS End User Messaging-Konsole.

  2. Wählen Sie im Navigationsbereich Telefonpools aus.

  3. Wählen Sie den Pool aus, zu dem Sie den AWS RCS-Agenten hinzufügen möchten.

  4. Überprüfen Sie die Konfiguration des Pools auf der Detailseite. Vergewissern Sie sich, dass der Nachrichtentyp und andere Einstellungen mit dem AWS RCS-Agenten übereinstimmen, den Sie hinzufügen möchten.

  5. Wählen Sie im Abschnitt Originationsidentitäten die Option Originationsidentität hinzufügen aus.

  6. Wählen Sie Ihren AWS RCS-Agenten aus der Liste aus und klicken Sie auf Hinzufügen.

AWS CLI

Bevor Sie einen AWS RCS-Agenten mithilfe der CLI oder API zu einem Pool hinzufügen, verwenden Sie die DescribePools API, um die aktuelle Konfiguration des Pools abzurufen. Stellen Sie sicher, dass die Einstellungen des Pools mit dem AWS RCS-Agenten übereinstimmen, den Sie hinzufügen möchten.

Im folgenden Beispiel werden Pooldetails abgerufen:

aws pinpoint-sms-voice-v2 describe-pools \ --pool-ids pool-id

Nachdem Sie bestätigt haben, dass die Konfiguration übereinstimmt, verwenden Sie die AssociateOriginationIdentity API, um den AWS RCS-Agenten zum Pool hinzuzufügen:

aws pinpoint-sms-voice-v2 associate-origination-identity \ --pool-id pool-id \ --origination-identity arn:aws:sms-voice:region:account-id:rcs-agent/rcs-agent-id \ --iso-country-code ZZ

Anforderungen an die Pool-Konfiguration für RCS

Alle Originationsidentitäten in einem Pool müssen identische Metadaten haben. Wenn Sie einem Pool eine Originationsidentität hinzufügen, vergleicht AWS End User Messaging die Konfiguration der Identität mit der vorhandenen Konfiguration des Pools. Liegt eine Nichtübereinstimmung vor, schlägt der Vorgang fehl und es wird eine Meldung angezeigtConflictException, die Details zu den einzelnen Feldern enthält, die sich unterscheiden.

Pool-Konfigurationsfelder lassen sich in zwei Kategorien einteilen: unveränderliche Felder, die bei der Erstellung des Pools festgelegt werden und nicht geändert werden können, und veränderbare Felder, die Sie nach der Erstellung aktualisieren können.

Unveränderliche und veränderbare Pool-Konfigurationsfelder
Feld Veränderlichkeit Hinweise
Nachrichtentyp Immutable (Unveränderlich) Wird bei der Poolerstellung festgelegt. Alle Identitäten müssen übereinstimmen.
ISO-Ländercode Immutable (Unveränderlich) Wird bei der Poolerstellung festgelegt. Für AWS RCS-Agenten ist ZZ der Wert. Pools können Telefonnummern aus mehreren Ländern enthalten.
Löschschutz Mutable Kann nach der Erstellung umgeschaltet werden. Muss identitätsübergreifend konsistent sein.
Opt-Out-Liste Mutable Kann nach der Erstellung geändert werden. Muss identitätsübergreifend konsistent sein.

Die folgenden Konfigurationsfelder müssen für alle Originationsidentitäten in einem Pool übereinstimmen:

  • Nachrichtentyp — Alle Identitäten müssen für denselben Nachrichtentyp konfiguriert sein (z. B. TRANSACTIONAL oder PROMOTIONAL).

  • ISO-Ländercode — Wird bei der Poolerstellung festgelegt. Verwenden Sie für AWS ZZ RCS-Agenten den ISO-Ländercode. Pools können Telefonnummern aus mehreren Ländern enthalten.

  • Löschschutz — Die Einstellung für den Löschschutz muss identitätsübergreifend einheitlich sein.

  • Opt-Out-Liste — Alle Identitäten müssen derselben Opt-Out-Liste zugeordnet sein, andernfalls sollte keine von ihnen über eine Opt-Out-Liste verfügen.

Fehler verstehen ConflictException

Wenn Sie versuchen, einem Pool eine Originationsidentität hinzuzufügen und die Konfiguration nicht übereinstimmt, gibt die CreatePool API AssociateOriginationIdentity oder a ConflictException zurück. Die Ausnahmemeldung enthält Details darüber, welche Felder sich zwischen der Identität und dem Pool unterscheiden.

Wenn Sie beispielsweise versuchen, eine für WERBEBOTSCHAFTEN konfigurierte Telefonnummer zu einem Pool hinzuzufügen, der für TRANSAKTIONSNACHRICHTEN konfiguriert ist, weist die Fehlermeldung darauf hin, dass der Nachrichtentyp nicht übereinstimmt.

Um ein Problem zu lösen: ConflictException

  1. Überprüfen Sie die Fehlermeldung, um festzustellen, welche Felder sich unterscheiden.

  2. Aktualisieren Sie die Originationsidentität oder die Poolkonfiguration, sodass die Felder übereinstimmen.

  3. Wiederholen Sie den Vorgang AssociateOriginationIdentity oderCreatePool.

Anmerkung

Wenn Sie den Konfigurationskonflikt nicht beheben können, sollten Sie erwägen, einen separaten Pool für die ursprüngliche Identität zu erstellen. Jeder Pool kann seine eigene Konfiguration haben, und Sie können verschiedene Pools für unterschiedliche Anwendungsfälle verwenden.

Entfernen von AWS RCS-Agenten aus Pools

Sie können einen AWS RCS-Agenten mithilfe der AWS End User Messaging-Konsole oder der DisassociateOriginationIdentity API aus einem Pool entfernen. Wenn Sie einen AWS RCS-Agenten aus einem Pool entfernen, wird die RCS-Zustellung für Nachrichten, die über diesen Pool gesendet werden, deaktiviert. Nachrichten, die nach dem Entfernen des Agenten an den Pool gesendet werden, werden nur per SMS zugestellt (unter Verwendung der verbleibenden Telefonnummern im Pool).

Console
So entfernen Sie einen AWS RCS-Agenten mithilfe der Konsole aus einem Pool
  1. Öffnen Sie die AWS End User Messaging-Konsole.

  2. Wählen Sie im Navigationsbereich Telefonpools aus.

  3. Wählen Sie den Pool aus, der den AWS RCS-Agenten enthält, den Sie entfernen möchten.

  4. Wählen Sie im Abschnitt Origination Identities den AWS RCS Agent aus.

  5. Wählen Sie Entfernen und bestätigen Sie dann das Entfernen.

AWS CLI

Verwenden Sie die DisassociateOriginationIdentity API, um einen AWS RCS-Agenten aus einem Pool zu entfernen:

aws pinpoint-sms-voice-v2 disassociate-origination-identity \ --pool-id pool-id \ --origination-identity arn:aws:sms-voice:region:account-id:rcs-agent/rcs-agent-id \ --iso-country-code ZZ

Nach dem Entfernen des AWS RCS-Agenten werden Nachrichten, die über den Pool gesendet werden, nur per SMS zugestellt. Um die RCS-Lieferung wieder zu aktivieren, fügen Sie den AWS RCS-Agenten mithilfe der API wieder zum Pool hinzu. AssociateOriginationIdentity