Le module SMTP personnalisé ajoute des paramètres de base pour vous permettre d'envoyer des e-mails directement depuis votre application.
Pour que le formulaire d'envoi de lettres apparaisse dans l'application, vous devez ajouter les paramètres manquants et les éléments nécessaires. L'algorithme des actions sera le suivant :
- Ajoutez une page ou une fenêtre où se trouvera le formulaire de lettre.
- Connectez le module, ajoutez-y les paramètres du serveur SMTP, ainsi que votre nom d'utilisateur et votre mot de passe.
- Créez un processus métier, un point de terminaison et un formulaire liés au module.
Montrons comment procéder dans une application Web en utilisant le service de messagerie Gmail comme exemple.
Créer une page
Allez dans l'éditeur et créez une nouvelle page à partir de laquelle vous publierez. Indiquez le nom de votre page ("Titre"), son adresse ("URL de la page"), et les groupes d'utilisateurs qui peuvent envoyer des messages ("Afficher pour les groupes"). Cliquez sur "Enregistrer".
Enregistrez vos modifications et accédez au bloc de module.
Ajouter et configurer un module
Recherchez le module SMTP personnalisé dans l'onglet Marketplace et cliquez sur le bouton Installer pour l'ajouter à l'application.
Allez dans l'onglet "Installé", où se trouvent tous les modules installés dans votre application, et cliquez sur la case "SMTP personnalisé" pour ouvrir ses paramètres. Des informations de base sur le module et un bouton pour le supprimer de l'application sont affichés sur la gauche. A droite se trouvent les champs que vous devez remplir :
- Dans les champs "Connexion" et "Mot de passe", entrez les données de la boîte aux lettres à partir de laquelle vous enverrez des messages.
- Spécifiez les paramètres de connexion SMTP - ils sont différents pour chaque service de messagerie. Par défaut, les paramètres Gmail sont ajoutés au module.
- Dans le champ "Nom de l'expéditeur", entrez le nom qui sera affiché aux destinataires de vos lettres.
Important! Pour envoyer des messages via Gmail, vous devez activer les applications tierces dans votre compte Google.
Pour plus d'informations sur ce que sont les modules, comment les mettre à jour et les personnaliser, consultez notre documentation .
N'oubliez pas de sauvegarder vos modifications.
Création d'un processus métier, d'un endpoint et d'un formulaire
Le processus métier , le point de terminaison et le formulaire sont des éléments interdépendants qu'il est important de configurer de manière cohérente. En interagissant les uns avec les autres, ils compléteront la configuration de votre application - et le formulaire d'envoi de message apparaîtra sur la page.
Vous pouvez en savoir plus sur ces éléments dans notre documentation .
Processus d'affaires
Allez dans l'onglet "Logique métier" et cliquez sur le bouton pour créer un nouveau processus métier.
Saisissez le nom du processus (obligatoire), sa description (facultatif) et cliquez sur le bouton "Créer".
Chaque processus métier dans l'éditeur est visuellement divisé en blocs - des éléments constitutifs responsables de différentes fonctions. Lorsqu'un nouveau processus est créé, "Début" et "Fin" y apparaissent automatiquement. Tous les autres blocs que vous pouvez ajouter seront affichés sur la gauche.
Après l'installation, le module "SMTP personnalisé" a ajouté "SMTP personnalisé : envoyer un e-mail" à cette liste. Pour inclure ce bloc dans un processus métier, faites-le glisser vers le champ de l'éditeur à l'aide du pointeur de la souris. La fenêtre "Custom SMTP : Send Email" apparaît, dont les champs contiennent les variables dont dépend le contenu de votre futur formulaire d'envoi de message :
- "Sujet" - le sujet de la lettre ;
- "Corps" - un champ avec le texte de la lettre ;
- "À" - l'adresse du destinataire ;
- "Cc" - adresse pour envoyer une copie ;
- "De nom" - le nom de l'expéditeur ;
- "Cci" est l'adresse à laquelle envoyer la copie carbone invisible.
Vous devez maintenant lier "Start", "Custom SMTP: Send Email" et "End" - pour montrer qu'ils constituent un seul processus métier :
1. Déplacez le pointeur de la souris sur le champ "Démarrer" dans le bloc "Démarrer", maintenez le bouton gauche de la souris enfoncé et balayez vers le champ "Entrée" dans le bloc "SMTP personnalisé : envoyer un e-mail" - une connexion est établie entre les blocs.
2. De même, créez un lien entre le champ "Out" du bloc "Custom SMTP : Send Email" et le champ "End" du bloc "End"
Maintenant, dans le bloc "Démarrer", vous devez créer de nouveaux champs (variables) et les associer à des variables dans le bloc "SMTP personnalisé : envoyer un e-mail". Les champs que vous ajoutez au bloc "Démarrer" apparaîtront dans votre formulaire de soumission de message. Imaginez que vous n'enverrez pas de copies et de copies cachées, donc le bloc "Démarrer" contiendra les champs suivants :
- "Sender" (nom de l'expéditeur) - associé à from_name ;
- "Adresse" (à qui elle a été envoyée) - associée à "à" ;
- "Sujet" (sujet); - associé au "sujet" (les noms de variables dans différents blocs peuvent être identiques) ;
- "Message" (texte de la lettre) - associé au "corps".
Pour lier des variables, leur type doit correspondre. Le type d'une variable peut être visualisé en cliquant sur le bloc dans lequel elle est contenue et en ouvrant le menu d'édition.
Dans les champs des blocs, à côté de chaque variable, il y a une icône dont la couleur et la forme dépendent de son type - pour faciliter la navigation. Dans notre exemple, il existe deux types de variables :
- "Subject", "body" et "from_name" sont de type "String",
- To, cc et bcc sont de type Email Array.
Création de variables
Pour créer la première variable dans le bloc "Démarrer", cliquez dessus - une liste s'affichera (tant qu'elle est vide). Cliquez sur "+".
Dans la fenêtre ouverte, entrez le nom de la variable : nom "expéditeur", tapez "Chaîne". Cliquez sur "Créer".
De même, ajoutez "adresse", "sujet" et "message". Maintenant, la liste des variables dans le bloc "Démarrer" ressemble à ceci :
Liez-les aux variables correspondantes dans le bloc SMTP personnalisé : envoyer un e-mail :
C'est ainsi que les relations entre les variables devraient ressembler à la fin. Enregistrez vos modifications et passez à la création du point de terminaison.
Point final
Cliquez sur "Créer un point de terminaison" - vous vous retrouverez dans les paramètres de l'onglet "Business Logic", ici vous devez spécifier les paramètres suivants :
- "Route du point de terminaison" - le nom du point de terminaison, par lequel vous comprendrez sa fonction ;
- "Endpoint Groups" - le nom du groupe dans lequel il sera situé ;
- "Type de demande" - sélectionnez "POST" ;
- "Processus métier" - sélectionnez le processus métier send_email que vous avez créé.
Allez ensuite dans l'onglet "Middleware".
Dans l'onglet "Middleware", vous devez configurer les droits pour effectuer des actions avec ce endpoint (et donc lancer le processus métier associé). En d'autres termes, vous préciserez qui peut envoyer des emails depuis votre application. Pour ce faire, vous devez modifier le paramètre du jeton d'autorisation "Token Auth".
Attention! Si ce paramètre n'est pas modifié, tous les utilisateurs auront le droit d'envoyer des e-mails !
Cliquez sur l'icône d'engrenage à côté de "Token Auth". Dans la fenêtre ouverte, activez le sélecteur, dans le champ "Groupes autorisés", sélectionnez le groupe "Admins" (ou tout autre auquel vous souhaitez donner accès). Cliquez sur "Enregistrer"
Enregistrez maintenant le point de terminaison en cliquant sur "Créer".
Les processus d'envoi de messages sont configurés. Vous pouvez maintenant créer une représentation visuelle du formulaire de soumission de message.
Formulaire
Pour créer un formulaire, retournez dans l'éditeur d'application web, dans l'onglet que vous avez créé précédemment. Faites glisser un élément Form sur le canevas de la page.
Dans la fenêtre ouverte, cliquez sur "Créer un enregistrement", la liste des endpoints disponibles s'affichera dans le champ "Enregistrer l'enregistrement dans" - sélectionnez celui que vous venez de créer. Cliquez sur "Attribuer".
La forme que vous avez créée apparaît sur le canevas. Cliquez sur l'image de l'engrenage pour accéder à ses paramètres.
Dans l'onglet "Look & Fee", entrez un titre pour le formulaire dans le champ "Titre". Ici, vous pouvez également modifier son apparence et voir le nom sous lequel il est enregistré dans les paramètres.
Dans l'onglet "Données" - informations sur le mode du formulaire et le point de terminaison. Ici aussi, vous pouvez modifier l'emplacement des champs en les déplaçant les uns par rapport aux autres.
Organisez les champs dans un ordre logique : Expéditeur, Adresse, Objet, Message. Pour modifier les paramètres détaillés de chaque champ (par exemple, son nom) - cliquez sur l'icône d'engrenage à côté de celui-ci. Cliquez sur "Enregistrer" pour enregistrer vos modifications.
Ajouter un bouton pour un formulaire
Pour que le formulaire fonctionne, vous devez ajouter un bouton de confirmation d'envoi. Utilisez l'élément "Bouton" - faites-le glisser avec le pointeur de la souris dans la zone située sous le formulaire.
Ouvrez les paramètres du bouton en cliquant dessus. Dans l'onglet "Look & Feel", changez le "Label" (le nom du bouton qui sera visible dans l'application) et le "Name" (le nom qui sera affiché dans les paramètres).
Dans l'onglet "Déclencheurs", ajoutez une action au déclencheur onClick : dans le champ "Cible", sélectionnez votre formulaire, dans le champ "Action", sélectionnez "Soumettre le formulaire". Cliquez sur "Enregistrer".
Conservation, publication et vérification
Enregistrez toutes les modifications apportées, publiez-les, cliquez sur l'icône d'accès à l'application.
Entrez les données pour envoyer le message. Si vous laissez le champ de l'expéditeur vide, le nom que vous avez entré dans les paramètres du module sera automatiquement ajouté. Envoyez un message de test à n'importe quelle adresse e-mail à laquelle vous avez accès.
Après l'envoi, un message de confirmation devrait apparaître et une lettre avec les données spécifiées apparaîtra au destinataire dans le dossier Boîte de réception.
Si vous avez tout fait conformément aux instructions, mais au lieu de confirmer qu'une erreur se produit ou que la lettre se retrouve dans le dossier "Spam", écrivez à notre canal de télégramme de support technique.
