**支援結束通知：**2026 年 10 月 30 日， AWS 將結束對 Amazon Pinpoint 的支援。2026 年 10 月 30 日之後，您將無法再存取 Amazon Pinpoint 主控台或 Amazon Pinpoint 資源 (端點、區段、行銷活動、旅程和分析)。如需詳細資訊，請參閱 [Amazon Pinpoint 終止支援](https://docs.aws.amazon.com/console/pinpoint/migration-guide)。**注意：**與 SMS、語音、行動推播、OTP 和電話號碼驗證相關的 APIs 不受此變更影響，並受 AWS 最終使用者傳訊支援。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用 Amazon Pinpoint 電話號碼驗證服務
Amazon Pinpoint 包含電話號碼驗證服務，您可以利用該服務，判斷電話號碼是否有效，並取得有關電話號碼本身的其他資訊。例如，使用電話號碼驗證服務時，它會傳回以下資訊：
+ 採用 E.164 的電話號碼格式。
+ 電話號碼類型 (例如行動電話、市內電話或 VoIP)。
+ 電話號碼所在的城市和國家。
+ 與電話號碼相關聯的服務提供者。
使用電話號碼驗證服務需要支付額外的費用。詳情請參閱 [Amazon Pinpoint 定價](https://aws.amazon.com/pinpoint/pricing/#Phone_Number_Validate)。
**重要**
若使用美國和加拿大的電話號碼，電話號碼驗證 API 將不再傳回 `City`、`County`、`Timezone` 和 `ZipCode` 的資料。
## Amazon Pinpoint 電話號碼驗證使用案例
您可以使用電話號碼驗證服務，來啟用多種使用案例，包括下列：
+ **驗證網頁型表單上的電話號碼** – 如果您使用網頁型表單收集客戶的聯絡資訊，您可以在提交表單之前，驗證客戶提供的電話號碼。在網站的後端利用 Amazon Pinpoint API 來驗證號碼。API 回應指出該號碼是否無效，例如電話號碼格式是否不正確。如果您判斷客戶提供的電話號碼無效，您的 Web 表單可以提示客戶提供不同的號碼。
+ **清理您現有的聯絡人資料庫** – 如果您有客戶電話號碼資料庫，您可以驗證每個電話號碼，然後根據調查結果更新資料庫。例如，如果您發現端點的電話號碼沒有接收 SMS 訊息的功能，您可以將端點的 `ChannelType` 屬性從 `SMS` 變更為 `VOICE`。您可以先驗證電話號碼，然後為新的或現有端點更新 `ChannelType` 屬性。如為單一端點請遵照 [將端點新增至 Amazon Pinpoint](audience-define-endpoints.md) 的指示，多個端點則請參照 [將一批端點新增至 Amazon Pinpoint](audience-define-endpoints-batch.md)。
+ **傳送訊息之前選擇正確的管道** – 如果您想傳送 SMS 訊息，但發現目的地號碼無效，您可以透過不同的管道將訊息傳送給收件人。例如，如果端點無法接收 SMS 訊息，您可以改為傳送語音訊息。
## 使用 驗證電話號碼 AWS CLI
下列範例示範如何使用 驗證電話號碼 AWS CLI。如需詳細資訊，請參閱《 *AWS CLI 命令參考*》中的 [phone-number-validate](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/phone-number-validate.html)。如需驗證回應的範例，請參閱 [電話號碼驗證回應](#validate-phone-numbers-example-responses)。如需設定 的詳細資訊 AWS CLI，請參閱[AWS Command Line Interface 《 使用者指南](https://docs.aws.amazon.com/cli/latest/userguide/)》中的[設定 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html)。
**使用 來使用電話號碼驗證服務 AWS CLI**
+ 在命令列中輸入以下命令：
```
aws pinpoint phone-number-validate --number-validate-request PhoneNumber={{+442079460881}},IsoCountryCode={{GB}}
```
在上述命令中，將 {{\+442079460881}} 取代為您要驗證的電話號碼，並將 {{GB}} 取代為兩位數 ISO 國家或地區代碼。
**注意**
當您向電話號碼驗證服務提供的電話號碼時，應該一律包含國家代碼。如果您未包括國家代碼，服務可能會傳回不同國家電話號碼的資訊。您可以在電話號碼中使用破折號，例如 {{\+44-207-946-0881}}。
## 電話號碼驗證回應
電話號碼驗證服務提供的資訊，會因您提供的電話號碼可用的資料稍有不同。本節包含電話號碼驗證服務傳回的回應範例。
**注意**
電話號碼驗證服務提供的資料，是基於電信服務提供者和全球的其他實體提供的資訊。某些國家的提供者更新此資訊的頻率，可能較其他國家中的提供者低。例如，如果您發出請求來驗證行動電話號碼，而您提供的號碼是從不同行動電信業者移植，來自電話號碼驗證服務的回應可能會包含原始電信業者名稱，而不是目前的電信業者。
**有效行動電話號碼**
傳送請求到電話號碼驗證服務，而且電話號碼是有效的行動電話號碼時，它會傳回類似以下範例的資訊：
```
{
"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"
}
}
```
**有效的市內電話號碼**
如果您的請求包含有效的市內電話號碼，電話號碼驗證服務會傳回類似以下範例的資訊：
```
{
"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"
}
```
**有效 VoIP 電話號碼**
如果您的請求包含有效的網路電話 (VoIP) 電話號碼，電話號碼驗證服務會傳回類似以下範例的資訊：
```
{
"NumberValidateResponse": {
"Carrier": "ExampleCorp",
"City": "Countrywide",
"CleansedPhoneNumberE164": "+441514960001",
"CleansedPhoneNumberNational": "1514960001",
"Country": "United Kingdom",
"CountryCodeIso2": "GB",
"CountryCodeNumeric": "44",
"OriginalPhoneNumber": "+441514960001",
"PhoneType": "VOIP",
"PhoneTypeCode": 2
}
}
```
**電話號碼無效**
如果您的請求包含無效的電話號碼，電話號碼驗證服務會傳回類似以下範例的資訊：
```
{
"NumberValidateResponse": {
"CleansedPhoneNumberE164": "+44163296076",
"CleansedPhoneNumberNational": "163296076",
"Country": "United Kingdom",
"CountryCodeIso2": "GB",
"CountryCodeNumeric": "44",
"OriginalPhoneNumber": "+440163296076",
"PhoneType": "INVALID",
"PhoneTypeCode": 3
}
}
```
請注意，此回應中的 `PhoneType` 屬性指出此電話號碼為 `INVALID`，且不包含有關電信業者或與電話號碼相關聯位置的資訊。您應該避免傳送簡訊或語音訊息到 `PhoneType` 為 `INVALID` 的電話號碼，因為這些號碼很可能屬於實際的收件人。
**其他電話號碼**
有時候，來自電話號碼驗證服務的回應會包含一個 `OTHER` 的 `PhoneType` 值。服務可能會在下列情況中傳回這類回應：
+ 電話號碼是免付費號碼。
+ 電話號碼保留在電視節目和影片中使用，例如，以 *555* 為開頭的北美電話號碼。
+ 電話號碼包含目前未使用的區域碼，例如，*999* 區域碼在北美。
+ 電話號碼保留供某些其他用途。
以下範例顯示當您的請求包含虛構的北美電話號碼時，電話號碼驗證服務提供的回應：
```
{
"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"
}
}
```
**預付電話號碼**
如果您的請求包含有效的預付電話號碼，電話號碼驗證服務將傳回類似以下範例的資訊：
```
{
"NumberValidateResponse": {
"Carrier": "ExampleCorp",
"City": "Countrywide",
"CleansedPhoneNumberE164": "+14255550199",
"CleansedPhoneNumberNational": "4255550199",
"Country": "United States",
"CountryCodeIso2": "US",
"CountryCodeNumeric": "1",
"OriginalPhoneNumber": "+14255550199",
"PhoneType": "PREPAID",
"PhoneTypeCode": 5
}
}
```
如需深入了解這些回應中包含的資訊，請參閱《Amazon Pinpoint API 參考》中的[電話號碼驗證](https://docs.aws.amazon.com/pinpoint/latest/apireference/phone-number-validate.html)。