Configurazione di Amazon API Gateway per la messaggistica SMS in Amazon Pinpoint - Amazon Pinpoint

Avviso di fine del supporto: il 30 ottobre 2026 AWS terminerà il supporto per Amazon Pinpoint. Dopo il 30 ottobre 2026, non potrai più accedere alla console Amazon Pinpoint o alle risorse Amazon Pinpoint (endpoint, segmenti, campagne, percorsi e analisi). Per ulteriori informazioni, consulta la pagina relativa alla fine del supporto di Amazon Pinpoint. Nota: per quanto APIs riguarda gli SMS, i comandi vocali, i messaggi push su dispositivi mobili, l'OTP e la convalida del numero di telefono non sono interessati da questa modifica e sono supportati da AWS End User Messaging.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Configurazione di Amazon API Gateway per la messaggistica SMS in Amazon Pinpoint

In questa sezione, crei una nuova API utilizzando Amazon API Gateway come parte della registrazione SMS per Amazon Pinpoint. Il modulo di registrazione implementato in questa soluzione chiama questa API. API Gateway passa quindi le informazioni acquisite nel modulo di registrazione alla funzione Lambda creata in Create Lambda functions.

In primo luogo, è necessario creare una nuova API in Gateway API. Le procedure seguenti mostrano come creare una nuova API REST.

Per creare una nuova API
  1. Apri la console API Gateway all'indirizzo https://console.aws.amazon.com/apigateway/.

  2. Seleziona Create API (Crea API). Operare le seguenti selezioni:

    • In Choose the protocol (Scegliere il protocollo) scegliere REST.

    • In Create new API (Crea nuova API) scegliere New API (Nuova API).

    • In Settings (Impostazioni), per Name (Nome), immettere un nome, come RegistrationForm. Per Description (Descrizione), è possibile immettere un testo che descriva lo scopo dell'API. In Endpoint Type (Tipo di endpoint), scegliere Regional (Regionale). Quindi, scegliere Create API (Crea API).

    Un esempio di queste impostazioni è illustrato nella seguente immagine.

    Protocollo impostato su REST, Crea nuova API impostato su Nuova API, Nome API impostato RegistrationForm su e Tipo di endpoint impostato su Regionale.

Dopo aver creato un'API, puoi iniziare ad aggiungere risorse al suo interno. In seguito, puoi aggiungere un metodo POST alla risorsa e indicare a Gateway API di trasferire i dati ricevuti da questo metodo alla funzione Lambda.

  1. Nel menu Actions (Operazioni) scegliere Create Resource (Crea risorsa). Nel riquadro New Child Resource (Nuova risorsa figlio), per Resource Name (Nome risorsa), immettere register, come illustrato nella seguente immagine. Scegliere Create Resource (Crea risorsa).

    Il nuovo riquadro delle risorse secondarie con il nome della risorsa impostato per la registrazione.
  2. Nel menu Actions (Operazioni) scegliere Create method (Crea metodo). Dal menu visualizzato, scegliere POST, come illustrato nella seguente immagine. Quindi scegli il pulsante con il segno di spunta.

    Il riquadro di creazione del metodo con il segno di spunta selezionato.
  3. Nel riquadro /register - POST - Setup (registra - POST - Configura), effettua le seguenti selezioni:

    • Per Integration type (Tipo di integrazione), scegliere Lambda Function (Funzione Lambda).

    • Scegli Usa integrazione proxy Lambda.

    • In Regione Lambda, scegli la regione in cui è stata creata la funzione Lambda.

    • Per Funzione Lambda, scegli la RegisterEndpoint funzione che hai creato in Crea funzioni Lambda.

    Un esempio di queste impostazioni è illustrato nella seguente immagine.

    Il riquadro /register - POST - Setup con la funzione Lambda selezionata.

    Seleziona Salva. Nella finestra visualizzata, scegli OK per autorizzare Gateway API a eseguire la funzione Lambda.

L'API è ora pronta per l'uso. A questo punto, è necessario distribuirla per creare un endpoint accessibile pubblicamente.

  1. Nel menu Actions (Operazioni), scegliere Deploy API (Distribuisci API). Nella finestra Deploy API (Distribuisci API), effettuare le seguenti selezioni:

    • In Deployment stage (Fase di distribuzione), scegliere [New Stage] ([Nuova fase]).

    • In Stage name (Nome fase) immettere v1.

    • Selezionare Deploy (Distribuisci).

    Un esempio di queste selezioni è illustrato nella seguente immagine.

    Le finestre dell'API di distribuzione con il nome dello stage impostato su v1
  2. Nel riquadro v1 Stage Editor (Editor fasi v1), scegliere la risorsa /register (/registra) e poi scegliere il metodo POST. Copiare l'indirizzo che viene visualizzato accanto a Invoke URL (URL chiamata), come illustrato nella seguente immagine.

    Il riquadro v1 Stage Editor che mostra l'URL Invoke da copiare
  3. Nel riquadro di spostamento seleziona Resources (Risorse). Nell'elenco delle risorse, scegliere la risorsa /register (/registra). Infine, nel menu Actions (Operazioni), scegliere Enable CORS (Abilita CORS), come illustrato nella seguente immagine.

    Il menu a discesa per Azioni, mostra che l'opzione Abilita CORS è selezionata
  4. Nel riquadro Enable CORS (Abilita CORS), scegliere Enable CORS and replace existing CORS headers (Abilita CORS e sostituisci intestazioni CORS esistenti).

Successivo: Creazione e distribuzione del modulo Web