Les emails transactionnels jouent un rôle crucial dans la communication avec vos utilisateurs. Qu’il s’agisse de confirmations de commande, de réinitialisations de mot de passe ou de notifications importantes, il est essentiel que ces emails soient envoyés de manière fiable et efficace. Dans cet article, nous allons vous guider à travers la mise en place et l’intégration de l’API d’email transactionnel de Sweego, en utilisant la méthode /send.
Introduction à l’API Sweego
L’API Sweego offre une solution simple et puissante pour envoyer des emails transactionnels. Grâce à ses fonctionnalités robustes, vous pouvez facilement intégrer l’envoi d’emails transactionnels dans votre application. Vous trouverez la documentation complète de l’API Sweego ici.
Pré-requis
Avant de commencer, assurez-vous d’avoir :
- Un compte Sweego avec des accès API. https://app.sweego.io/signup
- Une clé API générée depuis votre tableau de bord Sweego.
- Un environnement de développement prêt pour faire des requêtes HTTP (comme Postman, cURL, ou une application web).
Étape 1 : Obtenir la clé API
Connectez-vous à votre compte Sweego et naviguez vers le menu Email dans votre tableau de bord, puis API et cliquez sur Generate API Key. Générez une nouvelle clé API et notez-la, car vous en aurez besoin pour authentifier vos requêtes et surtout, on ne pourra pas vous la montrer une seconde fois pour raison de sécurité.
Étape 2 : Configuration de l’environnement
Selon le langage de programmation que vous utilisez, vous pouvez configurer votre environnement pour envoyer des requêtes HTTP. Voici des exemples dans quelques langages courants.
curl
Python
Node
PHP
curl --location 'https://api.sweego.io/send' \
--header 'Content-Type: application/json' \
--header 'Api-Key: <API_KEY>' \
--data-raw '{
"channel": "email",
"provider": "sweego",
"recipients": [
{ "email": "<EMAIL_TO>" }
],
"from": {
"name": "MY NAME",
"email": "<EMAIL_FROM>"
},
"subject": "Email subject",
"message-txt": "Email body"
}'import requests
api_url = "https://api.sweego.io/send"
api_key = "votre_clé_API"
email_data = {
"channel": "email",
"provider": "sweego",
"recipients": [{"email": "destinataire@example.com"}],
"from": {"name": "MY NAME", "email": "votre_email@example.com"},
"subject": "Email subject",
"message-txt": "Email body"
}
headers = {
"Api-Key": api_key,
"Content-Type": "application/json"
}
response = requests.post(api_url, json=email_data, headers=headers)
if response.status_code == 200:
print("Email envoyé avec succès!")
else:
print(f"Erreur lors de l'envoi de l'email: {response.status_code}")
const fetch = require('node-fetch');
const apiUrl = "https://api.sweego.io/send";
const apiKey = "votre_clé_API";
const emailData = {
channel: "email",
provider: "sweego",
recipients: [{ email: "destinataire@example.com" }],
from: { name: "MY NAME", email: "votre_email@example.com" },
subject: "Email subject",
"message-txt": "Email body"
};
const headers = {
"Api-Key": apiKey,
"Content-Type": "application/json"
};
fetch(apiUrl, {
method: 'POST',
headers: headers,
body: JSON.stringify(emailData)
})
.then(response => {
if (response.ok) {
return response.json();
}
throw new Error(`Erreur lors de l'envoi de l'email: ${response.status}`);
})
.then(data => {
console.log("Email envoyé avec succès!");
})
.catch(error => {
console.error(error);
});
<?php
$api_url = "https://api.sweego.io/send";
$api_key = "votre_clé_API";
$email_data = [
"channel" => "email",
"provider" => "sweego",
"recipients" => [
["email" => "destinataire@example.com"]
],
"from" => [
"name" => "MY NAME",
"email" => "votre_email@example.com"
],
"subject" => "Email subject",
"message-txt" => "Email body"
];
$headers = [
"Api-Key: $api_key",
"Content-Type: application/json"
];
$ch = curl_init($api_url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($email_data));
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($http_code == 200) {
echo "Email envoyé avec succès!";
} else {
echo "Erreur lors de l'envoi de l'email: $http_code";
}
?>
Étape 3 : Envoyer un Email
En utilisant les exemples de code ci-dessus, vous pouvez envoyer un email transactionnel en appelant la méthode /send de l’API Sweego. Assurez-vous de remplacer <API_KEY>, <EMAIL_TO>, et <EMAIL_FROM> par vos informations réelles et de personnaliser les champs subject et message-txt selon vos besoins.
Étape 4 : Gestion des Réponses et des Erreurs
Il est important de gérer correctement les réponses de l’API et de traiter les éventuelles erreurs. L’API Sweego renvoie des codes de statut HTTP standard pour indiquer le succès ou l’échec d’une requête. Assurez-vous de vérifier ces codes et de prendre les mesures appropriées en cas d’erreur.
Conclusion
L’intégration de l’API d’email transactionnel de Sweego dans votre application est un processus simple qui peut considérablement améliorer la fiabilité et l’efficacité de vos communications par email. En suivant les étapes décrites dans cet article, vous serez en mesure d’envoyer des emails transactionnels de manière rapide et sécurisée.
Pour plus de détails sur les fonctionnalités avancées et les paramètres de l’API, consultez la documentation complète de l’API Sweego.
Laisser un commentaire