E-mails depuis votre application

Vos applications peuvent envoyer leurs e-mails transactionnels — vérification d'inscription, réinitialisation de mot de passe, invitations, notifications — via Kuploy, sans serveur SMTP, sans clé d'API et sans DNS à configurer. Il suffit d'ajouter un service Transactional Email à l'application.

remarque

Disponible sur les instances Kuploy Cloud (sous licence), quelle que soit l'offre. Les déploiements auto-hébergés continuent d'utiliser les réglages de messagerie propres à l'application.

Ajouter le service à une application

1. Ouvrez l'environnement de projet où vit votre application.
2. Choisissez Create Service → Transactional Email.
3. Désignez l'application qui enverra les messages.
4. Confirmez le préfixe des variables — les noms que votre application lit déjà pour ses réglages de messagerie. Kuploy en propose un d'après le nom de l'application ; pour le template LearnHouse, utilisez LEARNHOUSE.
5. Enregistrez. Kuploy écrit les variables dans l'application et la redéploie pour qu'elles prennent effet.

Encore faut-il que votre application sache s'en servir : elle doit pouvoir envoyer par le relais de Kuploy. Le template LearnHouse le fait d'emblée ; pour votre propre application, lisez le point d'envoi et le jeton dans ces variables, et envoyez vos messages en POST sur ce point d'envoi, le jeton servant d'identifiant au porteur.

La page du service affiche également le point d'envoi et le jeton lui-même — ce dernier reste masqué jusqu'à ce que vous l'affichiez — ce qui vous permet de copier l'un ou l'autre sans passer par les variables d'environnement de l'application.

astuce

Les applications qui envoyaient déjà leur courrier par Kuploy avant que cela ne devienne un service ont été reprises automatiquement : elles continuent de fonctionner et apparaissent désormais comme un service Transactional Email que vous pouvez consulter ou supprimer.

Le sélecteur de transport

Certaines applications choisissent leur transport de messagerie d'après une variable d'environnement — LearnHouse lit …_EMAIL_PROVIDER pour décider comment envoyer. La fenêtre propose deux réglages à cet effet :

• « App picks its mail transport from an env var » — laissez l'option activée si votre application fonctionne ainsi ; désactivez-la si elle envoie toujours par Kuploy et n'a besoin que du point d'envoi et du jeton.
• Transport value — la valeur donnée à cette variable. Par défaut, hub. Si votre code appelle autrement le mode rattaché, indiquez-le ici : une application qui utilise déjà hub pour son mode de confiance et proxy pour un envoi relayé doit mettre proxy, faute de quoi elle prendra silencieusement le mauvais chemin.

Si votre application n'a pas de sélecteur de transport, ignorez ce réglage : seuls le point d'envoi et le jeton sont injectés.

Comment cela fonctionne

Kuploy remet à l'application un point d'envoi qui lui est propre et un jeton limité à cette seule application, puis relaie chaque message pour son compte.

• Aucun identifiant dans votre application. Elle ne détient ni compte de messagerie partagé ni clé de licence : elle confie chaque message à Kuploy, qui l'envoie pour vous.
• Sous l'identité du domaine de votre application. Le courrier part de no-reply@ sur le domaine par lequel votre application est jointe. S'il s'agit d'une adresse .kuploy.app gérée par la plateforme, elle est vérifiée automatiquement, sans DNS à créer ; s'il s'agit de votre propre domaine, l'identité devient la vôtre une fois ce domaine vérifié. En attendant, les messages partent d'une adresse Kuploy par défaut : rien n'est jamais perdu à cause d'une configuration en cours.
• Résiste aux redéploiements. Le câblage persiste d'un déploiement à l'autre ; vous n'avez rien à reconfigurer.

Le nom que voient vos destinataires

Le courrier part de no-reply@ sur le domaine de votre application, accompagné d'un nom d'affichage — pour la plupart des destinataires, c'est la seule partie qu'ils lisent vraiment.

Par défaut, c'est le nom de l'application, souvent un nom d'infrastructure (app, learnhouse-app) plutôt qu'un nom que vos utilisateurs reconnaîtraient. Définissez-le sur la page du service, sous Sender → From name : mettez-y ce que vos destinataires doivent voir, le nom de votre produit par exemple.

Deux choses à savoir :

