Avis de fin de support : le 7 octobre 2026, AWS le support de. AWS IoT Greengrass Version 1 Après le 7 octobre 2026, vous ne pourrez plus accéder aux AWS IoT Greengrass V1 ressources. Pour plus d'informations, rendez-vous sur [Migrer depuis AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html). Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Connecteur de notifications Twilio **Avertissement** Ce connecteur est passé à la *phase de durée de vie prolongée* et AWS IoT Greengrass ne publiera pas de mises à jour fournissant des fonctionnalités, des améliorations aux fonctionnalités existantes, des correctifs de sécurité ou des corrections de bogues. Pour de plus amples informations, veuillez consulter [AWS IoT Greengrass Version 1 politique de maintenance](maintenance-policy.md). Le [connecteur](connectors.md) Twilio Notifications effectue des appels téléphoniques automatisés ou envoie des SMS via Twilio. Vous pouvez utiliser ce connecteur pour envoyer des notifications en réponse à des événements dans le groupe Greengrass. Pour les appels téléphoniques, le connecteur peut transmettre un message vocal au destinataire. Ce connecteur reçoit les informations du message Twilio dans une rubrique MQTT, puis déclenche une notification Twilio. **Note** Pour un didacticiel expliquant comment utiliser le connecteur de notifications Twilio, voir [Mise en route avec les connecteurs Greengrass (console)](connectors-console.md) ou[Démarrage avec les connecteurs Greengrass (CLI)](connectors-cli.md). Ce connecteur est disponible dans les versions suivantes. | Version | 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` | Pour obtenir des informations sur les changements apportés aux versions, veuillez consulter le [Journal des modifications](#twilio-notifications-connector-changelog). ## Prérequis Ce connecteur possède les critères suivants : ------ #### [ Version 4 - 5 ] + AWS IoT Greengrass Logiciel de base v1.9.3 ou version ultérieure. AWS IoT Greengrass doit être configuré pour prendre en charge les secrets locaux, comme décrit dans la section [Exigences relatives aux secrets](secrets.md#secrets-reqs). **Note** Cette exigence inclut l'autorisation d'accéder aux secrets de votre Gestionnaire de Secrets. *Si vous utilisez le rôle de service Greengrass par défaut, Greengrass est autorisé à obtenir les valeurs des secrets dont le nom commence par greengrass-.* + [Python](https://www.python.org/) version 3.7 ou 3.8 installé sur le périphérique principal et ajouté à la variable d'environnement PATH. **Note** Pour utiliser Python 3.8, exécutez la commande suivante pour créer un lien symbolique entre le dossier d'installation par défaut de Python 3.7 et les fichiers binaires Python 3.8 installés. ``` sudo ln -s path-to-python-3.8/python3.8 /usr/bin/python3.7 ``` Ceci configure votre appareil de sorte qu'il réponde aux exigence de Python pour AWS IoT Greengrass. + Un SID de compte Twilio, un jeton d'authentification et un numéro de téléphone Twilio. Une fois que vous avez créé un projet Twilio, ces valeurs sont disponibles sur le tableau de bord du projet. **Note** Vous pouvez utiliser un compte d'essai Twilio. Si vous utilisez un compte d'essai, vous devez ajouter des numéros de téléphone non destinataires de Twilio à une liste de numéros de téléphone vérifiés. Pour plus d'informations, consultez [Comment travailler avec votre compte d'essai gratuit Twilio](https://www.twilio.com/docs/usage/tutorials/how-to-use-your-free-trial-account). + Un secret de type texte dans AWS Secrets Manager lequel est stocké le jeton d'authentification Twilio. Pour plus d'informations, consultez la section [Création d'un secret de base](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_create-basic-secret.html) dans le *guide de AWS Secrets Manager l'utilisateur*. **Note** Pour créer le secret dans la console Secrets Manager, entrez votre jeton dans l'onglet **Plaintext**. N'incluez pas de guillemets ni d'autres mises en forme. Dans l'API, spécifiez le jeton comme valeur de la `SecretString` propriété. + Une ressource secrète du groupe Greengrass qui fait référence au secret du Secrets Manager. Pour de plus amples informations, veuillez consulter [Déployez les secrets jusqu'au AWS IoT Greengrass cœur](secrets.md). ------ #### [ Versions 1 - 3 ] + AWS IoT Greengrass Logiciel principal v1.7 ou version ultérieure. AWS IoT Greengrass doit être configuré pour prendre en charge les secrets locaux, comme décrit dans la section [Exigences relatives aux secrets](secrets.md#secrets-reqs). **Note** Cette exigence inclut l'autorisation d'accéder aux secrets de votre Gestionnaire de Secrets. *Si vous utilisez le rôle de service Greengrass par défaut, Greengrass est autorisé à obtenir les valeurs des secrets dont le nom commence par greengrass-.* + [Python](https://www.python.org/) version 2.7 installé sur le périphérique principal et ajouté à la variable d'environnement PATH. + Un SID de compte Twilio, un jeton d'authentification et un numéro de téléphone Twilio. Une fois que vous avez créé un projet Twilio, ces valeurs sont disponibles sur le tableau de bord du projet. **Note** Vous pouvez utiliser un compte d'essai Twilio. Si vous utilisez un compte d'essai, vous devez ajouter des numéros de téléphone non destinataires de Twilio à une liste de numéros de téléphone vérifiés. Pour plus d'informations, consultez [Comment travailler avec votre compte d'essai gratuit Twilio](https://www.twilio.com/docs/usage/tutorials/how-to-use-your-free-trial-account). + Un secret de type texte dans AWS Secrets Manager lequel est stocké le jeton d'authentification Twilio. Pour plus d'informations, consultez la section [Création d'un secret de base](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_create-basic-secret.html) dans le *guide de AWS Secrets Manager l'utilisateur*. **Note** Pour créer le secret dans la console Secrets Manager, entrez votre jeton dans l'onglet **Plaintext**. N'incluez pas de guillemets ni d'autres mises en forme. Dans l'API, spécifiez le jeton comme valeur de la `SecretString` propriété. + Une ressource secrète du groupe Greengrass qui fait référence au secret du Secrets Manager. Pour de plus amples informations, veuillez consulter [Déployez les secrets jusqu'au AWS IoT Greengrass cœur](secrets.md). ------ ## Paramètres du connecteur Ce connecteur fournit les paramètres suivants : ------ #### [ Version 5 ] `TWILIO_ACCOUNT_SID` Le SID du compte Twilio qui est utilisé pour appeler l'API Twilio. Nom affiché dans la AWS IoT console : SID du **compte Twilio** Nécessaire : `true` Type : `string` Modèle valide : `.+` `TwilioAuthTokenSecretArn` L'ARN du secret Secrets Manager qui stocke le jeton d'authentification Twilio. Il est utilisé pour accéder à la valeur du secret local sur le noyau. Nom affiché dans la AWS IoT console : **ARN du code secret du jeton d'authentification Twilio** Nécessaire : `true` Type : `string` Modèle valide : `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 de la ressource du secret dans le groupe Greengrass qui référence le secret du jeton d'authentification Twilio. Nom affiché dans la AWS IoT console : ressource de jeton d'**authentification Twilio** Nécessaire : `true` Type : `string` Modèle valide : `.+` `DefaultFromPhoneNumber` Le numéro de téléphone activé par Twilio que Twilio utilise pour envoyer des messages. Twilio utilise ce numéro pour initier le texte ou l'appel. + Si vous ne configurez pas un numéro de téléphone par défaut, vous devez spécifier un numéro de téléphone dans la propriété `from_number` dans le corps du message d'entrée. + Si vous configurez un numéro de téléphone par défaut, vous pouvez, si vous le souhaitez, remplacer le numéro par défaut en spécifiant la propriété `from_number` dans le corps du message d'entrée. Nom d'affichage dans la AWS IoT console : **par défaut, il s'agit du numéro de téléphone** Nécessaire : `false` Type : `string` Modèle valide : `^$|\+[0-9]+` `IsolationMode` Mode [conteneurisation](connectors.md#connector-containerization) de ce connecteur. La valeur par défaut est`GreengrassContainer`, ce qui signifie que le connecteur s'exécute dans un environnement d'exécution isolé à l'intérieur du AWS IoT Greengrass conteneur. Le paramètre de conteneurisation par défaut pour le groupe ne s'applique pas aux connecteurs. Nom affiché dans la AWS IoT console : **mode d'isolation du conteneur** Nécessaire : `false` Type : `string` Valeurs valides : `GreengrassContainer` ou `NoContainer` Modèle valide : `^NoContainer$|^GreengrassContainer$` ------ #### [ Version 1 - 4 ] `TWILIO_ACCOUNT_SID` Le SID du compte Twilio qui est utilisé pour appeler l'API Twilio. Nom affiché dans la AWS IoT console : SID du **compte Twilio** Nécessaire : `true` Type : `string` Modèle valide : `.+` `TwilioAuthTokenSecretArn` L'ARN du secret Secrets Manager qui stocke le jeton d'authentification Twilio. Il est utilisé pour accéder à la valeur du secret local sur le noyau. Nom affiché dans la AWS IoT console : **ARN du code secret du jeton d'authentification Twilio** Nécessaire : `true` Type : `string` Modèle valide : `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 de la ressource du secret dans le groupe Greengrass qui référence le secret du jeton d'authentification Twilio. Nom affiché dans la AWS IoT console : ressource de jeton d'**authentification Twilio** Nécessaire : `true` Type : `string` Modèle valide : `.+` `DefaultFromPhoneNumber` Le numéro de téléphone activé par Twilio que Twilio utilise pour envoyer des messages. Twilio utilise ce numéro pour initier le texte ou l'appel. + Si vous ne configurez pas un numéro de téléphone par défaut, vous devez spécifier un numéro de téléphone dans la propriété `from_number` dans le corps du message d'entrée. + Si vous configurez un numéro de téléphone par défaut, vous pouvez, si vous le souhaitez, remplacer le numéro par défaut en spécifiant la propriété `from_number` dans le corps du message d'entrée. Nom d'affichage dans la AWS IoT console : **par défaut, il s'agit du numéro de téléphone** Nécessaire : `false` Type : `string` Modèle valide : `^$|\+[0-9]+` ------ ### Exemple de création de connecteur (AWS CLI) L'exemple de commande CLI suivant crée un `ConnectorDefinition` avec une version initiale qui contient le connecteur 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" } } ] }' ``` Pour des didacticiels expliquant comment ajouter le connecteur Twilio Notifications à un groupe, consultez [Démarrage avec les connecteurs Greengrass (CLI)](connectors-cli.md) et[Mise en route avec les connecteurs Greengrass (console)](connectors-console.md). ## Données d'entrée Ce connecteur accepte les informations des messages Twilio sur deux sujets MQTT. Les messages d'entrée doivent être au format JSON. + Informations des SMS dans la rubrique `twilio/txt`. + Informations des messages vocaux dans la rubrique `twilio/call`. **Note** La charge utile d'un message entrant peut inclure un SMS (`message`) ou un message vocal (`voice_message_location`), mais pas les deux. **Filtre des rubriques : `twilio/txt`** **Propriétés des messages** `request` Informations sur la notification Twilio. Nécessaire : `true` Type : `object` qui inclut les propriétés suivantes : `recipient` Destinataire du message. Un seul destinataire est pris en charge. Nécessaire : `true` Type : `object` qui inclut les propriétés suivantes : `name` le nom du destinataire. Nécessaire : `true` Type : `string` Modèle valide : `.*` `phone_number` le numéro de téléphone du destinataire. Nécessaire : `true` Type : `string` Modèle valide : `\+[1-9]+` `message` le contenu du message du SMS. Seuls les SMS sont pris en charge dans cette rubrique. Pour les messages vocaux, utilisez `twilio/call`. Nécessaire : `true` Type : `string` Modèle valide : `.+` `from_number` Le numéro de téléphone de l'expéditeur. Twilio utilise ce numéro pour initier le message. Cette propriété est obligatoire si le paramètre `DefaultFromPhoneNumber` n'est pas configuré. Si `DefaultFromPhoneNumber` est configuré, vous pouvez utiliser cette propriété pour remplacer le numéro par défaut. Nécessaire : `false` Type : `string` Modèle valide : `\+[1-9]+` `retries` Nombre de nouvelles tentatives. La valeur par défaut est 0. Nécessaire : `false` Type : `integer` `id` ID arbitraire de la demande. Cette propriété est utilisée pour mapper une demande d'entrée à une réponse de sortie. Nécessaire : `true` Type : `string` Modèle valide : `.+` **Exemple d'entrée** ``` { "request": { "recipient": { "name": "Darla", "phone_number": "+12345000000", "message": "Hello from the edge" }, "from_number": "+19999999999", "retries": 3 }, "id": "request123" } ``` **Filtre des rubriques : `twilio/call`** **Propriétés des messages** `request` Informations sur la notification Twilio. Nécessaire : `true` Type : `object` qui inclut les propriétés suivantes : `recipient` Destinataire du message. Un seul destinataire est pris en charge. Nécessaire : `true` Type : `object` qui inclut les propriétés suivantes : `name` le nom du destinataire. Nécessaire : `true` Type : `string` Modèle valide : `.+` `phone_number` le numéro de téléphone du destinataire. Nécessaire : `true` Type : `string` Modèle valide : `\+[1-9]+` `voice_message_location` URL du contenu audio du message vocal. Elle doit être en format TwiML. Seuls les messages vocaux sont pris en charge dans cette rubrique. Pour les SMS, utilisez `twilio/txt`. Nécessaire : `true` Type : `string` Modèle valide : `.+` `from_number` Le numéro de téléphone de l'expéditeur. Twilio utilise ce numéro pour initier le message. Cette propriété est obligatoire si le paramètre `DefaultFromPhoneNumber` n'est pas configuré. Si `DefaultFromPhoneNumber` est configuré, vous pouvez utiliser cette propriété pour remplacer le numéro par défaut. Nécessaire : `false` Type : `string` Modèle valide : `\+[1-9]+` `retries` Nombre de nouvelles tentatives. La valeur par défaut est 0. Nécessaire : `false` Type : `integer` `id` ID arbitraire de la demande. Cette propriété est utilisée pour mapper une demande d'entrée à une réponse de sortie. Nécessaire : `true` Type : `string` Modèle valide : `.+` **Exemple d'entrée** ``` { "request": { "recipient": { "name": "Darla", "phone_number": "+12345000000", "voice_message_location": "https://some-public-TwiML" }, "from_number": "+19999999999", "retries": 3 }, "id": "request123" } ``` ## Données de sortie Ce connecteur publie des informations d'état sous forme de données de sortie dans une rubrique MQTT. **Filtre de rubrique dans l'abonnement** `twilio/message/status` **Exemple de sortie : réussite** ``` { "response": { "status": "success", "payload": { "from_number": "+19999999999", "messages": { "message_status": "queued", "to_number": "+12345000000", "name": "Darla" } } }, "id": "request123" } ``` **Exemple de sortie : échec** ``` { "response": { "status": "fail", "error_message": "Recipient name cannot be None", "error": "InvalidParameter", "payload": None } }, "id": "request123" } ``` La propriété `payload` dans la sortie est la réponse de l'API Twilio lorsque le message est envoyé. Si le connecteur détecte que les données d'entrée ne sont pas valides (par exemple, elles ne spécifient pas un champ d'entrée obligatoire), le connecteur renvoie une erreur et définit la valeur sur `None`. Voici quelques exemples de charges utiles : ``` { 'from_number':'+19999999999', 'messages': { 'name':'Darla', 'to_number':'+12345000000', 'message_status':'undelivered' } } ``` ``` { 'from_number':'+19999999999', 'messages': { 'name':'Darla', 'to_number':'+12345000000', 'message_status':'queued' } } ``` ## Exemple d'utilisation Suivez les étapes de haut niveau suivantes pour configurer un exemple de fonction Lambda en Python 3.7 que vous pouvez utiliser pour tester le connecteur. **Note** Les [Démarrage avec les connecteurs Greengrass (CLI)](connectors-cli.md) rubriques [Mise en route avec les connecteurs Greengrass (console)](connectors-console.md) et contiennent des end-to-end étapes qui montrent comment configurer, déployer et tester le connecteur Twilio Notifications. 1. Veillez à répondre aux [conditions requises](#twilio-notifications-connector-req) pour le connecteur. 1. Créez et publiez une fonction Lambda qui envoie des données d'entrée au connecteur. Enregistrez l'[exemple de code](#twilio-notifications-connector-usage-example) en tant que fichier PY. Téléchargez et décompressez le [SDK AWS IoT Greengrass de base pour Python](lambda-functions.md#lambda-sdks-core). Ensuite, créez un package zip contenant le fichier PY et le dossier `greengrasssdk` au niveau racine. Ce package zip est le package de déploiement vers lequel vous effectuez le téléchargement AWS Lambda. Après avoir créé la fonction Lambda de Python 3.7, publiez une version de la fonction et créez un alias. 1. Configurez votre groupe Greengrass. 1. Ajoutez la fonction Lambda par son alias (recommandé). Configurez le cycle de vie Lambda comme étant de longue durée (ou dans `"Pinned": true` la CLI). 1. Ajoutez la ressource secrète requise et accordez un accès en lecture à la fonction Lambda. 1. Ajoutez le connecteur et configurez ses [paramètres](#twilio-notifications-connector-param). 1. Ajoutez des abonnements qui permettent au connecteur de recevoir des [données d'entrée](#twilio-notifications-connector-data-input) et d'envoyer des [données de sortie](#twilio-notifications-connector-data-output) sur des filtres de rubrique pris en charge. + Définissez la fonction Lambda comme source, le connecteur comme cible et utilisez un filtre de rubrique d'entrée compatible. + Définissez le connecteur en tant que source, AWS IoT Core en tant que cible et utilisez un filtre de rubrique de sortie pris en charge. Vous utilisez cet abonnement pour afficher les messages d'état dans la AWS IoT console. 1. Déployez le groupe. 1. Dans la AWS IoT console, sur la page **Test**, abonnez-vous à la rubrique relative aux données de sortie pour consulter les messages d'état provenant du connecteur. L'exemple de fonction Lambda a une longue durée de vie et commence à envoyer des messages immédiatement après le déploiement du groupe. Lorsque vous avez terminé les tests, vous pouvez définir le cycle de vie Lambda à la demande (ou `"Pinned": false` dans la CLI) et déployer le groupe. Cela empêche la fonction d'envoyer des messages. ### exemple L'exemple suivant de fonction Lambda envoie un message d'entrée au connecteur. Cet exemple déclenche l'envoi d'un SMS. ``` 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 ``` ## Licences Le connecteur Twilio Notifications inclut les logiciels/licences tiers suivants : + [twilio de python](https://github.com/twilio/twilio-python)/MIT Ce connecteur est publié dans le cadre du contrat de [licence logicielle Greengrass Core](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf). ## Journal des modifications Le tableau suivant décrit les modifications apportées à chaque version du connecteur. | Version | Modifications | | --- | --- | | 5 | Ajout du paramètre `IsolationMode` pour configurer le mode de conteneurisation du connecteur. | | 4 | Mise à niveau de l'environnement d'exécution Lambda vers Python 3.7, ce qui modifie les exigences d'exécution. | | 3 | Correctif pour réduire la journalisation excessive. | | 2 | Correctifs de bogues mineurs et améliorations. | | 1 | Première version. | Un groupe Greengrass ne peut contenir qu'une seule version du connecteur à la fois. Pour de plus amples informations sur la mise à niveau d'une version de connecteur, veuillez consulter [Mise à niveau des versions du connecteur](connectors.md#upgrade-connector-versions). ## Consultez aussi + [Intégrer à des services et protocoles à l'aide de connecteurs Greengrass](connectors.md) + [Mise en route avec les connecteurs Greengrass (console)](connectors-console.md) + [Démarrage avec les connecteurs Greengrass (CLI)](connectors-cli.md) + [Twilio API Reference](https://www.twilio.com/docs/api)