Modèles d'e-mails/SMS

Vous pouvez créer un nombre arbitraire de modèles qui peuvent être utilisés pour les e-mails de confirmation d'inscription, les SMS de résultats à l'arrivée des participants ou l'envoi en masse d'e-mails contenant des informations importantes sur l'événement.

Lorsque vous créez un nouveau modèle, choisissez d'abord le type :

Courriel


Sélectionnez le champ Récepteur (par défaut : Email) qui contient la ou les adresses email qui doivent recevoir les emails, puis définissez l'email de l'expéditeur, le nom de l'expéditeur, éventuellement les adresses email cc/bcc, l'objet et le Contenu qui peut être défini comme du texte simple ou du HTML. Vous pouvez utiliser fields et expressions dans le texte et l'objet de l'e-mail. Vous pouvez également joindre des certificats ou des fichiers à l'e-mail.

Les modèles de courrier électronique sont multilingues et un seul modèle peut donc contenir le contenu de plusieurs langues. Lors de l'envoi d'un modèle d'e-mail par le biais de RACE RESULT 12, la valeur du champ "Langue" par défaut sera utilisée pour déterminer la langue que le participant doit recevoir. Si ce champ est vide ou s'il n'y a pas de modèle pour cette langue pour un participant, la langue utilisée dans le logiciel sera rétablie.

Important : vous ne pouvez envoyer qu'un maximum de 10 courriels par l'intermédiaire du serveur SMTP de RACE RESULT, sans compter les courriels de confirmation d'inscription automatique. Cela vous permet de tester la fonctionnalité du courrier électronique, mais ne vous permet pas d'envoyer des courriels en masse.

Si vous souhaitez envoyer plus de 10 messages, vous devrez indiquer les coordonnées de votre propre serveur SMTP dans le coin inférieur gauche. Notez que de nombreuses plateformes de messagerie standard imposent des limites strictes aux connexions SMTP et peuvent ne pas fonctionner de manière fiable, voire ne pas fonctionner du tout. 

SMS


Sélectionnez le champ Récepteur (par défaut : CellPhone) qui contient le(s) numéro(s) de téléphone devant recevoir le message et le nom de l'expéditeur (11 caractères au maximum). Le contenu du message ne peut être défini qu'en texte brut. Notez que la longueur maximale du message est de 160 caractères et que tout ce qui suit sera coupé.

Important : l'envoi de SMS n'est pas gratuit ! Vous devrez vous connecter avec votre compte et RACE RESULT vous facturera un crédit participant par SMS.

Appel au service web

L'appel au service web demande une méthode (GET / POST) et une URL qui sera construite par une expression. La fonction urlencode() peut être utile pour cela. Exemple :

"https://my.server.com/webservice/message.php?bib=" & [bib] & "&name=" & urlencode([FirstName] & " " & [LastName])

En outre, vous pouvez définir des en-têtes HTTP et enregistrer le résultat dans un champ de texte supplémentaire.

Autres options


Il arrive que vous souhaitiez définir d'autres adresses de destinataires pour les courriels ou les SMS. Par défaut, le champ du destinataire est défini sur les champs E-mail ou Téléphone portable standard, mais vous pouvez choisir l'un de vos champs supplémentaires de type Champ de texte. Si vous souhaitez envoyer le même modèle d'e-mail ou de SMS à plusieurs destinataires, vous pouvez créer une liste de valeurs séparées par des points-virgules dans le champ qui sera utilisé comme champ récepteur pour le modèle concerné. 

Un filtre par défaut est utile si vous voulez vous assurer que le modèle ne sera envoyé qu'à certains participants. Plus tard, lors de l'envoi des messages, vous pourrez toujours modifier le filtre, mais vous ne pourrez pas oublier de le saisir. Par exemple, pour vous assurer que le modèle ne sera envoyé qu'aux participants du concours 2, saisissez le filtre:

[Contest]=2

La définition d'une case à cocher supplémentaire peut également s'avérer très utile pour savoir à qui vous avez déjà envoyé le message.

Vous pouvez combiner cette fonction avec le filtre par défaut : Définir une case à cocher lorsque le message a été envoyé et utiliser ce filtre par défaut :

