Emailing
AWeber dans votre produit et vos agents IA, via une API
Le toolkit AWeber couvre les comptes, listes, abonnés et broadcasts du compte AWeber d'un client : lire et mettre à jour les abonnés, créer, planifier ou annuler des broadcasts. Avec Connect, votre produit ou agent IA appelle ces opérations par un seul endpoint, pendant que Connect stocke et renouvelle les identifiants OAuth et journalise chaque exécution.
15 jours d'essai. Sans carte bancaire.
POST https://connect.reportei.com/api/tools/aweber_create_subscriber/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"accountId": 1,
"listId": 1,
"email": "<email>"
}
}Fonctionnement
Du client connecté au premier appel à AWeber.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte AWeber. 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 AWeber.
Synchroniser les inscriptions
Quand un utilisateur s'inscrit dans votre SaaS, créez l'abonné dans la liste AWeber du client, ce qui lance la série de suivi de la liste.
Mettre à jour le statut d'abonné
Marquez un abonné comme désinscrit ou changez ses tags quand quelque chose évolue dans votre produit, pour que les emails suivent l'état réel du contact.
Broadcasts rédigés par un agent
Un agent IA rédige un broadcast en brouillon, une personne le relit, puis votre produit le planifie à une date future ou l'annule avant l'envoi.
Tools
12 tools AWeber
- Lister les comptesGETRenvoie le compte AWeber auquel la connexion accède, dans entries, avec son id, l'accountId demandé par toutes les autres tools et le nom de l'entreprise.
- Lister les listesGETListe les listes d'abonnés du compte, dans entries, avec id, nom et le nombre d'abonnés inscrits, non confirmés et désinscrits. Seuls les 100 premiers reviennent ; total_size donne le total.
- Lister les abonnésGETListe les abonnés d'une liste, dans entries, avec id, email, nom, statut, tags, champs personnalisés et date d'inscription. Seuls les 100 premiers reviennent, les plus anciens d'abord sauf si sort_order vaut desc ; total_size donne le total.
- Obtenir un abonnéGETRenvoie un abonné d'une liste avec email, nom, statut, tags, champs personnalisés, localisation et les messages de suivi déjà envoyés.
- Créer un abonnéPOSTAjoute un abonné à une liste, ce qui lance la série de suivi de la liste. Un email déjà présent dans la liste renvoie 400, sauf si update_existing vaut true. Ajoutez les personnes une par une : l'ajout en masse par l'API enfreint les conditions d'AWeber.
- Mettre à jour un abonnéPATCHModifie l'abonné d'une liste qui a l'email donné. Mettre status à unsubscribed arrête les emails à l'abonné ; les tags acceptent une liste add et une liste remove.
- Lister les broadcastsGETListe les broadcasts d'une liste pour un statut, dans entries : brouillons créés par l'API, planifiés par heure d'envoi ou envoyés par date d'envoi. Seuls les 100 premiers reviennent ; total_size donne le total.
- Obtenir un broadcastGETRenvoie un broadcast avec objet, contenu, statut, planification, URL d'archive et, une fois envoyé, ses statistiques.
- Créer un broadcastPOSTCrée un broadcast en brouillon pour la liste ; rien n'est envoyé avant Schedule broadcast. La réponse contient le broadcast_id.
- Mettre à jour un broadcastPUTModifie un broadcast en brouillon. Seuls les brouillons créés par l'API peuvent être modifiés.
OAuth avec l'app de votre produit
Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/aweber, et votre client autorise le compte sur un écran de consentement. Connect renouvelle le token avant son expiration.
Questions sur le toolkit AWeber
Dois-je intégrer l'API AWeber moi-même ?
Non. Connect fournit 12 tools AWeber 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 AWeber ?
Avec le mode accepté par le toolkit : OAuth avec l'app de votre produit. 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.
