Documentation

Démarrage rapide

1. Inscrivez-vous et ajoutez votre domaine

Créez un compte, puis ajoutez votre domaine d'envoi à partir du tableau de bord. Nous fournirons les enregistrements DNS (DKIM et SPF) à ajouter aux paramètres DNS de votre domaine. Une fois vérifié, vous êtes prêt à envoyer.

2. Obtenez vos identifiants

Vos identifiants SMTP et clé API sont disponibles dans le tableau de bord. Vous en aurez besoin pour vous authentifier lors de l'envoi d'e-mails.

3a. Envoyer via SMTP

Configurez les paramètres SMTP de votre application avec les éléments suivants :

SMTP Host:     smtp.mailertogo.com
SMTP Port:     587 (STARTTLS) ou 465 (SSL)
Username:      Votre nom d'utilisateur SMTP (du tableau de bord)
Password:      Votre mot de passe SMTP (du tableau de bord)

La plupart des frameworks ont un support SMTP intégré :

Rails

# config/environments/production.rb
config.action_mailer.smtp_settings = {
  address:         ENV["MAILERTOGO_SMTP_HOST"],
  port:            587,
  user_name:       ENV["MAILERTOGO_SMTP_USER"],
  password:        ENV["MAILERTOGO_SMTP_PASSWORD"],
  authentication:  :plain,
  enable_starttls: true
}

Django

# settings.py
EMAIL_HOST = os.environ.get("MAILERTOGO_SMTP_HOST")
EMAIL_PORT = 587
EMAIL_HOST_USER = os.environ.get("MAILERTOGO_SMTP_USER")
EMAIL_HOST_PASSWORD = os.environ.get("MAILERTOGO_SMTP_PASSWORD")
EMAIL_USE_TLS = True

Node.js (Nodemailer)

const nodemailer = require("nodemailer");

const transport = nodemailer.createTransport({
  host: process.env.MAILERTOGO_SMTP_HOST,
  port: 587,
  auth: {
    user: process.env.MAILERTOGO_SMTP_USER,
    pass: process.env.MAILERTOGO_SMTP_PASSWORD,
  },
});

Laravel

# .env
MAIL_MAILER=smtp
MAIL_HOST="${MAILERTOGO_SMTP_HOST}"
MAIL_PORT=587
MAIL_USERNAME="${MAILERTOGO_SMTP_USER}"
MAIL_PASSWORD="${MAILERTOGO_SMTP_PASSWORD}"
MAIL_ENCRYPTION=tls

3b. Envoyer via API REST

Envoyez un e-mail avec une seule requête HTTP :

curl -X POST https://api.mailertogo.com/v1/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "you@yourdomain.com",
    "to": "user@example.com",
    "subject": "Hello",
    "html": "<p>Your email body here.</p>"
  }'

Configuration du domaine

Enregistrements DNS

Pour envoyer à partir de votre propre domaine, ajoutez les enregistrements DNS affichés dans votre tableau de bord :

• DKIM — Un enregistrement TXT qui permet aux destinataires de vérifier que vos e-mails sont authentiques
• SPF — Un enregistrement TXT qui autorise nos serveurs à envoyer au nom de votre domaine

Les modifications DNS peuvent prendre jusqu'à 48 heures pour se propager, bien que la plupart se terminent en quelques minutes. Le tableau de bord affichera l'état de vérification pour chaque enregistrement.

Webhooks

Configurez les URL de webhook dans votre tableau de bord pour recevoir des notifications en temps réel pour les événements d'e-mail :

• delivered — L'e-mail a été accepté par le serveur de messagerie du destinataire
• bounced — L'e-mail n'a pas pu être livré
• opened — Le destinataire a ouvert l'e-mail (lorsque le suivi est activé)
• clicked — Le destinataire a cliqué sur un lien (lorsque le suivi est activé)

Les charges utiles webhook sont envoyées en tant que requêtes JSON POST. Nous réessayons les livraisons échouées avec un backoff exponentiel.

Intégrations de plateforme

Heroku

Mailer To Go est disponible en tant que module complémentaire Heroku. Mettez-le en place à partir de la Place de marché Heroku Elements, et vos identifiants SMTP seront définis automatiquement en tant que variables de configuration.

Build.io

Mailer To Go est également disponible sur Build.io. Mettez-le en place à partir de votre tableau de bord Build.io pour une configuration automatique.

Support

Vous avez des questions ? Envoyez-nous un e-mail à support@mailertogo.com. Consultez notre page d'état pour la disponibilité du service.