[Contest]=2 AND [CheckBoxName]=0

Pièces jointes


Lors de l'envoi d'une pièce jointe, il est important de définir une extension de fichier. Par exemple, si vous souhaitez envoyer un certificat sous la forme d'un fichier .pdf, vous devez écrire le nom de la pièce jointe avec l'extension .pdf. Notez que le nom "Certificat" peut être remplacé par n'importe quel nom.

Certificate.pdf

Lors de l'envoi d'e-mails de groupe, le filtre peut être défini pour s'appliquer au premier (par GroupRegPos), au dernier (par GroupRegPos), à tous ou à n'importe quel (1) participant du groupe.

Configuration de l'e-mail SMTP

Lorsque vous envoyez des courriels à partir de RACE RESULT 12, vous pouvez utiliser nos serveurs pour envoyer un maximum de 10 courriels (à l'exclusion des courriels de confirmation automatique de l'inscription), ou vous pouvez connecter votre propre serveur SMTP pour envoyer un nombre beaucoup plus important de courriels.

Vous devrez trouver les paramètres de votre serveur de messagerie SMTP, qui sont normalement disponibles auprès de votre fournisseur d'hébergement, le nom d'utilisateur étant normalement votre adresse électronique et le mot de passe correspondant. 

Lorsque vous configurez votre serveur SMTP pour la première fois, il est conseillé de le tester en vous envoyant un courrier électronique, ce qui peut être fait dans le cadre d'un événement test en vous ajoutant en tant que participant. 


Voici quelques paramètres courants du serveur SMTP. Veuillez noter que ces paramètres changent et qu'ils peuvent n'être exacts que jusqu'à la date de rédaction de ce document, le 17 mars 2020.

Paramètres SMTP d'Office 365

 

  • Adresse du serveur : smtp.office365.com
  • Port : 587
  • Cryptage : TLS

Paramètres SMTP Outlook

 

  • Adresse du serveur : smtp-mail.outlook.com
  • Port : 587
  • Cryptage : TLS

Paramètres SMTP de GoDaddy en Amérique

 

  • Adresse du serveur : smtpout.secureserver.net
  • Port : 465 ou 587
  • Encryption : SSL

Paramètres SMTP de Gmail

  • Adresse du serveur : smtp.gmail.com
  • Port: 587
  • Encryption: TLS

Gmail requiert un niveau de sécurité supplémentaire. Vous devrez générer un mot de passe supplémentaire sur votre compte Gmail afin d'utiliser Gmail avec RR12. Ce mot de passe généré sera utilisé à la place du mot de passe normal de votre compte Google.

Email SMTP Erreurs

Contexte Délai dépassé

Le serveur SMTP est inaccessible. Il peut s'agir d'une panne temporaire du serveur ou d'une limitation du taux d'envoi du serveur SMTP.

Connexion Refusée

Cette erreur se produit lorsque le serveur SMTP auquel vous essayez de vous connecter refuse la connexion. Voici quelques éléments à prendre en compte lorsque vous obtenez cette erreur.

  • Quelles sont les limites de votre fournisseur de messagerie ? La plupart des fournisseurs limitent le nombre d'e-mails pouvant être envoyés dans un laps de temps donné.
  • Votre adresse électronique manque-t-elle d'espace ? Si votre adresse électronique manque d'espace, vous risquez de rencontrer des problèmes lors de l'envoi de plusieurs courriels.

Données d'authentification incorrectes

  • Cette erreur se produit lorsque les paramètres SMTP sont incorrects pour votre adresse électronique.

Automatic E-Mail Error Notifications

En cas d'erreur lors de l'envoi du courrier électronique pendant l'enregistrement en ligne, un message d'erreur est envoyé à l'adresse électronique du client.

Ce message contiendra l'identifiant et l'heure de l'événement, ainsi que le déclencheur (contexte) et la description de l'erreur.

Exemple:


Cher Joe,

Une erreur s'est produite dans l'événement 123456 :

Horodatage : 2024-01-01T12:45:09+02:00

Contexte: Actions AfterSave de l'enregistrement "Single-Registration", ID 123

Erreur:

