Emailing
Constant Contact dans votre produit et vos agents IA, via une API
Le toolkit Constant Contact couvre les contacts, les listes de contacts et les campagnes e-mail avec leurs activités, leur planification et leurs statistiques d'envoi. Avec Connect, votre produit ou agent IA appelle le tout 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/constant_contact_create_contact/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"create_source": "Account"
}
}Fonctionnement
Du client connecté au premier appel à Constant Contact.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte Constant Contact. 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 Constant Contact.
Ajouter des abonnés à l'inscription
Un SaaS crée un contact dans le compte du client quand quelqu'un s'inscrit et gère le 409 lorsque l'e-mail existe déjà.
Envoyer une campagne depuis votre app
Un produit crée une campagne en brouillon avec du HTML personnalisé, définit ses listes et planifie l'envoi.
Rendre compte des résultats
Un agent IA lit les statistiques d'une campagne envoyée, comme les ouvertures, clics et rebonds, et les résume pour le propriétaire du compte.
Tools
12 tools Constant Contact
- Lister les contactsGETListe les contacts du compte, sans les supprimés par défaut, avec filtre facultatif par e-mail, liste, statut ou date. La réponse contient contacts et, quand il y en a plus, _links.next.href avec le curseur de la page suivante.
- Créer un contactPOSTCrée un contact et le renvoie avec son contact_id. Envoyez create_source et au moins email_address, first_name ou last_name. Une adresse e-mail déjà présente dans le compte répond 409.
- Mettre à jour un contactPUTMet à jour un contact en remplaçant ses champs principaux : email_address, noms, job_title, company_name, birthday et anniversary omis deviennent vides, envoyez donc aussi les valeurs actuelles, obtenues via Lister les contacts. Les sous-ressources omises sont conservées, et celle qui est envoyée remplace l'actuelle.
- Lister les listes de contactsGETListe les listes de contacts avec list_id, name et description. Un compte compte jusqu'à 1000 listes, et une page en renvoie jusqu'à 1000.
- Créer une liste de contactsPOSTCrée une liste de contacts vide et la renvoie avec son list_id. Un nom déjà utilisé par une autre liste répond 409.
- Lister les campagnes e-mailGETListe les campagnes e-mail, de la plus récemment mise à jour à la plus ancienne, avec campaign_id, name, type et current_status, y compris les supprimées (Removed). Jusqu'à 500 par page ; atteignez les plus anciennes avec before_date et after_date. Les ids des activités viennent d'Obtenir une campagne e-mail.
- Obtenir une campagne e-mailGETRenvoie une campagne e-mail avec name, current_status et campaign_activities. Le campaign_activity_id avec role primary_email est celui que prennent les outils d'activité.
- Créer une campagne e-mailPOSTCrée une campagne e-mail en brouillon avec du contenu HTML personnalisé et la renvoie avec campaign_activities, où se trouve l'activité primary_email. Pour l'envoyer, définissez les listes avec Mettre à jour l'activité de la campagne e-mail puis utilisez Planifier l'activité de la campagne e-mail.
- Obtenir l'activité d'une campagne e-mailGETRenvoie une activité de campagne e-mail : expéditeur, objet, preheader, contact_list_ids ou segment_ids, format_type et current_status. html_content et physical_address_in_footer ne reviennent que s'ils sont demandés dans include.
- Mettre à jour l'activité d'une campagne e-mailPUTMet à jour l'activité primary_email d'une campagne au statut DRAFT ou DONE. Elle remplace les propriétés : envoyez l'expéditeur, l'objet, le preheader et les listes actuels, issus d'Obtenir l'activité d'une campagne e-mail, avec les modifications, car ce qui est omis est effacé. html_content et physical_address_in_footer sont conservés s'ils ne sont pas envoyés.
OAuth avec l'app de votre produit
Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/constant_contact, et votre client autorise le compte sur un écran de consentement. Connect renouvelle le token avant son expiration.
Questions sur le toolkit Constant Contact
Dois-je intégrer l'API Constant Contact moi-même ?
Non. Connect fournit 12 tools Constant Contact 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 Constant Contact ?
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.
Toolkits de la même catégorie
Voir les 100 toolkitsVoyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
