CRM et ventes
Keap dans votre produit et vos agents IA, via une API
Le toolkit Keap couvre les contacts, les tags, les opportunités et étapes du pipeline de vente, les notes, les tâches et les utilisateurs : lister, créer et modifier des contacts, appliquer ou retirer des tags, créer et déplacer des opportunités, et consigner notes et tâches. Le client connecte Keap une fois par OAuth, et votre produit ou agent IA appelle chaque opération via un seul endpoint Connect.
15 jours d'essai. Sans carte bancaire.
POST https://connect.reportei.com/api/tools/keap_create_contact/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"given_name": "<given_name>"
}
}Fonctionnement
Du client connecté au premier appel à Keap.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte Keap. 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 Keap.
Capture de leads dans Keap
Créez ou mettez à jour un contact quand quelqu'un s'inscrit dans votre produit, avec duplicate_option pour éviter les doublons, puis appliquez un tag qui lance la bonne automatisation.
Pipeline mis à jour par votre app
Créez une opportunité à une étape du pipeline et changez son stage_id quand une affaire avance, pour que le pipeline du client reflète ce qui se passe dans votre produit.
Agent IA assistant commercial
Laissez un agent retrouver un contact, consigner une note après un appel et créer une tâche assignée au bon utilisateur.
Tools
14 tools Keap
- Lister les contactsGETListe les contacts de l'app Keap dans contacts, avec next_page_token pour la page suivante. Sans fields, chaque contact vient avec un ensemble de propriétés par défaut. Filtrez par email, nom, ids et autres champs avec filter.
- Créer un contactPOSTCrée un contact et le renvoie. Il faut au moins un élément dans email_addresses, phone_numbers ou addresses. Avec duplicate_option, un contact correspondant est mis à jour au lieu d'en créer un nouveau.
- Modifier un contactPATCHMet à jour les champs envoyés et renvoie le contact. Les champs omis gardent leurs valeurs, mais chaque liste envoyée (email_addresses, phone_numbers, addresses) remplace toute la liste.
- Lister les tagsGETListe les tags de l'app Keap dans tags, avec id, name, description et category, et next_page_token pour la page suivante.
- Créer un tagPOSTCrée un tag et le renvoie avec son id. Le tag n'est appliqué à personne avant Appliquer un tag.
- Appliquer un tagPOSTApplique un tag à un ou plusieurs contacts. Appliquer un tag peut déclencher les automatisations de l'app Keap qui l'écoutent, comme les séquences d'emails.
- Retirer un tagPOSTRetire un tag d'un ou plusieurs contacts. Le tag lui-même reste dans l'app Keap.
- Lister les opportunitésGETListe les opportunités du pipeline de vente dans opportunities, chacune avec son contact, son étape et son utilisateur, et next_page_token pour la page suivante.
- Créer une opportunitéPOSTCrée une opportunité pour un contact à une étape du pipeline et la renvoie. opportunity_title, contact_id et stage_id sont obligatoires.
- Modifier une opportunitéPATCHMet à jour les champs envoyés et renvoie l'opportunité. Les champs omis gardent leurs valeurs. Déplacer l'opportunité vers une autre étape revient à changer stage_id.
OAuth avec l'app de votre produit
Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/keap, et votre client autorise le compte sur un écran de consentement. Connect renouvelle le token avant son expiration.
Questions sur le toolkit Keap
Dois-je intégrer l'API Keap moi-même ?
Non. Connect fournit 14 tools Keap 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 Keap ?
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.
