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 courrier apparaisse dans l'application, vous devez ajouter les paramètres manquants et les éléments nécessaires. L'algorithme des actions sera le suivant :

  1. Ajoutez une page ou une fenêtre où le formulaire de lettre sera situé.
  2. Connectez le module, ajoutez-y les paramètres du serveur SMTP, ainsi que votre nom d'utilisateur et votre mot de passe.
  3. Créez un processus métier, un point de terminaison et un formulaire liés au module.

Montrons comment faire cela 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 pouvant envoyer des messages ("Afficher pour les groupes"). Cliquez sur « Enregistrer ».

Enregistrez vos modifications et accédez au bloc 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. Sur la droite se trouvent les champs que vous devez remplir :

  1. 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.
  2. 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.
  3. Dans le champ "De nom", saisissez 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 d'enregistrer vos modifications.

Création d'un processus métier, d'un point de terminaison 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 mettre en place de manière cohérente. En interagissant entre eux, 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éé, "Start" et "End" apparaissent automatiquement dans celui-ci. Tous les autres blocs que vous pouvez ajouter seront affichés sur la gauche.

Après l'installation, le module "Custom SMTP" a ajouté "Custom SMTP: Send Email" à 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 « SMTP personnalisé : Envoyer un e-mail » apparaîtra, 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 pour envoyer la copie carbone invisible.

Vous devez maintenant lier « Démarrer », « SMTP personnalisé : envoyer un e-mail » et « Fin » - 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 jusqu'au champ « Dans » dans le bloc « Personnalisé SMTP : Envoyer un e-mail » - une connexion est établie entre les blocs.

2. De même, créez un lien entre le champ "Sortie" du bloc "Custom SMTP : Send Email" et le champ "Fin" du bloc "Fin"

Maintenant, dans le bloc "Démarrer", vous devez créer de nouveaux champs (variables) et les associer à des variables dans le bloc "Personnalisé SMTP : 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'envoyez pas de copies et de copies cachées, donc le bloc "Démarrer" contiendra les champs suivants :

  • « Expéditeur » (nom de l'expéditeur) - associé à from_name ;
  • "Adresse" (à qui il a été envoyé) - associé à "à" ;
  • "Sujet" (sujet); - associé à "sujet" (les noms de variables dans différents blocs peuvent être les mêmes);
  • "Message" (texte de la lettre) - associé au "corps".

Pour lier des variables, elles doivent correspondre en type. 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, saisissez le nom de la variable : nom "expéditeur", tapez "String". 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 :

Voici à quoi devraient ressembler les relations entre les variables à la fin. Enregistrez vos modifications et procédez à la création du point de terminaison.

Point de terminaison

Cliquez sur "Créer un point de terminaison" - vous vous retrouverez dans les paramètres de l'onglet "Logique métier", vous devez ici spécifier les paramètres suivants :

  • "Endpoint route" - le nom du point final, par lequel vous comprendrez sa fonction;
  • « Groupes de points de terminaison » - le nom du groupe dans lequel il sera situé ;
  • "Type de demande" - sélectionnez "POSTER" ;
  • "Processus commercial" - sélectionnez le processus commercial 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 point de terminaison (et, par conséquent, pour lancer le processus métier associé). En d'autres termes, vous préciserez qui peut envoyer des e-mails depuis votre application. Pour ce faire, vous devez modifier le paramétrage du jeton d'autorisation "Token Auth".

Attention! Si ce paramètre n'est pas modifié, alors tous les utilisateurs auront le droit d'envoyer des e-mails !

Cliquez sur l'icône représentant une roue dentée à côté de « Authentification du jeton ». 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.

Former

Pour créer un formulaire, retournez dans l'éditeur de l'application Web, dans l'onglet que vous avez créé précédemment. Faites glisser un élément de formulaire sur le canevas de la page.

Dans la fenêtre ouverte, cliquez sur "Créer un enregistrement", la liste des points de terminaison 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 »l, saisissez 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 de soumission. Utilisez l'élément "Bouton" - faites-le glisser avec le pointeur de la souris vers la zone située sous le formulaire.

Ouvrez les paramètres du bouton en cliquant dessus. Dans l'onglet « Look & Feel », modifiez le « Label » (le nom du bouton qui sera visible dans l'application) et le « Nom » (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 "Envoyer le formulaire". Cliquez sur « Enregistrer ».

Conservation, publication et vérification

Enregistrez toutes les modifications apportées, publiez-les, cliquez sur l'icône aller à l'application.

Entrez les données pour envoyer le message. Si vous laissez le champ expéditeur vide, le nom que vous avez entré dans les paramètres du module sera automatiquement ajouté. Envoyez un message 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 chez le destinataire dans le dossier Boîte de réception.

Si vous avez tout fait selon les instructions, mais au lieu de confirmer qu'une erreur s'est produite ou que la lettre se retrouve dans le dossier "Spam", écrivez à notre canal de télégramme d'assistance technique.