Configurer votre application SMTP

Ce guide vous explique comment pointer votre application existante vers SendAs.me. Si votre application envoie déjà des emails via SMTP, la modification se résume à trois paramètres.

Paramètres de connexion SMTP

Utilisez ces paramètres dans la configuration SMTP de votre application :

Paramètre	Valeur
Hôte	smtp.sendas.me
Port	587
Sécurité	STARTTLS (obligatoire)
Authentification	LOGIN ou PLAIN
Nom d'utilisateur	L'identifiant de votre application (app_pk_...)
Mot de passe	Le mot de passe SMTP généré dans le portail (smtp_...)

Où trouver vos identifiants ?

Les identifiants SMTP sont disponibles sur la page de votre application dans le portail SendAs.me → section Identifiants SMTP. Si vous n'avez pas encore généré de mot de passe, cliquez sur Générer un mot de passe SMTP.

STARTTLS obligatoire

SendAs.me n'accepte pas les connexions non chiffrées. Votre client SMTP doit négocier STARTTLS sur le port 587. Les connexions sans chiffrement sont rejetées.

Adresse expéditeur

L'adresse From: de vos emails doit correspondre à l'adresse du compte OAuth connecté pour cet utilisateur.

Exemple : Si votre utilisateur a connecté alice@gmail.com, vos emails doivent être envoyés avec From: alice@gmail.com (ou un nom affiché : From: "Alice Dupont" <alice@gmail.com>).

SendAs.me utilise l'adresse From: pour déterminer quel compte OAuth utiliser pour la livraison. Si l'adresse ne correspond à aucun compte connecté, l'envoi échoue avec un message d'erreur explicite.

Exemples de code

Python (smtplib)

import smtplib
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart

SMTP_HOST = "smtp.sendas.me"
SMTP_PORT = 587
SMTP_USERNAME = "app_pk_VotreIdentifiantApplication"
SMTP_PASSWORD = "smtp_VotreMotDePasseSMTP"

msg = MIMEMultipart("alternative")
msg["Subject"] = "Votre facture du mois"
msg["From"] = "alice@gmail.com"   # adresse du compte OAuth connecté
msg["To"] = "client@exemple.fr"

text = MIMEText("Bonjour, veuillez trouver ci-joint votre facture.", "plain")
html = MIMEText("<p>Bonjour, veuillez trouver ci-joint votre <b>facture</b>.</p>", "html")
msg.attach(text)
msg.attach(html)

with smtplib.SMTP(SMTP_HOST, SMTP_PORT) as server:
    server.starttls()
    server.login(SMTP_USERNAME, SMTP_PASSWORD)
    server.sendmail(msg["From"], [msg["To"]], msg.as_string())
    print("Email envoyé avec succès.")

Node.js (Nodemailer)

const nodemailer = require('nodemailer');

const transporter = nodemailer.createTransport({
  host: 'smtp.sendas.me',
  port: 587,
  secure: false,  // STARTTLS — ne pas mettre true (qui serait SSL sur 465)
  auth: {
    user: 'app_pk_VotreIdentifiantApplication',
    pass: 'smtp_VotreMotDePasseSMTP',
  },
});

await transporter.sendMail({
  from: '"Alice Dupont" <alice@gmail.com>',  // adresse du compte OAuth connecté
  to: 'client@exemple.fr',
  subject: 'Votre facture du mois',
  text: 'Bonjour, veuillez trouver ci-joint votre facture.',
  html: '<p>Bonjour, veuillez trouver ci-joint votre <b>facture</b>.</p>',
});

PHP (PHPMailer)

use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\SMTP;

$mail = new PHPMailer(true);

$mail->isSMTP();
$mail->Host       = 'smtp.sendas.me';
$mail->SMTPAuth   = true;
$mail->Username   = 'app_pk_VotreIdentifiantApplication';
$mail->Password   = 'smtp_VotreMotDePasseSMTP';
$mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
$mail->Port       = 587;

$mail->setFrom('alice@gmail.com', 'Alice Dupont');  // adresse du compte OAuth connecté
$mail->addAddress('client@exemple.fr');

$mail->isHTML(true);
$mail->Subject = 'Votre facture du mois';
$mail->Body    = '<p>Bonjour, veuillez trouver ci-joint votre <b>facture</b>.</p>';
$mail->AltBody = 'Bonjour, veuillez trouver ci-joint votre facture.';

$mail->send();

PHP (mail natif avec ini_set)

Si vous utilisez la fonction mail() native de PHP avec un MTA local, vous devrez passer par PHPMailer ou une librairie équivalente pour vous connecter à un serveur SMTP externe. La fonction mail() native ne supporte pas l'authentification SMTP.

Cas particulier : applications multi-utilisateurs

Si votre application gère plusieurs utilisateurs finaux ayant chacun connecté leur compte email, l'adresse From: doit être celle du bon utilisateur pour chaque email envoyé.

Exemple :

• L'utilisateur Dupont a connecté jean.dupont@gmail.com
• L'utilisateur Martin a connecté sophie.martin@office365.com

Quand vous envoyez une facture pour Dupont, utilisez From: jean.dupont@gmail.com. Quand vous envoyez une facture pour Martin, utilisez From: sophie.martin@office365.com.

SendAs.me sélectionne automatiquement le bon compte OAuth en fonction de l'adresse From: de chaque email.

Vérifier la configuration

Après avoir configuré votre application :

1. Envoyez un email de test
2. Vérifiez dans le portail SendAs.me → Logs que l'email apparaît avec le statut sent
3. Vérifiez que l'email est bien arrivé chez le destinataire depuis l'adresse attendue

En cas d'erreur, le log détaille la raison de l'échec (compte OAuth non connecté, adresse From: incorrecte, quota fournisseur atteint, etc.).