Tutoriel : envoyer et recevoir des emails par API avec Smapiz
Mis à jour le
Smapiz se branche sur une boîte mail existante (SMTP pour l’envoi, IMAP pour la réception). Votre application envoie des emails avec un appel HTTP et reçoit chaque nouvel email sous forme de webhook JSON.
1. Créer un compte
Inscrivez-vous sur la page d’inscription et confirmez votre adresse email. Le plan gratuit inclut 1 boîte mail et 500 emails par mois, sans carte bancaire.
2. Connecter une boîte mail
Dans Boîtes mail, cliquez sur Connecter une boîte, choisissez votre fournisseur, saisissez l’adresse et le mot de passe, puis Tester la connexion. Détails dans Connecter une boîte mail.
Notez l’identifiant de la boîte (mbx_…) : il sert dans chaque appel d’envoi.
3. Créer une clé API
Dans Clés API, cliquez sur Créer une clé. La clé (smz_live_…) n’est affichée qu’une fois : copiez-la dans les variables d’environnement de votre serveur.
4. Envoyer un email
curl https://smapiz.com/v1/messages \
-H "Authorization: Bearer smz_live_..." \
-H "Content-Type: application/json" \
-d '{
"mailbox_id": "mbx_...",
"to": "[email protected]",
"subject": "Bonjour",
"text": "Premier email envoyé avec Smapiz."
}'L’email apparaît dans Messages avec son statut. Plus d’options dans Envoyer un email avec l’API.
5. Recevoir les emails entrants
Dans Webhooks, ajoutez l’URL de votre application et cochez message.received. Chaque email qui arrive dans la boîte vous est envoyé en POST. Voir Recevoir les emails par webhook.
La référence complète de l’API est sur /docs.