Aller au contenu principal

Flux complet éditeur

Ce guide vous accompagne de bout en bout : de la création de votre application dans le portail jusqu'à l'envoi d'un email depuis l'adresse de votre utilisateur final.

Vue d'ensemble​

1. Créer l'application dans le portail SendAs.me
         ↓
2. Récupérer les identifiants SMTP de l'application
         ↓
3. Intégrer le lien "Connecter mon email" dans votre interface
         ↓
4. L'utilisateur clique et autorise l'accès à son compte
         ↓
5. Configurer l'envoi SMTP dans votre application
         ↓
6. Envoyer un email — il arrive depuis l'adresse de l'utilisateur

Étape 1 : Créer l'application dans le portail​

  1. Connectez-vous sur app.sendas.me
  2. Accédez à Applications → Nouvelle application
  3. Remplissez le formulaire :
    • Nom : Mon Application (affiché sur la page d'autorisation que verront vos utilisateurs)
    • Logo URL (optionnel) : affiché sur la même page
    • Fournisseurs activés : Gmail, Office 365, ou les deux selon votre besoin
  4. Cliquez sur Créer

Votre application obtient un identifiant unique, par exemple : app_pk_AbCdEfGhIjKlMnOp.

Étape 2 : Récupérer les identifiants SMTP​

Sur la page de votre application, section Identifiants SMTP :

  1. Cliquez sur Générer un mot de passe SMTP
  2. Notez les informations :
ParamètreValeur exemple
Hôtesmtp.sendas.me
Port587
Nom d'utilisateurapp_pk_AbCdEfGhIjKlMnOp
Mot de passesmtp_8xK2mP9nQrTvWyZa
Une seule affichage

Le mot de passe SMTP est affiché une seule fois. Conservez-le dans votre gestionnaire de secrets ou votre fichier de configuration. En cas de perte, générez-en un nouveau — l'ancien sera invalidé.

Ces identifiants sont ceux de votre application (vous en tant qu'éditeur). Ils ne changent pas d'un utilisateur à l'autre.

Étape 3 : Intégrer le lien de connexion dans votre interface​

Pour que vos utilisateurs puissent connecter leur compte email à votre application, vous devez leur fournir un lien d'autorisation.

Récupérer l'URL d'autorisation​

Dans le portail, sur la page de votre application, section Lien d'autorisation :

  • Pour Gmail : https://app.sendas.me/connect/gmail?app=app_pk_AbCdEfGhIjKlMnOp
  • Pour Office 365 : https://app.sendas.me/connect/microsoft?app=app_pk_AbCdEfGhIjKlMnOp

Vous pouvez également ajouter un paramètre redirect_url pour rediriger l'utilisateur vers votre application après connexion :

https://app.sendas.me/connect/gmail?app=app_pk_AbCdEfGhIjKlMnOp&redirect_url=https://votre-app.com/settings/email/callback

Intégrer le lien dans votre interface​

Ajoutez un bouton ou un lien dans la page de paramètres de votre utilisateur. Exemple :

<a href="https://app.sendas.me/connect/gmail?app=app_pk_AbCdEfGhIjKlMnOp&redirect_url=https://votre-app.com/settings/callback">
  Connecter mon adresse Gmail
</a>

L'apparence et le libellé sont libres. Certains éditeurs utilisent "Connecter mon email", "Autoriser l'envoi depuis mon adresse", ou "Lier mon compte Google".

Étape 4 : L'utilisateur clique et autorise​

Quand l'utilisateur clique sur le lien :

  1. Il est redirigé vers la page d'autorisation Google ou Microsoft
  2. Il se connecte avec son compte email habituel
  3. Il voit une page de consentement qui lui indique que votre application demande la permission d'envoyer des emails en son nom
  4. Il accepte
  5. Il est redirigé vers l'URL que vous avez spécifiée (ou vers le portail par défaut)

Côté SendAs.me :

  • Le compte est désormais lié à votre application
  • Vous recevez un webhook oauth_connected si vous avez configuré un endpoint
  • Le compte apparaît dans la section Utilisateurs connectés de votre application dans le portail
Ce que voit l'utilisateur

La page d'autorisation Google affiche le nom et le logo de votre application. C'est pourquoi il est important de renseigner ces informations lors de la création de l'application.

Étape 5 : Configurer l'envoi SMTP dans votre application​

Utilisez les identifiants récupérés à l'étape 2 dans la configuration SMTP de votre application.

Important : l'adresse From: de chaque email doit correspondre à l'adresse du compte de l'utilisateur connecté.

Exemple en Python :

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

# Identifiants de VOTRE APPLICATION (constants, pas par utilisateur)
SMTP_HOST = "smtp.sendas.me"
SMTP_PORT = 587
SMTP_USERNAME = "app_pk_AbCdEfGhIjKlMnOp"
SMTP_PASSWORD = "smtp_8xK2mP9nQrTvWyZa"

def send_invoice(user_email: str, recipient: str, subject: str, body_html: str):
    msg = MIMEMultipart("alternative")
    msg["Subject"] = subject
    msg["From"] = user_email    # adresse du compte OAuth de l'utilisateur
    msg["To"] = recipient

    msg.attach(MIMEText(body_html, "html"))

    with smtplib.SMTP(SMTP_HOST, SMTP_PORT) as server:
        server.starttls()
        server.login(SMTP_USERNAME, SMTP_PASSWORD)
        server.sendmail(user_email, [recipient], msg.as_string())

# Utilisation :
send_invoice(
    user_email="jean.dupont@gmail.com",   # l'utilisateur qui a connecté son compte
    recipient="client@exemple.fr",
    subject="Votre facture #2025-0042",
    body_html="<p>Veuillez trouver ci-joint votre facture.</p>"
)

Étape 6 : Vérifier l'envoi​

Après l'envoi :

  1. Chez le destinataire : l'email doit être arrivé depuis l'adresse de l'utilisateur (jean.dupont@gmail.com), pas depuis une adresse SendAs.me.

  2. Dans le portail : accédez à votre application → Logs. Vous verrez une entrée :

ChampValeur
Statutsent
Dejean.dupont@gmail.com
Àclient@exemple.fr
SujetVotre facture #2025-0042
Fournisseurgmail
  1. Dans Gmail ou Outlook de l'utilisateur : l'email apparaît dans la boîte d'envoi de son compte, comme s'il l'avait envoyé lui-même.

Prochaines étapes​

Votre intégration est opérationnelle. Voici ce que vous pouvez faire ensuite :