• il s'applique au prochain message envoyé — contrairement aux noms de variables, le modifier ne redéploie pas votre application ;
• laissé vide, Kuploy retombe sur le nom de l'application, puis sur celui de votre organisation. C'est pourquoi un nom non défini peut faire apparaître votre entité de facturation à la place de votre produit.

Vérifier que tout est actif

Une fois l'application déployée, envoyez-vous un message de test depuis celle-ci (une réinitialisation de mot de passe, par exemple). Si vous le recevez, le chemin fonctionne. L'adresse d'expédition vous indique où vous en êtes :

Expéditeur affiché	Signification
no-reply@ sur le domaine de votre application	Identité vérifiée — tout est en place
Une adresse Kuploy par défaut	Fonctionne ; l'identité est encore en cours de vérification

Profitez-en pour regarder le nom d'affichage à côté de l'adresse : c'est le moyen le plus rapide de repérer un nom d'expéditeur que vous n'avez pas encore défini.

Utiliser plutôt votre propre prestataire

Si vous préférez envoyer depuis votre propre domaine ou votre propre prestataire, renseignez la configuration de messagerie de l'application (SMTP, Resend…) dans son environnement. Un prestataire explicitement configuré sur l'application a la priorité : vous gardez la main quand vous le souhaitez.

Pour cesser complètement d'envoyer par Kuploy, ouvrez le service Transactional Email et supprimez-le : les variables sont retirées de l'application, qui est redéployée sans elles.

En cas de fuite du jeton

Le jeton permet à quiconque le détient d'envoyer du courrier au nom de votre organisation : traitez-le comme un mot de passe. S'il se retrouve là où il ne devrait pas — une capture d'écran, un terminal partagé, un log collé quelque part — ouvrez le service et choisissez Rotate.

Le renouvellement invalide immédiatement l'ancien jeton et redéploie l'application avec le nouveau. L'application ne peut pas envoyer entre-temps, généralement une minute ou deux. Les services créés avant l'existence du renouvellement affichent une invitation à le faire une fois : leur jeton d'origine ne peut être ni affiché ni révoqué, et le renouvellement le remplace par un jeton qui le peut.

Pour confirmer que le nouveau jeton est actif, envoyez un message de test : c'est la seule vérification qui distingue « l'application a un jeton » de « l'application a un jeton qui fonctionne encore ». Un indicateur de santé dans votre propre application vous dira généralement si la variable est définie, ce qui reste vrai avec un jeton révoqué : il ne peut donc pas vous confirmer que le redéploiement a abouti.

Suivi d'ouverture

Les messages envoyés par Kuploy transitent par notre prestataire de messagerie, qui ajoute au courrier sortant un pixel de suivi d'ouverture et un en-tête List-Unsubscribe, et le délivre en HTML. Cela se passe chez le prestataire, pas dans votre application, et ne peut pas être désactivé aujourd'hui, ni pour un message ni pour une application en particulier.

C'est important si votre propre politique de confidentialité promet l'absence de suivi par un tiers : en l'état, cette promesse et ce service sont incompatibles, et il vous faut soit ajuster la politique, soit passer par votre propre prestataire (voir ci-dessus). Nous préférons vous le dire ici plutôt que vous le laisser découvrir dans un en-tête de message.

Dépannage

• Aucun message n'arrive : vérifiez que l'application a fini de se déployer, puis renvoyez. Si vous venez de modifier ses réglages de messagerie, redéployez pour qu'ils prennent effet.
• L'application ne voit pas les variables : elles sont écrites dans son environnement, qu'un conteneur en cours d'exécution ne relit qu'au déploiement. Créer ou modifier le service déclenche un redéploiement ; si vous l'avez annulé, redéployez l'application.
• Noms de variables erronés : ils doivent correspondre à ce que lit votre application. Ouvrez le service et corrigez-les — l'enregistrement réécrit l'environnement et redéploie.
• L'expéditeur ne prend jamais votre identité : une adresse .kuploy.app gérée par la plateforme se vérifie toute seule. Un domaine personnalisé ne devient le vôtre qu'une fois vérifié : terminez sa vérification dans les réglages de domaine de l'application. Entre-temps, le courrier continue de partir de l'expéditeur par défaut.

Pour aller plus loin

• La messagerie de la plateforme : la façon dont la plateforme elle-même délivre son courrier — service géré ou votre propre serveur — relève de votre administrateur de plateforme. Voir Configuration SMTP.
• Boîtes aux lettres : voir Messagerie et boîtes aux lettres pour héberger de vraies boîtes IMAP sur votre propre domaine.