Envoi d'e-mails

GoodWorkshop envoie les liens de connexion et les invitations par e-mail. Sans envoi d’e-mails, seules les personnes qui ont déjà un passkey peuvent entrer. Tu as surtout besoin de cette page si tu héberges GoodWorkshop toi-même.

Ouvre le menu du compte en haut à droite et choisis, sous Administration, l’entrée Envoi d’e-mails.

Choisir la méthode

Sous Comment les e-mails doivent-ils être envoyés ?, quatre possibilités s’offrent à toi :

Méthode	Pour quoi
Microsoft Graph	Pour Microsoft 365 sans SMTP AUTH.
SMTP	Un relais de messagerie classique.
Écrire dans le journal du serveur	Pas d’envoi. Les liens de connexion atterrissent dans le journal du serveur.
Pas d’envoi	Les liens de connexion ne s’obtiennent qu’en ligne de commande.

Configurer SMTP

Choisis SMTP.
Sous URL SMTP, saisis l’adresse de ton relais avec les identifiants, par exemple smtps://utilisateur:motdepasse@relay.example.com:465.
Sous Adresse d’expéditeur, saisis l’adresse depuis laquelle les e-mails doivent partir.
Clique sur Enregistrer.

Configurer Microsoft 365 via Graph

Beaucoup d’organisations Microsoft 365 ont désactivé SMTP AUTH. Il reste alors la voie de Microsoft Graph.

Il te faut pour cela un enregistrement d’application dans Entra ID avec l’autorisation d’application Mail.Send et le consentement administrateur. Tu en reprends :

Champ	Origine
ID d’annuaire ou de locataire	l’ID de ton annuaire Entra
ID d’application	l’ID de l’enregistrement d’application
Secret client	une clé secrète de l’enregistrement d’application
Boîte d’expédition	la boîte aux lettres depuis laquelle on envoie

Choisis Microsoft Graph, remplis les quatre champs et clique sur Enregistrer.

Les secrets restent secrets

Le mot de passe dans l’URL SMTP et le secret client sont enregistrés chiffrés et ne sont plus jamais affichés. Si l’un d’eux est enregistré, le champ indique « enregistré — laisse vide pour le conserver ». Si tu le laisses vide, la valeur enregistrée est conservée.

Valeurs issues de l’environnement

Si tu héberges GoodWorkshop toi-même, tu peux aussi définir l’envoi d’e-mails dans le .env de l’installation. Ces valeurs sont prioritaires. La page affiche ces champs verrouillés, avec la mention depuis l’environnement ; ils ne peuvent être modifiés que sur le serveur.

Variable	Champ
`GW_MAIL_TRANSPORT`	la méthode : `smtp`, `graph`, `console` ou `none`
`SMTP_URL`, `SMTP_FROM`	URL SMTP, Adresse d’expéditeur
`GW_GRAPH_TENANT_ID`, `GW_GRAPH_CLIENT_ID`, `GW_GRAPH_CLIENT_SECRET`, `GW_GRAPH_SENDER`	les quatre champs Graph

Plus d’informations sur ces variables sous Configuration.

Envoyer un message de test

On ne sait si un relais fonctionne qu’au moment d’envoyer. Sans test, le premier essai est le lien de connexion de quelqu’un – et une erreur ressemble alors à un compte cassé.

Enregistre d’abord tes réglages. Le test utilise ce qui est enregistré.
Sous Envoyer un message de test, saisis une adresse dans le champ À.
Clique sur Envoyer.

Si cela fonctionne, la page indique « Envoyé à … Si rien n’arrive : dossier indésirables. » Si l’envoi échoue, la page affiche mot pour mot la réponse du serveur de messagerie, par exemple 535 authentication failed. C’est exactement ce message qu’il te faut pour trouver l’erreur.

Travailler sans envoi d’e-mails

Même sans aucun envoi d’e-mails, tu peux faire entrer des personnes dans l’espace de travail : lors de l’invitation, GoodWorkshop affiche alors directement le lien de connexion, et tu le transmets en personne. Avec un passkey, tout le monde entre ensuite sans e-mail.