Avviso di fine del supporto: il 7 ottobre 2026, AWS il supporto per. AWS IoT Greengrass Version 1 Dopo il 7 ottobre 2026, non potrai più accedere alle risorse. AWS IoT Greengrass V1 Per ulteriori informazioni, visita [Migrate](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html) from. AWS IoT Greengrass Version 1 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à. # Connettore di notifica Twilio **avvertimento** Questo connettore è entrato nella *fase di vita prolungata* e AWS IoT Greengrass non rilascerà aggiornamenti che forniscano funzionalità, miglioramenti alle funzionalità esistenti, patch di sicurezza o correzioni di bug. Per ulteriori informazioni, consulta [AWS IoT Greengrass Version 1 politica di manutenzione](maintenance-policy.md). Il [connettore](connectors.md) Twilio Notifications effettua chiamate telefoniche automatiche o invia messaggi di testo tramite Twilio. Puoi utilizzare questo connettore per inviare notifiche in risposta a eventi nel gruppo Greengrass. Per le telefonate, il connettore è in grado di inoltrare un messaggio vocale al destinatario. Questo connettore riceve le informazioni sui messaggi Twilio in un argomento MQTT, quindi attiva una notifica Twilio. **Nota** Per un tutorial che mostra come utilizzare il connettore Twilio Notifications, consulta o. [Nozioni di base sui connettori Greengrass (console)](connectors-console.md) [Nozioni di base sui connettori Greengrass (CLI)](connectors-cli.md) Questo connettore ha le seguenti versioni. | Versione | ARN | | --- | --- | | 5 | `arn:aws:greengrass:{{region}}::/connectors/TwilioNotifications/versions/5` | | 4 | `arn:aws:greengrass:{{region}}::/connectors/TwilioNotifications/versions/4` | | 3 | `arn:aws:greengrass:{{region}}::/connectors/TwilioNotifications/versions/3` | | 2 | `arn:aws:greengrass:{{region}}::/connectors/TwilioNotifications/versions/2` | | 1 | `arn:aws:greengrass:{{region}}::/connectors/TwilioNotifications/versions/1` | Per informazioni sulle modifiche di ogni versione, consulta [Changelog](#twilio-notifications-connector-changelog). ## Requisiti Questo connettore presenta i seguenti requisiti: ------ #### [ Version 4 - 5 ] + AWS IoT Greengrass Software principale v1.9.3 o successivo. AWS IoT Greengrass [deve essere configurato per supportare i segreti locali, come descritto in Secrets Requirements.](secrets.md#secrets-reqs) **Nota** Questo requisito include l'autorizzazione all'accesso ai segreti di Secrets Manager. *Se utilizzi il ruolo di servizio Greengrass predefinito, Greengrass è autorizzato a ottenere i valori dei segreti con nomi che iniziano con greengrass-.* + [Python](https://www.python.org/) versione 3.7 o 3.8 installata sul dispositivo principale e aggiunta alla variabile di ambiente PATH. **Nota** Per usare Python 3.8, esegui il seguente comando per creare un collegamento simbolico dalla cartella di installazione predefinita di Python 3.7 ai binari Python 3.8 installati. ``` sudo ln -s {{path-to-python-3.8}}/python3.8 /usr/bin/python3.7 ``` Questo configura il dispositivo in modo che soddisfi il requisito Python per AWS IoT Greengrass. + SID, token di autenticazione e numero di telefono dell'account Twilio. Twilio-enabled Dopo avere creato un progetto Twilio, questi valori sono disponibili nel pannello di controllo del progetto. **Nota** Puoi utilizzare un account di prova Twilio. Se utilizzi un account di prova, devi aggiungere numeri di telefono dei destinatari diversi da Twilio a un elenco di numeri di telefono verificati. Per ulteriori informazioni, vedi [Come lavorare con il tuo account di prova Twilio gratuito](https://www.twilio.com/docs/usage/tutorials/how-to-use-your-free-trial-account). + Un tipo di testo segreto Gestione dei segreti AWS che memorizza il token di autenticazione Twilio. Per ulteriori informazioni, consulta [Creazione di un segreto di base nella Guida](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_create-basic-secret.html) per l'*Gestione dei segreti AWS utente*. **Nota** Per creare il segreto nella console Secrets Manager, inserisci il tuo token nella scheda **Plaintext**. Non includere virgolette o altri tipi di formattazione. Nell'API, specifica il token come valore per la `SecretString` proprietà. + Una risorsa segreta del gruppo Greengrass che fa riferimento al segreto di Secrets Manager. Per ulteriori informazioni, consulta [Distribuisci segreti a AWS IoT Greengrass core](secrets.md). ------ #### [ Versions 1 - 3 ] + AWS IoT Greengrass Software principale v1.7 o successivo. AWS IoT Greengrass deve essere configurato per supportare i segreti locali, come descritto in [Secrets Requirements](secrets.md#secrets-reqs). **Nota** Questo requisito include l'autorizzazione all'accesso ai segreti di Secrets Manager. *Se utilizzi il ruolo di servizio Greengrass predefinito, Greengrass è autorizzato a ottenere i valori dei segreti con nomi che iniziano con greengrass-.* + [Python](https://www.python.org/) versione 2.7 installato sul dispositivo principale e aggiunto alla variabile di ambiente PATH. + SID, token di autenticazione e numero di telefono dell'account Twilio. Twilio-enabled Dopo avere creato un progetto Twilio, questi valori sono disponibili nel pannello di controllo del progetto. **Nota** Puoi utilizzare un account di prova Twilio. Se utilizzi un account di prova, devi aggiungere numeri di telefono dei destinatari diversi da Twilio a un elenco di numeri di telefono verificati. Per ulteriori informazioni, vedi [Come lavorare con il tuo account di prova Twilio gratuito](https://www.twilio.com/docs/usage/tutorials/how-to-use-your-free-trial-account). + Un tipo di testo segreto Gestione dei segreti AWS che memorizza il token di autenticazione Twilio. Per ulteriori informazioni, consulta [Creazione di un segreto di base nella Guida](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_create-basic-secret.html) per l'*Gestione dei segreti AWS utente*. **Nota** Per creare il segreto nella console Secrets Manager, inserisci il tuo token nella scheda **Plaintext**. Non includere virgolette o altri tipi di formattazione. Nell'API, specifica il token come valore per la `SecretString` proprietà. + Una risorsa segreta del gruppo Greengrass che fa riferimento al segreto di Secrets Manager. Per ulteriori informazioni, consulta [Distribuisci segreti a AWS IoT Greengrass core](secrets.md). ------ ## Parametri del connettore Questo connettore fornisce i seguenti parametri. ------ #### [ Version 5 ] `TWILIO_ACCOUNT_SID` Il SID dell'account Twilio utilizzato per chiamare l'API Twilio. Nome visualizzato nella AWS IoT console: SID dell'**account Twilio** Obbligatorio: `true` Tipo: `string` Modello valido: `.+` `TwilioAuthTokenSecretArn` L'ARN del segreto Secrets Manager che memorizza il token di autenticazione Twilio. Viene utilizzato per accedere al valore del segreto locale nel core. Nome visualizzato nella AWS IoT console: **ARN del token di autenticazione segreto di Twilio** Obbligatorio: `true` Tipo: `string` Modello valido: `arn:aws:secretsmanager:[a-z0-9\-]+:[0-9]{12}:secret:([a-zA-Z0-9\\]+/)*[a-zA-Z0-9/_+=,.@\-]+-[a-zA-Z0-9]+` `TwilioAuthTokenSecretArn-ResourceId` L'ID della risorsa segreta del gruppo Greengrass che fa riferimento al segreto del token di autorizzazione Twilio. Nome visualizzato nella AWS IoT console: risorsa del token di **autenticazione Twilio** Obbligatorio: `true` Tipo: `string` Modello valido: `.+` `DefaultFromPhoneNumber` Il numero di Twilio-enabled telefono predefinito utilizzato da Twilio per inviare messaggi. Twilio utilizza questo numero per iniziare il messaggio di testo o la chiamata. + Se non configuri un numero di telefono predefinito, dovrai specificare un numero di telefono nella proprietà `from_number` nel corpo del messaggio di input. + Se configuri un numero di telefono predefinito, potrai ignorarlo specificando la proprietà `from_number` nel corpo del messaggio di input. Nome visualizzato nella AWS IoT console: **predefinito dal numero di telefono** Obbligatorio: `false` Tipo: `string` Modello valido: `^$|\+[0-9]+` `IsolationMode` Modalità di [containerizzazione](connectors.md#connector-containerization) per questo connettore. L'impostazione predefinita è`GreengrassContainer`, il che significa che il connettore viene eseguito in un ambiente di runtime isolato all'interno del AWS IoT Greengrass contenitore. L'impostazione predefinita della containerizzazione per il gruppo non si applica ai connettori. Nome visualizzato nella AWS IoT console: **modalità di isolamento del contenitore** Obbligatorio: `false` Tipo: `string` Valori validi: `GreengrassContainer` o `NoContainer` Modello valido: `^NoContainer$|^GreengrassContainer$` ------ #### [ Version 1 - 4 ] `TWILIO_ACCOUNT_SID` Il SID dell'account Twilio utilizzato per chiamare l'API Twilio. Nome visualizzato nella AWS IoT console: SID dell'**account Twilio** Obbligatorio: `true` Tipo: `string` Modello valido: `.+` `TwilioAuthTokenSecretArn` L'ARN del segreto Secrets Manager che memorizza il token di autenticazione Twilio. Viene utilizzato per accedere al valore del segreto locale nel core. Nome visualizzato nella AWS IoT console: **ARN del token di autenticazione segreto di Twilio** Obbligatorio: `true` Tipo: `string` Modello valido: `arn:aws:secretsmanager:[a-z0-9\-]+:[0-9]{12}:secret:([a-zA-Z0-9\\]+/)*[a-zA-Z0-9/_+=,.@\-]+-[a-zA-Z0-9]+` `TwilioAuthTokenSecretArn-ResourceId` L'ID della risorsa segreta del gruppo Greengrass che fa riferimento al segreto del token di autorizzazione Twilio. Nome visualizzato nella AWS IoT console: risorsa del token di **autenticazione Twilio** Obbligatorio: `true` Tipo: `string` Modello valido: `.+` `DefaultFromPhoneNumber` Il numero di Twilio-enabled telefono predefinito utilizzato da Twilio per inviare messaggi. Twilio utilizza questo numero per iniziare il messaggio di testo o la chiamata. + Se non configuri un numero di telefono predefinito, dovrai specificare un numero di telefono nella proprietà `from_number` nel corpo del messaggio di input. + Se configuri un numero di telefono predefinito, potrai ignorarlo specificando la proprietà `from_number` nel corpo del messaggio di input. Nome visualizzato nella AWS IoT console: **predefinito dal numero di telefono** Obbligatorio: `false` Tipo: `string` Modello valido: `^$|\+[0-9]+` ------ ### Esempio di creazione di connettore (AWS CLI) Il seguente comando CLI di esempio crea un comando `ConnectorDefinition` con una versione iniziale che contiene il connettore Twilio Notifications. ``` aws greengrass create-connector-definition --name MyGreengrassConnectors --initial-version '{ "Connectors": [ { "Id": "MyTwilioNotificationsConnector", "ConnectorArn": "arn:aws:greengrass:{{region}}::/connectors/TwilioNotifications/versions/5", "Parameters": { "TWILIO_ACCOUNT_SID": "abcd12345xyz", "TwilioAuthTokenSecretArn": "arn:aws:secretsmanager:{{region}}:{{account-id}}:secret:greengrass-{{secret-hash}}", "TwilioAuthTokenSecretArn-ResourceId": "MyTwilioSecret", "DefaultFromPhoneNumber": "+19999999999", "IsolationMode" : "GreengrassContainer" } } ] }' ``` Per i tutorial che mostrano come aggiungere il connettore Twilio Notifications a un gruppo, consulta e. [Nozioni di base sui connettori Greengrass (CLI)](connectors-cli.md) [Nozioni di base sui connettori Greengrass (console)](connectors-console.md) ## Dati di input Questo connettore accetta informazioni sui messaggi Twilio su due argomenti MQTT. I messaggi di input devono essere in formato JSON. + Informazioni sui messaggi di testo nell'argomento `twilio/txt`. + Informazioni sui messaggi vocali nell'argomento `twilio/call`. **Nota** Il payload del messaggio di input può includere un messaggio di testo (`message`) o un messaggio vocale (`voice_message_location`), ma non entrambi. **Filtro di argomenti: `twilio/txt`** **Proprietà dei messaggi** `request` Informazioni sulla notifica Twilio. Obbligatorio: `true` Tipo: `object` che include le seguenti proprietà: `recipient` Il destinatario del messaggio. È supportato solo un destinatario. Obbligatorio: `true` Tipo: `object` che include le seguenti proprietà: `name` Il nome del destinatario. Obbligatorio: `true` Tipo: `string` Modello valido: `.*` `phone_number` Il numero di telefono del destinatario. Obbligatorio: `true` Tipo: `string` Modello valido: `\+[1-9]+` `message` Il contenuto del messaggio di testo. In questo argomento sono supportati solo i messaggi di testo. Per i messaggi vocali, utilizzare `twilio/call`. Obbligatorio: `true` Tipo: `string` Modello valido: `.+` `from_number` Il numero di telefono del mittente. Twilio utilizza questo numero di telefono per iniziare il messaggio. Questa proprietà è obbligatoria se il parametro `DefaultFromPhoneNumber` non è configurato. Se `DefaultFromPhoneNumber` è stato configurato, puoi utilizzare questa proprietà per ignorare quello predefinito. Obbligatorio: `false` Tipo: `string` Modello valido: `\+[1-9]+` `retries` Il numero di tentativi. Il valore predefinito è 0. Obbligatorio: `false` Tipo: `integer` `id` Un ID arbitrario della richiesta. Questa proprietà viene utilizzata per associare una richiesta di input a una risposta di output. Obbligatorio: `true` Tipo: `string` Modello valido: `.+` **Input di esempio** ``` { "request": { "recipient": { "name": "Darla", "phone_number": "+12345000000", "message": "Hello from the edge" }, "from_number": "+19999999999", "retries": 3 }, "id": "request123" } ``` **Filtro di argomenti: `twilio/call`** **Proprietà dei messaggi** `request` Informazioni sulla notifica Twilio. Obbligatorio: `true` Tipo: `object` che include le seguenti proprietà: `recipient` Il destinatario del messaggio. È supportato solo un destinatario. Obbligatorio: `true` Tipo: `object` che include le seguenti proprietà: `name` Il nome del destinatario. Obbligatorio: `true` Tipo: `string` Modello valido: `.+` `phone_number` Il numero di telefono del destinatario. Obbligatorio: `true` Tipo: `string` Modello valido: `\+[1-9]+` `voice_message_location` L'URL del contenuto audio del messaggio vocale. Deve essere in formato TwiML. In questo argomento sono supportati solo i messaggi vocali. Per i messaggi di testo, utilizzare `twilio/txt`. Obbligatorio: `true` Tipo: `string` Modello valido: `.+` `from_number` Il numero di telefono del mittente. Twilio utilizza questo numero di telefono per iniziare il messaggio. Questa proprietà è obbligatoria se il parametro `DefaultFromPhoneNumber` non è configurato. Se `DefaultFromPhoneNumber` è stato configurato, puoi utilizzare questa proprietà per ignorare quello predefinito. Obbligatorio: `false` Tipo: `string` Modello valido: `\+[1-9]+` `retries` Il numero di tentativi. Il valore predefinito è 0. Obbligatorio: `false` Tipo: `integer` `id` Un ID arbitrario della richiesta. Questa proprietà viene utilizzata per associare una richiesta di input a una risposta di output. Obbligatorio: `true` Tipo: `string` Modello valido: `.+` **Input di esempio** ``` { "request": { "recipient": { "name": "Darla", "phone_number": "+12345000000", "voice_message_location": "https://some-public-TwiML" }, "from_number": "+19999999999", "retries": 3 }, "id": "request123" } ``` ## Dati di output Questo connettore pubblica le informazioni di stato come dati di output su un argomento MQTT. **Filtro argomento in sottoscrizione** `twilio/message/status` **Output di esempio: Operazione riuscita** ``` { "response": { "status": "success", "payload": { "from_number": "+19999999999", "messages": { "message_status": "queued", "to_number": "+12345000000", "name": "Darla" } } }, "id": "request123" } ``` **Esempio di output: Errore** ``` { "response": { "status": "fail", "error_message": "Recipient name cannot be None", "error": "InvalidParameter", "payload": None } }, "id": "request123" } ``` La proprietà `payload` nell'output è la risposta dall'API Twilio al momento dell'invio del messaggio. Se il connettore rileva che i dati di input non sono validi (ad esempio, non è specificato un campo di input obbligatorio), il connettore restituisce un errore e imposta il valore su `None`. Di seguito vengono riportati payload di esempio: ``` { 'from_number':'+19999999999', 'messages': { 'name':'Darla', 'to_number':'+12345000000', 'message_status':'undelivered' } } ``` ``` { 'from_number':'+19999999999', 'messages': { 'name':'Darla', 'to_number':'+12345000000', 'message_status':'queued' } } ``` ## Esempio di utilizzo Usa i seguenti passaggi di alto livello per configurare una funzione Lambda di esempio di Python 3.7 che puoi usare per provare il connettore. **Nota** Gli argomenti [Nozioni di base sui connettori Greengrass (console)](connectors-console.md) e [Nozioni di base sui connettori Greengrass (CLI)](connectors-cli.md) contengono passaggi end-to-end che mostrano come configurare, distribuire e testare il connettore notifiche Twilio Notifications. 1. Assicurarsi di soddisfare i [requisiti](#twilio-notifications-connector-req) per il connettore. 1. Crea e pubblica una funzione Lambda che invia dati di input al connettore. Salvare il [codice di esempio](#twilio-notifications-connector-usage-example) come file PY. Scarica e decomprimi il [AWS IoT Greengrass Core SDK per Python](lambda-functions.md#lambda-sdks-core). Quindi, crea un pacchetto zip che contiene il file PY e la cartella `greengrasssdk` a livello root. Questo pacchetto zip è il pacchetto di distribuzione in cui carichi. AWS Lambda Dopo aver creato la funzione Python 3.7 Lambda, pubblica una versione della funzione e crea un alias. 1. Configurare il gruppo Greengrass. 1. Aggiungi la funzione Lambda tramite il relativo alias (consigliato). Configura il ciclo di vita Lambda come longevo (o nella `"Pinned": true` CLI). 1. Aggiungi la risorsa segreta richiesta e concedi l'accesso in lettura alla funzione Lambda. 1. Aggiungere il connettore e configurarne i relativi [parametri](#twilio-notifications-connector-param). 1. Aggiungere sottoscrizioni che consentono al connettore di ricevere [i dati di input](#twilio-notifications-connector-data-input) e inviare [i dati di output](#twilio-notifications-connector-data-output) nei filtri degli argomenti supportati. + Imposta la funzione Lambda come origine, il connettore come destinazione e utilizza un filtro per argomenti di input supportato. + Imposta il connettore come origine, AWS IoT Core come destinazione e utilizza un filtro per l’argomento di output supportato. Utilizzi questo abbonamento per visualizzare i messaggi di stato nella AWS IoT console. 1. Distribuisci il gruppo. 1. Nella AWS IoT console, nella pagina **Test**, sottoscrivi l'argomento relativo ai dati di output per visualizzare i messaggi di stato dal connettore. La funzione Lambda di esempio è di lunga durata e inizia a inviare messaggi subito dopo l'implementazione del gruppo. Al termine del test, puoi impostare il ciclo di vita Lambda su richiesta (o nella CLI) e `"Pinned": false` distribuire il gruppo. Ciò impedisce alla funzione di inviare messaggi. ### Esempio L'esempio seguente della funzione Lambda invia un messaggio di input al connettore. Questo esempio attiva un messaggio di testo. ``` import greengrasssdk import json iot_client = greengrasssdk.client('iot-data') TXT_INPUT_TOPIC = 'twilio/txt' CALL_INPUT_TOPIC = 'twilio/call' def publish_basic_message(): txt = { "request": { "recipient" : { "name": "Darla", "phone_number": "+12345000000", "message": 'Hello from the edge' }, "from_number" : "+19999999999" }, "id" : "request123" } print("Message To Publish: ", txt) client.publish(topic=TXT_INPUT_TOPIC, payload=json.dumps(txt)) publish_basic_message() def lambda_handler(event, context): return ``` ## Licenze Il connettore Twilio Notifications include le seguenti terze parti: software/licensing + [twilio-python](https://github.com/twilio/twilio-python)/MIT Questo connettore è rilasciato ai sensi del contratto di [licenza del software Greengrass Core](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf). ## Changelog La tabella seguente descrive le modifiche apportate a ciascuna versione del connettore. | Versione | Modifiche | | --- | --- | | 5 | Aggiunto il parametro `IsolationMode` per configurare la modalità di containerizzazione per il connettore. | | 4 | È stato aggiornato il runtime Lambda a Python 3.7, che modifica i requisiti di runtime. | | 3 | Correggere per ridurre l'eccessiva registrazione di log. | | 2 | Miglioramenti e correzioni di bug minori. | | 1 | Versione iniziale. | Un gruppo Greengrass può contenere una sola versione del connettore alla volta. Per informazioni sull'aggiornamento di una versione del connettore, consulta [Aggiornamento delle versioni dei connettori](connectors.md#upgrade-connector-versions). ## Consulta anche + [Integrazione con servizi e protocolli tramite i connettori Greengrass](connectors.md) + [Nozioni di base sui connettori Greengrass (console)](connectors-console.md) + [Nozioni di base sui connettori Greengrass (CLI)](connectors-cli.md) + [Riferimento all'API Twilio](https://www.twilio.com/docs/api)