Emailing
Mailjet dans votre produit et vos agents IA, via une API
Le toolkit Mailjet couvre les contacts, listes de contacts, propriétés de contact, expéditeurs, modèles, brouillons de campagne et statistiques d'email. Votre client se connecte une fois avec ses identifiants Mailjet, et votre produit ou agent IA appelle chaque opération via Connect, qui les stocke et journalise chaque exécution.
15 jours d'essai. Sans carte bancaire.
POST https://connect.reportei.com/api/tools/mailjet_create_contact_list/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"Name": "<Name>"
}
}Fonctionnement
Du client connecté au premier appel à Mailjet.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte Mailjet. Vous recevez l'id de la connexion.
- 2
Votre produit appelle la tool
Un POST sur /api/tools/{tool}/execute avec l'id de la connexion et les arguments. En cas de succès, Connect conserve le statut et le corps de la réponse de l'app.
- 3
Connect s'occupe du reste
Il stocke l'identifiant chiffré, renouvelle les tokens des connexions OAuth qui le permettent et enregistre les exécutions dans un journal d'audit consultable via l'API.
Cas d'usage
Ce que votre produit fait avec Mailjet.
Synchroniser les utilisateurs avec les listes
Ajoutez un contact à une liste par email à l'inscription des utilisateurs, avec nom et propriétés, et désabonnez-le ou retirez-le quand il part.
Envoyer des campagnes depuis votre produit
Créez un brouillon de campagne avec expéditeur, liste et modèle, puis planifiez-le ou envoyez-le tout de suite à la liste.
Rapports de délivrabilité par agent
Laissez un agent IA lire les nombres d'envoyés, délivrés, ouverts, cliqués, rebonds et spam d'une campagne, d'une liste ou d'un expéditeur dans le temps.
Tools
15 tools Mailjet
- Lister les contactsGETListe les contacts du compte avec email, nom, statut d'exclusion et dates d'activité, éventuellement seulement ceux d'une liste. La réponse contient Data, Count et Total ; paginez avec Limit et Offset.
- Obtenir un contactGETRenvoie un contact, trouvé par son ID ou son adresse email, avec nom, statut d'exclusion et dates d'activité. Utilisez-le pour obtenir l'ID d'un contact que vous ne connaissez que par son email.
- Mettre à jour un contactPUTModifie le nom d'un contact ou son exclusion des emails marketing. Seuls les champs envoyés changent. Un contact exclu reçoit toujours les emails transactionnels.
- Lister les listes de contactsGETListe les listes de contacts avec ID, nom, nombre d'abonnés et statut de suppression. La réponse contient Data, Count et Total ; paginez avec Limit et Offset.
- Créer une liste de contactsPOSTCrée une liste de contacts vide et la renvoie avec son ID.
- Gérer un contact de listePOSTAjoute un contact à une liste par email, en créant le contact quand l'email est nouveau et en définissant son nom et ses propriétés, ou le désabonne ou le retire de la liste, selon Action.
- Lister les propriétés de contactGETListe les propriétés de contact du compte avec nom, type de données et namespace. Les noms sont les clés de Properties dans Manage list contact. La réponse contient Data, Count et Total ; paginez avec Limit et Offset.
- Lister les expéditeursGETListe les adresses et domaines expéditeurs du compte avec ID, email, nom et statut. Seul un expéditeur Active peut envoyer une campagne. La réponse contient Data, Count et Total ; paginez avec Limit et Offset.
- Lister les modèlesGETListe les modèles d'email avec ID, nom, usages et mode d'édition. L'ID relie un modèle à un brouillon de campagne comme contenu. La réponse contient Data, Count et Total ; paginez avec Limit et Offset.
- Lister les brouillons de campagneGETListe les brouillons de campagne avec ID, titre, objet, expéditeur, liste, statut et, une fois envoyée, le CampaignID utilisé par Get statistics. La réponse contient Data, Count et Total ; paginez avec Limit et Offset.
Identifiant et mot de passe
Votre client saisit les identifiants de l'app sur un écran de Connect, ou votre système les envoie avec POST /api/customer-toolkits, sans écran.
Questions sur le toolkit Mailjet
Dois-je intégrer l'API Mailjet moi-même ?
Non. Connect fournit 15 tools Mailjet décrites et prêtes. Votre client connecte son compte et votre système appelle chaque tool par le même endpoint, avec le même format de requête.
Comment mon client connecte-t-il son compte Mailjet ?
Avec le mode accepté par le toolkit : Identifiant et mot de passe. Connect stocke l'identifiant chiffré et ne le renvoie jamais à votre système.
Est-ce compatible avec les agents IA ?
Oui. L'input de chaque tool est décrit en JSON Schema, que votre agent utilise directement comme définition de tool. L'agent choisit la tool et les arguments, et votre système fait l'appel à Connect.
Mon client doit-il avoir un compte Reportei ?
Non. Votre client connecte son compte sur un écran de Connect, ou votre système envoie l'identifiant via l'API, et il continue d'utiliser uniquement votre produit.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
