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 (STARTTLS) ou 465 (SSL)
Sécurité	STARTTLS (port 587) ou SSL (port 465)
Authentification	LOGIN ou PLAIN
Nom d'utilisateur	L'app_id de votre application (ex : monapp)
Mot de passe	La send_key de votre application (sek_...)

Où trouver vos identifiants ?

L'app_id et la send_key sont disponibles sur la page de votre application dans le portail SendAs.me. La send_key est également retournée par POST /apps et GET /apps/{pushable_key}/send-key.

Chiffrement obligatoire

SendAs.me n'accepte pas les connexions non chiffrées. Utilisez STARTTLS sur le port 587, ou SSL sur le port 465. 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 = "votre_app_id"           # app_id (ex: monapp)
SMTP_PASSWORD = "sek_VotreSendKey"       # send_key de l'application

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: 'votre_app_id',          // app_id (ex: monapp)
    pass: 'sek_VotreSendKey',      // send_key de l'application
  },
});

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   = 'votre_app_id';      // app_id (ex: monapp)
$mail->Password   = 'sek_VotreSendKey'; // send_key de l'application
$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.).