Send Mail

Ce bloc de fonction permet d'envoyer des e-mails via Gmail SMTP. Il est conçu pour l'envoi de messages en texte brut et, en option, de pièces jointes depuis des workflows. Le bloc suppose que le compte expéditeur est configuré pour l'accès à l'API Gmail / SMTP.

📥 Entrées

Subject - Le sujet de l'e-mail (chaîne de caractères).

Content - Le corps du message (chaîne de caractères, texte brut).

Sender Address - L'adresse Gmail qui enverra le message (chaîne). Doit être configurée pour l'utilisation SMTP/API.

Mail API Password - Mot de passe ou clé API pour authentifier l'adresse expéditrice (chaîne).

Receiver Address - L'adresse e-mail du destinataire (chaîne).

Attachment File Path - Chemin complet facultatif du fichier à joindre (chaîne). Laisser vide si pas de pièce jointe.

Trigger - Signal booléen qui déclenche l'envoi lorsqu'il est actif.

📤 Sorties

Success - Booléen indiquant si l'envoi a réussi.

🕹️ Contrôles

Send - Il n'y a pas de bouton d'envoi séparé ; l'envoi est déclenché en fournissant un Trigger actif au bloc. Configurez les champs du message via les entrées.

⚙️ Mécanisme d'exécution

• Le bloc attend que les entrées soient fournies et que le Trigger devienne actif.

• Lors du déclenchement, il tente d'authentifier le compte expéditeur fourni et d'envoyer le message au destinataire.

• Les pièces jointes sont incluses si un chemin de fichier valide est fourni dans Attachment File Path.

• Le bloc renvoie Success à True en cas d'envoi réussi, sinon False.

• En cas d'échec d'authentification ou de livraison dû à un problème transitoire, le bloc tentera automatiquement de se reconnecter et de renvoyer.

✨ Fonctionnalités

• Envoi d'e-mails en texte brut via Gmail SMTP.

• Prise en charge d'une pièce jointe unique via un chemin de fichier.

• Utilisation d'une session mise en cache pour éviter une ré-authentification à chaque déclenchement lorsque possible.

• Reconnexion et nouvelle tentative automatiques en cas de problèmes de session transitoires.

📝 Instructions d'utilisation

1. Fournissez les identifiants de l'expéditeur et activez l'accès SMTP/API sur le compte Gmail.

2. Remplissez les entrées Subject, Content, Sender Address, Mail API Password et Receiver Address.

3. Facultatif : indiquez un chemin de fichier dans Attachment File Path pour joindre un fichier.

4. Activez l'entrée Trigger pour envoyer le message.

5. Surveillez la sortie Success pour confirmer la livraison.

💡 Astuces

• Pour capturer et joindre une image depuis une caméra, combinez ce bloc avec Camera USB ou Camera IP (ONVIF) et enregistrez la trame avec Image Write ou Image Logger. Fournissez le chemin sauvegardé à Attachment File Path.

• Si vous souhaitez n'envoyer une notification qu'une seule fois lors d'un événement, utilisez Rising Edge ou Logic Input pour générer une impulsion de Trigger unique.

• Construisez le texte du message dynamiquement avec String Merge ou préparez des logs structurés avec Data to JSON avant l'envoi.

• Pour envoyer plusieurs images, utilisez Multi Image Write pour stocker les images puis joignez-les via leurs chemins de fichiers (une à la fois si le bloc le supporte).

🛠️ Dépannage

• Échec d'authentification : vérifiez que Sender Address est activé pour SMTP/API et que Mail API Password est correct. Contrôlez les paramètres de sécurité du compte Gmail.

• Pièce jointe non envoyée : assurez-vous que le chemin dans Attachment File Path pointe vers un fichier existant et accessible depuis l'environnement d'exécution.

• E-mail non reçu : vérifiez l'orthographe de l'adresse destinataire et les dossiers spam/courrier indésirable. Des restrictions réseau ou des pare-feux peuvent bloquer les ports SMTP.

• Trigger ignoré : confirmez que l'entrée Trigger reçoit une valeur explicite True (ou un front montant) au moment de l'exécution.

• Session expirée : le bloc tentera une reconnexion automatique, mais si les échecs persistent, revérifiez les identifiants et la connectivité réseau.

🔒 Confidentialité et sécurité

• Ne stockez pas de mots de passe sensibles dans des projets partagés. Utilisez un gestionnaire de secrets sécurisé si possible.

• Limitez les privilèges du compte expéditeur et activez les mesures de sécurité appropriées sur le compte Gmail utilisé pour l'envoi.