Emailing
Brevo dans votre produit et vos agents IA, via une API
Le toolkit Brevo couvre les contacts, les listes de contacts, les campagnes email et les emails transactionnels. Votre client connecte son compte Brevo une fois avec une clé API, et votre produit ou agent IA appelle chaque opération via Connect, qui stocke les identifiants et journalise chaque exécution, sans que vous ayez à construire et maintenir l'intégration.
15 jours d'essai. Sans carte bancaire.
POST https://connect.reportei.com/api/tools/brevo_create_contact/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"email": "<email>"
}
}Fonctionnement
Du client connecté au premier appel à Brevo.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte Brevo. 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 Brevo.
Synchroniser les contacts du CRM
Créez ou mettez à jour un contact, avec updateEnabled, et ajoutez-le aux bonnes listes dès qu'un lead change dans votre CRM.
Lancer des campagnes depuis l'app
Créez un brouillon de campagne email à partir de HTML ou d'un template, planifiez-le avec scheduledAt et envoyez-le sans quitter votre produit.
Un agent envoie les emails de commande
Un agent IA envoie un email transactionnel avec l'id d'un template et lit le messageId pour confirmer que l'envoi a été accepté.
Tools
12 tools Brevo
- Lister les contactsGETListe les contacts, du plus récent au plus ancien par défaut, avec filtre optionnel par liste, date ou attribut. La réponse contient contacts et count ; paginez avec limit et offset.
- Obtenir un contactGETRenvoie un contact avec ses attributs, ses listes et les statistiques de campagnes des 90 derniers jours.
- Créer un contactPOSTCrée un contact. Envoyez email, ou l'attribut SMS, ou ext_id. Avec updateEnabled à true, un contact existant ayant le même identifiant est mis à jour au lieu d'échouer.
- Mettre à jour un contactPUTMet à jour un contact. Seuls les champs envoyés changent : listIds ajoute le contact à des listes et unlinkListIds l'en retire.
- Lister les listes de contactsGETListe les listes de contacts avec id, name, folderId et abonnés uniques. La réponse contient lists et count ; paginez avec limit et offset.
- Créer une liste de contactsPOSTCrée une liste de contacts vide dans un dossier et renvoie son id.
- Lister les campagnes emailGETListe les campagnes email, de la plus récente à la plus ancienne par défaut. La réponse contient campaigns et count ; paginez avec limit et offset. Les statistiques ne reviennent que si statistics est envoyé.
- Obtenir une campagne emailGETRenvoie une campagne email avec ses réglages, ses destinataires et les statistiques de son rapport.
- Créer une campagne emailPOSTCrée une campagne email en brouillon et renvoie son id. Envoyez le contenu dans exactement un champ parmi htmlContent, htmlUrl ou templateId. Définir scheduledAt planifie l'envoi, et recipients devient alors obligatoire.
- Mettre à jour une campagne emailPUTMet à jour une campagne email en brouillon ou planifiée. Seuls les champs envoyés changent. Définir scheduledAt planifie l'envoi.
Clé d'API
Votre client colle la clé de l'app sur un écran de Connect, ou votre système envoie la clé avec POST /api/customer-toolkits, sans écran.
Questions sur le toolkit Brevo
Dois-je intégrer l'API Brevo moi-même ?
Non. Connect fournit 12 tools Brevo 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 Brevo ?
Avec le mode accepté par le toolkit : Clé d'API. 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.
