**Hinweis zum Ende des Supports:** Am 30. Oktober 2026 AWS wird der Support für Amazon Pinpoint eingestellt. Nach dem 30. Oktober 2026 können Sie nicht mehr auf die Amazon-Pinpoint-Konsole oder die Amazon-Pinpoint-Ressourcen (Endpunkte, Segmente, Kampagnen, Journeys und Analytik) zugreifen. Weitere Informationen finden Sie unter [Ende des Amazon-Pinpoint-Supports](https://docs.aws.amazon.com/console/pinpoint/migration-guide). **Hinweis:** APIs In Bezug auf SMS sind Sprach-, mobile Push-, OTP- und Telefonnummernvalidierung von dieser Änderung nicht betroffen und werden von AWS End User Messaging unterstützt.
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.
# Verwenden Sie den Service zur Überprüfung von Telefonnummern von Amazon Pinpoint
Amazon Pinpoint enthält einen Service zur Telefonnummernüberprüfung, mit dem Sie ermitteln können, ob eine Telefonnummer gültig ist. Außerdem können Sie weitere Informationen über die Telefonnummer abrufen. Wenn Sie den Service zur Telefonnummernüberprüfung verwenden, gibt er folgende Informationen zurück:
+ Telefonnummer im E.164-Format.
+ Telefonnummerntyp (z. B. mobil, Festnetz oder VoIP).
+ Stadt und Land , aus der die Telefonnummer stammt.
+ Der für die Telefonnummer zuständige Dienstanbieter.
Für die Nutzung des Services zur Telefonnummernüberprüfung fällt eine zusätzliche Gebühr an. Weitere Informationen finden Sie unter [Amazon-Pinpoint – Preise](https://aws.amazon.com/pinpoint/pricing/#Phone_Number_Validate).
**Wichtig**
Bei Telefonnummern mit Ursprung in den Vereinigten Staaten und Kanada gibt die API zur Überprüfung von Telefonnummern keine Daten mehr für `City`, `County`, `Timezone` und `ZipCode` zurück.
## Anwendungsfälle für die Überprüfung von Telefonnummern mit Amazon Pinpoint
Sie können den Service zur Telefonnummernüberprüfung für unterschiedliche Anwendungsfälle nutzen, z. B.:
+ **Überprüfung der in einem Webformular angegebenen Telefonnummern**: Wenn Sie webbasierte Formulare verwenden, um Kontaktinformationen für Ihre Kunden zu sammeln, überprüfen Sie die von den Kunden angegebenen Telefonnummern, bevor Sie das Formular absenden. Verwenden Sie das Backend der Website, um die Telefonnummern mithilfe der Amazon Pinpoint-API zu überprüfen. In der API-Antwort wird angegeben, ob die Nummer ungültig ist, z. B. wenn die Telefonnummer falsch formatiert ist. Wenn Sie ermitteln, dass die vom Kunden angegebene Telefonnummer ungültig ist, kann das Web-Formular den Kunden auffordern, die Telefonnummer zu korrigieren.
+ **Bereinigen Ihrer vorhandenen Kontaktdatenbank**: Wenn Sie über eine Datenbank mit Kunden-Telefonnummern verfügen, können Sie jede Telefonnummer überprüfen und dann Ihre Datenbank auf der Grundlage Ihrer Ergebnisse aktualisieren. Wenn Sie beispielsweise Endpunkte mit Telefonnummern finden, die keine SMS-Nachrichten empfangen können, können Sie die Eigenschaft `ChannelType` des Endpunkts von `SMS` in `VOICE` ändern. Sie können zuerst die Telefonnummer überprüfen und dann die `ChannelType`-Eigenschaft für neue oder bestehende Endpunkte aktualisieren, indem Sie den Anweisungen in [Endpunkte zu Amazon Pinpoint hinzufügen](audience-define-endpoints.md) für einen einzelnen Endpunkt oder in [Eine Reihe von Endpunkten zu Amazon Pinpoint hinzufügen](audience-define-endpoints-batch.md) für mehrere Endpunkte folgen.
+ **Auswählen des richtigen Kanals, bevor Sie eine Nachricht senden**: Wenn Sie eine SMS-Nachricht senden möchten, aber feststellen, dass die Zieltelefonnummer ungültig ist, können Sie die Nachricht über einen anderen Channel an den Empfänger senden. Wenn der Endpunkt beispielsweise keine SMS-Nachrichten empfangen kann, können Sie stattdessen eine Sprachnachricht senden.
## Validieren Sie eine Telefonnummer mit dem AWS CLI
Das folgende Beispiel zeigt, wie Sie eine Telefonnummer mit dem validieren AWS CLI. Weitere Informationen finden Sie unter [phone-number-validate](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/phone-number-validate.html) in der Referenz zum *AWS CLI -Befehl*. Antworten zur Validierung finden Sie beispielsweise unter[Antwort auf die Bestätigung der Telefonnummer](#validate-phone-numbers-example-responses). Weitere Informationen zur Konfiguration von finden [Sie unter Configure the AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) im [AWS Command Line Interface Benutzerhandbuch](https://docs.aws.amazon.com/cli/latest/userguide/). AWS CLI
**Um den Dienst zur Überprüfung von Telefonnummern zu nutzen, verwenden Sie AWS CLI**
+ Geben Sie in der Befehlszeile folgenden Befehl ein:
```
aws pinpoint phone-number-validate --number-validate-request PhoneNumber=+442079460881,IsoCountryCode=GB
```
Ersetzen Sie den Befehl im vorherigen Befehl *\$1442079460881* durch die Telefonnummer, die Sie überprüfen möchten, und *GB* durch den zweistelligen ISO-Landes- oder Regionalcode.
**Anmerkung**
Wenn Sie eine Telefonnummer an den Service zur Telefonnummernüberprüfung übergeben, sollten Sie immer den Ländercode einschließen. Wenn Sie den Ländercode nicht einschließen, gibt der Service möglicherweise Informationen zu einer Telefonnummer in einem anderen Land zurück. Sie können beispielsweise *\$144-207-946-0881* Bindestriche in der Telefonnummer haben.
## Antwort auf die Bestätigung der Telefonnummer
Die Informationen, die der Service zur Telefonnummernüberprüfung zurückgibt, variieren geringfügig in Abhängigkeit von den Daten, die zu der von Ihnen angegebenen Telefonnummer verfügbar sind. Dieser Abschnitt enthält Beispiele für die Antworten, die der Service zur Telefonnummernüberprüfung zurückgibt.
**Anmerkung**
Die Daten, die der Service zur Telefonnummernüberprüfung bereitstellt, basieren auf den Daten, die von Telekommunikationsanbietern und anderen Organisationen weltweit übermittelt werden. Anbieter aktualisieren diese Daten in einigen Ländern möglicherweise seltener als Anbieter in anderen Ländern. Wenn Sie beispielsweise eine Anforderung zum Validieren einer Mobiltelefonnummer senden und die angegebene Telefonnummer von einer Telefongesellschaft zu einer anderen portiert wurde, enthält die Antwort des Services zur Telefonnummernüberprüfung möglicherweise den Namen der ursprünglichen Telefongesellschaft und nicht den des jetzt zuständigen Unternehmens.
**Gültige Mobiltelefonnummern**
Wenn Sie eine Anforderung an den Service zur Telefonnummernüberprüfung senden und es sich bei der Telefonnummer um eine gültige Mobiltelefonnummer handelt, werden Daten wie im folgenden Beispiel zurückgegeben:
```
{
"NumberValidateResponse": {
"Carrier": "ExampleCorp Mobile",
"City": "Seattle",
"CleansedPhoneNumberE164": "+12065550142",
"CleansedPhoneNumberNational": "2065550142",
"Country": "United States",
"CountryCodeIso2": "US",
"CountryCodeNumeric": "1",
"OriginalPhoneNumber": "+12065550142",
"PhoneType": "MOBILE",
"PhoneTypeCode": 0,
"Timezone": "America/Los_Angeles",
"ZipCode": "98101"
}
}
```
**Gültige Festnetztelefonnummern**
Wenn die Anforderung eine gültige Festnetztelefonnummer enthält, gibt der Service zur Telefonnummernüberprüfung Daten wie im folgenden Beispiel zurück:
```
{
"CountryCodeIso2": "US",
"CountryCodeNumeric": "1",
"Country": "United States",
"City": "Santa Clara",
"ZipCode": "95037",
"Timezone": "America/Los_Angeles",
"CleansedPhoneNumberNational": "4085550101",
"CleansedPhoneNumberE164": "14085550101",
"Carrier": "AnyCompany",
"PhoneTypeCode": 1,
"PhoneType": "LANDLINE",
"OriginalPhoneNumber": "+14085550101"
}
```
**Gültige VoIP-Telefonnummern**
Wenn die Anforderung eine gültige VoIP (Voice-over-Internet-Protocol)-Telefonnummer enthält, gibt der Service zur Telefonnummernüberprüfung Daten wie im folgenden Beispiel zurück:
```
{
"NumberValidateResponse": {
"Carrier": "ExampleCorp",
"City": "Countrywide",
"CleansedPhoneNumberE164": "+441514960001",
"CleansedPhoneNumberNational": "1514960001",
"Country": "United Kingdom",
"CountryCodeIso2": "GB",
"CountryCodeNumeric": "44",
"OriginalPhoneNumber": "+441514960001",
"PhoneType": "VOIP",
"PhoneTypeCode": 2
}
}
```
**Ungültige Telefonnummern**
Wenn die Anforderung eine ungültige Telefonnummer enthält, gibt der Service zur Telefonnummernüberprüfung Daten wie im folgenden Beispiel zurück:
```
{
"NumberValidateResponse": {
"CleansedPhoneNumberE164": "+44163296076",
"CleansedPhoneNumberNational": "163296076",
"Country": "United Kingdom",
"CountryCodeIso2": "GB",
"CountryCodeNumeric": "44",
"OriginalPhoneNumber": "+440163296076",
"PhoneType": "INVALID",
"PhoneTypeCode": 3
}
}
```
Beachten Sie, dass die Eigenschaft `PhoneType` in dieser Antwort angibt, dass diese Telefonnummer `INVALID` ist und dass keine Informationen zur Telefongesellschaft oder zum Ort der Telefonnummer enthalten sind. Senden Sie keine SMS- oder Sprachnachrichten an Telefonnummern, deren `PhoneType` den Wert `INVALID` hat, weil sie wahrscheinlich keinen tatsächlichen Empfängern gehören.
**Andere Telefonnummern**
Gelegentlich enthält die Antwort des Services zur Telefonnummernüberprüfung einen `PhoneType`-Wert von `OTHER`. Der Service gibt Antworten dieser Art möglicherweise in den folgenden Situationen zurück:
+ Die Telefonnummer ist eine gebührenfreie Nummer.
+ Die Telefonnummer ist für Fernsehsendungen und Filme reserviert. In Nordamerika sind dies z. B. Telefonnummern, die mit *555* beginnen.
+ Die Telefonnummer enthält eine Ortsnetzkennzahl, die derzeit nicht genutzt wird (z. B. *999* in Nordamerika).
+ Die Telefonnummer ist für andere Zwecke reserviert.
Das folgende Beispiel zeigt die Antwort, die der Service zur Telefonnummernüberprüfung zurückgibt, wenn die Anforderung eine fiktive nordamerikanische Telefonnummer enthält:
```
{
"NumberValidateResponse": {
"Carrier": "Multiple OCN Listing",
"CleansedPhoneNumberE164": "+14255550199",
"CleansedPhoneNumberNational": "4255550199",
"Country": "United States",
"CountryCodeIso2": "US",
"CountryCodeNumeric": "1",
"OriginalPhoneNumber": "+14255550199",
"PhoneType": "OTHER",
"PhoneTypeCode": 4,
"Timezone": "America/Los_Angeles"
}
}
```
**Prepaid-Telefonnummern**
Wenn die Anforderung eine gültige Prepaid-Telefonnummer enthält, gibt der Service zur Telefonnummernüberprüfung Daten wie im folgenden Beispiel zurück:
```
{
"NumberValidateResponse": {
"Carrier": "ExampleCorp",
"City": "Countrywide",
"CleansedPhoneNumberE164": "+14255550199",
"CleansedPhoneNumberNational": "4255550199",
"Country": "United States",
"CountryCodeIso2": "US",
"CountryCodeNumeric": "1",
"OriginalPhoneNumber": "+14255550199",
"PhoneType": "PREPAID",
"PhoneTypeCode": 5
}
}
```
Weitere Informationen über die in diesen Antworten enthaltenen Daten finden Sie unter [Telefonnummernüberprüfung](https://docs.aws.amazon.com/pinpoint/latest/apireference/phone-number-validate.html) in der *Amazon-Pinpoint-API-Referenz*.