本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用電信業者查詢服務
AWS 最終使用者簡訊簡訊包含電信業者查詢服務，可用來取得電話號碼的相關資訊，包括電話號碼是否有效。電信業者查詢服務會傳回電話號碼的下列資訊：
+ E164 格式的電話號碼 （已從原始輸入進行清理）。
+ 電話號碼類型 （例如無效、有線電話、行動電話、其他）。
+ 電話號碼的國家或地區名稱。
+ 電話號碼的國家或地區數字撥號代碼。
+ 電話號碼的 ISO 3166-1 alpha-2 格式的兩字元國家或地區代碼。
+ 對於行動電話號碼，則為行動國家/地區代碼 (MCC)。
+ 對於行動電話號碼，則為行動網路碼 (MNC)。
+ 電話號碼目前註冊的電信業者或服務供應商。在某些國家和地區，此值可能是最初註冊電話號碼的電信業者或服務供應商。
使用電信業者查詢服務需支付額外費用。如需詳細資訊，請參閱[AWS 最終使用者簡訊簡訊定價](https://aws.amazon.com/end-user-messaging/pricing/#Phone_number_validate)。
## 電信業者查詢使用案例
您可以使用電信業者查詢服務來啟用數個使用案例，包括下列項目：
+ **Web 表單上提供的電話號碼：**如果您使用 Web 表單來收集客戶的聯絡資訊，您可以在提交表單之前查詢客戶提供的電話號碼。使用網站的後端，使用 AWS 最終使用者簡訊簡訊 API 來查詢和驗證號碼。API 回應會說明號碼是否有效，例如電話號碼的格式是否正確。如果您判斷客戶提供的電話號碼無效，您的 Web 表單可以提示客戶提供有效的號碼。
+ **清除現有的聯絡資料庫** – 如果您有客戶電話號碼的資料庫，您可以查詢每個電話號碼，並使用電信業者查詢結果更新資料庫。例如，如果您發現端點的電話號碼沒有接收 SMS 訊息的功能，您可以將端點的 `ChannelType` 屬性從 `SMS` 變更為 `VOICE`。
+ **傳送訊息之前選擇正確的管道** – 如果您想傳送 SMS 訊息，但發現目的地號碼無效，您可以透過不同的管道將訊息傳送給收件人。例如，如果端點無法接收 SMS 訊息，您可以改為傳送語音訊息。
## 支援的電話號碼格式
電話號碼必須是 E164 格式，開頭為加號 (＋)，後面接著國家撥號代碼和電話號碼 （例如 \+12065551234)。電信業者查詢服務接受各種格式字元，並在處理期間自動將其移除。您可以在電話號碼輸入中包含下列格式字元：
+ 括號： `+1 (555) 123-4567`
+ 括號： `+1 [555] 123-4567`
+ 空格： `+1 555 123 4567`
+ 連字號： `+1-555-123-4567`
+ 期間： `+1.555.123.4567`
+ 逗號： `+1,555,123,4567`
+ 混合格式： `+1 (555)-123.4567`
處理期間會自動移除所有格式化字元，而服務會在回應的 `E164PhoneNumber` 欄位中傳回標準 E164 格式的電話號碼 （例如 `+15551234567`)。
## 在 中使用電信業者查詢服務 AWS CLI
下列範例示範如何在 中使用電信業者查詢服務 AWS CLI。此服務接受具有各種格式字元 （括號、括號、空格、連字號、句點、逗號） 的電話號碼，並自動將其轉換為 E164 格式進行處理。如需詳細資訊，請參閱 AWS 《最終使用者傳訊簡訊 API 參考》中的 [CarrierLookup](https://docs.aws.amazon.com/pinpoint/latest/apireference_smsvoicev2/API_CarrierLookup.html)，或《 AWS CLI 命令參考》中的 [Carrier-lookup](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/carrier-lookup.html)。
**使用電信業者查詢服務 (CLI)**
+ 在命令列輸入下列命令。您可以使用各種電話號碼格式 - 服務接受特殊字元，例如括號、括號、空格、連字號、句點和逗號：
```
$ aws pinpoint-sms-voice-v2 carrier-lookup --phone-number {{"+1 (555) 555-5333"}}
```
或使用 E164 格式：
```
$ aws pinpoint-sms-voice-v2 carrier-lookup --phone-number {{+15555555333}}
```
### 電信業者查詢回應
電信業者查詢服務提供的資訊會因您提供的電話號碼可用的資料而略有不同。本節包含電信業者查詢服務傳回的回應範例。
**注意**
電信業者查詢服務提供的資料是以電信供應商和全球其他實體提供的資訊為基礎。某些國家的提供者更新此資訊的頻率，可能較其他國家中的提供者低。例如，如果您發出驗證行動電話號碼的請求，且您提供的號碼是從一個行動電信業者移轉到另一個電信業者，則電信業者查詢服務的回應可能包含原始電信業者的名稱，而不是目前電信業者的名稱。
**有效行動電話號碼**
下列回應是針對有效行動電話號碼`CarrierLookup`傳回的資訊範例：
```
{
"E164PhoneNumber": "+15555555333",
"DialingCountryCode": "1",
"IsoCountryCode": "US",
"Country": "United States",
"MCC": "310",
"MNC": "260",
"Carrier": "ExampleCorp Mobile",
"PhoneNumberType": "MOBILE"
}
```
**有效的市內電話號碼**
下列回應是針對有效固定電話號碼`CarrierLookup`傳回的資訊範例：
```
{
"E164PhoneNumber": "+15555555333",
"DialingCountryCode": "1",
"IsoCountryCode": "CA",
"Country": "Canada",
"Carrier": "ExampleCorp Landline",
"PhoneNumberType": "LANDLINE"
}
```
**電話號碼無效**
如果您的請求包含無效的電話號碼，電信業者查詢服務會傳回類似下列範例的資訊：
```
{
"E164PhoneNumber": "+15555555333444666",
"PhoneNumberType": "INVALID"
}}
```
請注意，此回應中的 `PhoneNumberType` 屬性指出此電話號碼為 `INVALID`，且不包含有關電信業者或與電話號碼相關聯位置的資訊。您應該避免傳送簡訊或語音訊息到 `PhoneNumberType` 為 `INVALID` 的電話號碼，因為這些號碼很可能屬於實際的收件人。
**其他電話號碼**
未分類為行動、有線或無效的電話號碼會傳回`PhoneNumberType`值為 `OTHER`。