Erreur d'envoi d'email dans les actions AfterSave : aucun email n'est donné

Nous vous demandons de vérifier et, si possible, de résoudre le problème. N'hésitez pas à nous contacter si vous avez des questions à ce sujet.

Salutations,
Votre équipe RACE RESULT


Common erreurs:

Erreur: erreur lors de l'envoi d'un courriel dans les actions AfterSave : aucun expéditeur n'est indiqué
Explanation: Il n'y a pas d'expéditeur dans le modèle de courrier électronique utilisé pour l'envoi après l'inscription.


Erreur: error sending email in AfterSave actions: no subject given
Explication: erreur lors de l'envoi d'un courriel dans les actions AfterSave : aucun sujet n'est indiqué


Erreur: erreur d'envoi d'email dans les actions AfterSave : aucun email n'est donné
Explication: Le champ pour l'adresse électronique du participant n'est pas demandé/sauvegardé dans le formulaire d'inscription.


Erreur: erreur d'envoi d'email dans les actions AfterSave : erreur d'envoi d'email : gomail : could not send email 1 : 450 4.1.2 <sample@wrongurl.com> : L'adresse du destinataire a été rejetée : Domaine non trouvé
Explication: Le courriel n'a pas pu être envoyé car l'adresse du participant n'était pas joignable. Il s'agit très souvent d'une faute de frappe.


Erreur: Erreur lors de l'envoi du courrier électronique : gomail : impossible d'envoyer le courrier électronique 1 : 450 L'action demandée n'a pas été prise en compte : boîte aux lettres indisponible.
Limite d'envoi de courrier dépassée.
Explication: La limite d'envoi du serveur de messagerie utilisé a été atteinte, car la plupart des fournisseurs ont fixé des limites pour se protéger contre le spam.


Erreur: erreur d'envoi d'un courriel dans les actions AfterSave : erreur d'envoi d'un courriel : gomail : could not send email 1 : 450 4.7.1 <sample@participant.com>... sample@organizer.com a dépassé 5000 messages par 1 jour
Explication: La limite d'envoi du serveur de messagerie utilisé a été atteinte car la plupart des fournisseurs ont fixé des limites pour se protéger contre le courrier indésirable. Voici l'information détaillée indiquant que la limite quotidienne de 5000 messages a été atteinte.


Erreur: erreur d'envoi d'email dans les actions AfterSave : Post « https://messy.raceresult.com/emails/send?sync=true » : context deadline exceeded (Client.Timeout exceeded while awaiting headers)
Explication: Le serveur de messagerie destinataire n'a pas répondu à la demande dans les délais prévus. La raison exacte peut être trouvée du côté du destinataire.


Remarque: L'ID figurant dans le contexte est l'ID du participant dont l'enregistrement a déclenché l'erreur.

Écrire JSON dans le corps d'un appel POST d'un service Web

Email Templates peut être utilisé pour envoyer des requêtes à une autre URL à l'aide d'un appel de service Web. Ces requêtes nécessitent souvent l'envoi de champs de données au format JSON, ce qui requiert quelques considérations particulières. Créez d'abord un nouveau modèle d'e-mail/SMS et définissez le type de paramètre de livraison comme "Appel de service Web". 

Vous devrez vous assurer que la méthode est POST, les données étant alors envoyées dans le corps POST, l'URL est la destination de l'appel au service web. Notez qu'elle ne peut pas contenir de champs car il s'agit de texte brut et qu'elle ne prend donc pas en charge les variables dans l'URL. 

Le corps du POST contient les données à envoyer, que vous pouvez saisir sans guillemets supplémentaires. Tout texte entre crochets sera traité comme un champ RÉSULTAT DE LA COURSE ou comme une fonction permettant d'insérer des données. 

{"name": "[FirstName]", "age": [Age]}

 

Si votre point de terminaison nécessite des en-têtes supplémentaires tels qu'une clé API pour l'authentification, ceux-ci peuvent être saisis avec le nom et la valeur de l'en-tête. Vous pouvez avoir besoin d'inclure d'autres éléments requis spécifiques au service JSON que vous utilisez, ces éléments doivent également être inclus dans l'en-tête.