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](rcs-sms-fallback.md)
**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 anrufen`DescribePools`, 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.
1. Wählen Sie im Navigationsbereich **Telefonpools** aus.
1. Wählen Sie **Pool erstellen**.
1. 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.
1. Konfigurieren Sie die Pooleinstellungen nach Bedarf und wählen Sie dann **Create** Pool aus.
1. 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](#phone-pool-rcs-config).
------
#### [ 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](#phone-pool-rcs-config)
------
#### [ 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.
1. Wählen Sie im Navigationsbereich **Telefonpools** aus.
1. Wählen Sie den Pool aus, zu dem Sie den AWS RCS-Agenten hinzufügen möchten.
1. Ü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.
1. Wählen Sie im Abschnitt **Originationsidentitäten** die Option Originationsidentität **hinzufügen** aus.
1. 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 angezeigt`ConflictException`, 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.
1. Aktualisieren Sie die Originationsidentität oder die Poolkonfiguration, sodass die Felder übereinstimmen.
1. Wiederholen Sie den Vorgang `AssociateOriginationIdentity` oder`CreatePool`.
**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.
1. Wählen Sie im Navigationsbereich **Telefonpools** aus.
1. Wählen Sie den Pool aus, der den AWS RCS-Agenten enthält, den Sie entfernen möchten.
1. Wählen Sie im Abschnitt **Origination Identities** den AWS RCS Agent aus.
1. 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`
------