**支援結束通知：**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 中設定 SMS 訊息的 Amazon API Gateway Amazon Pinpoint
<a name="tutorials-two-way-sms-part-4"></a>

在本節中，您會使用 Amazon API Gateway 作為 Amazon Pinpoint SMS 註冊的一部分來建立新的 API。 Amazon Pinpoint 您在此解決方案中部署的註冊表單，呼叫此 API。API Gateway 接著會將註冊表單上擷取的資訊傳遞至您在建立 Lambda 函數中[建立的 Lambda 函數](tutorials-two-way-sms-part-3.md)。

## 建立 API
<a name="tutorials-two-way-sms-part-4-create-api"></a>

首先，您必須在 API Gateway 中建立新的 API。下列程序顯示如何建立新的 REST API。

**建立新的 API**

1. 在以下網址開啟 API Gateway 主控台：[https://console.aws.amazon.com/apigateway/](https://console.aws.amazon.com/apigateway/)。

1. 選擇**建立 API**。選擇如下：
   + 在 **Choose the protocol (選擇通訊協定)** 下，選擇 **REST**。
   + 在 **Create new API** (建立新 API) 下，選擇 **New API** (新增 API)。
   + 在 **Settings (設定)** 下方的 **Name (名稱)** 中，輸入名稱，例如 **RegistrationForm**。對於 **Description (描述)**，選擇性地輸入可描述 API 用途的一些文字。對於 **Endpoint Type** (端點類型)，選擇 **Regional** (區域)。然後選擇 **Create API (建立 API)**。

   下圖顯示這些設定的範例。  
![\[通訊協定設定為 REST、建立新的 API 設定為新 API、API 名稱設定為 RegistrationForm，以及端點類型設定為區域。\]](http://docs.aws.amazon.com/zh_tw/pinpoint/latest/userguide/images/SMS_Reg_Tutorial_APIGW_Step2.png)

## 建立資源
<a name="tutorials-two-way-sms-part-4-create-resource"></a>

現在您已建立 API，您可以開始新增資源。接著將 POST 方法加入資源，並告訴 API Gateway 將這個方法收到的資料傳遞到 Lambda 函數。

1. 在 **Actions (動作)** 功能表中，選擇 **Create Resource (建立資源)**。在 **New Child Resource (新的子資源)** 窗格中，對於 **Resource Name (資源名稱)**，輸入 **register**，如下圖所示。選擇 **建立資源** 。  
![\[將資源名稱設定為註冊的新子資源窗格。\]](http://docs.aws.amazon.com/zh_tw/pinpoint/latest/userguide/images/SMS_Reg_Tutorial_APIGW_Step3.png)

1. 在 **Actions (動作)** 功能表中，選擇 **Create method (建立方法)**。從功能表中，選擇 **POST**，如下圖所示。然後選擇**核取記號**按鈕。  
![\[選取核取記號的建立方法窗格。\]](http://docs.aws.amazon.com/zh_tw/pinpoint/latest/userguide/images/SMS_Reg_Tutorial_APIGW_Step4.png)

1. 在 **/register - POST - Setup (/註冊 - POST - 設定)** 窗格中，選取下列項目：
   + 針對 **整合類型** ，選擇 **Lambda 函數** 。
   + 選擇**使用 Lambda 代理整合**。
   + 在 **Lambda 區域**中，選擇您建立 Lambda 函數的區域。
   + 針對 **Lambda 函數**，選擇您在建立 Lambda 函數中建立的 RegisterEndpoint 函數。 [建立 Lambda 函數以搭配 Amazon Pinpoint SMS 訊息使用](tutorials-two-way-sms-part-3.md)

   下圖顯示這些設定的範例。  
![\[選取 Lambda 函數的 /register - POST - 設定窗格。\]](http://docs.aws.amazon.com/zh_tw/pinpoint/latest/userguide/images/SMS_Reg_Tutorial_APIGW_Step5.png)

   選擇**儲存**。在出現的視窗中，選擇**確定**，以授予 API Gateway 執行 Lambda 函數的許可。

## 部署 API
<a name="tutorials-two-way-sms-part-4-deploy-api"></a>

API 現在已準備好可供使用。此時，您必須部署它以便建立可公開存取的端點。

1. 在 **Action (動作)** 功能表中，選擇 **Deploy API (部署 API)**。在 **Deploy API (部署 API)** 視窗上，選取下列項目：
   + 針對 **Deployment stage (部署階段)**，選擇 **[New Stage] ([新增階段])**。
   + 針對 **Stage name (階段名稱)**，輸入 **v1**。
   + 選擇 **Deploy (部署)**。

   下圖顯示這些選取項目的範例。  
![\[階段名稱設為 v1 的部署 API 視窗\]](http://docs.aws.amazon.com/zh_tw/pinpoint/latest/userguide/images/SMS_Reg_Tutorial_APIGW_Step6.png)

1. 在 **v1 Stage Editor (v1 階段編輯器)** 窗格中，選擇 **/register (/註冊)** 資源，然後選擇 **POST** 方法。複製 **Invoke URL (呼叫 URL)** 旁顯示的地址，如下圖所示。  
![\[v1 階段編輯器窗格顯示要複製的調用 URL\]](http://docs.aws.amazon.com/zh_tw/pinpoint/latest/userguide/images/SMS_Reg_Tutorial_APIGW_Step7.png)

1. 在導覽窗格中，選擇 **Resources** (資源)。在資源清單中，選擇 **/register (/註冊)** 資源。最後，在 **Actions (動作)** 功能表中，選擇 **Enable CORS (啟用 CORS)**，如下圖所示。  
![\[動作的下拉式選單，顯示已選取啟用 CORS\]](http://docs.aws.amazon.com/zh_tw/pinpoint/latest/userguide/images/SMS_Reg_Tutorial_APIGW_Step8.png)

1. 在 **Enable CORS (啟用 CORS)** 窗格中，選擇 **Enable CORS and replace existing CORS headers (啟用 CORS 並取代現有的 CORS 標頭)**。

**下一步**：[建立和部署 Web 表單](tutorials-two-way-sms-part-5.md)