API Ploomes : ce qu'on peut faire et comment l'utiliser avec des agents IA
L'API de Ploomes, CRM brésilien, permet de lire et d'écrire les clients, contacts, affaires, propositions, tâches et interactions. Elle sert aux entreprises B2B brésiliennes et aux intégrateurs qui relient Ploomes à l'ERP et au support. L'accès se fait par une clé d'utilisateur d'intégration générée dans le compte, sur une API REST dont les requêtes suivent le standard OData.
Ce que propose l’API Ploomes
Clients et contacts
Entreprises et personnes, avec champs standard et personnalisés.
Affaires
Opportunités, entonnoirs, étapes et montants.
Propositions et documents
Devis et propositions générés à partir de modèles.
Tâches
Activités de l'équipe avec responsable et échéance.
Interactions
Traces de contact, comme appels, e-mails et réunions.
Webhooks
Alertes de création et de modification d'enregistrements.
Comment accéder à l’API Ploomes
- Avec les identifiants de votre entrepriseUne clé d'utilisateur (User-Key) est générée pour un utilisateur d'intégration du compte Ploomes et envoyée dans l'en-tête des requêtes. Les droits suivent le profil de cet utilisateur.
- La clé hérite des droits de l'utilisateur : utilisez un profil dédié et restreint.
- Des limites de requêtes s'appliquent ; préférez les webhooks aux interrogations répétées.
- Les données de contacts B2B sont aussi des données personnelles au regard de la LGPD, la loi brésilienne de protection des données.
Documentation officielle: developers.ploomes.com
Ce qu’un agent iTeam fait avec l’API Ploomes
Proposition envoyée puis oubliée
L'agent suit les propositions sans réponse et relance par e-mail sur le ton du commercial, en consignant l'interaction dans l'affaire.
Lead du site directement dans l'entonnoir
Le formulaire arrive chez l'agent, qui qualifie, crée le client et l'affaire dans Ploomes et planifie la réunion du commercial.
Prévision hebdomadaire
Chaque vendredi, l'agent consolide les affaires par étape et par probabilité et les envoie au directeur commercial, avec celles qui ont changé d'étape.
Après-vente déclenchée
Quand l'affaire est gagnée, l'agent crée les tâches de mise en place et prévient l'équipe des opérations.
De l’identifiant à l’agent au travail, avec validation
Créer un utilisateur d'intégration
Dans Ploomes, générez la User-Key d'un utilisateur au profil restreint à ce dont les agents ont besoin.
Enregistrer la clé dans le coffre d'iTeam
La clé est conservée dans le coffre et chaque agent ne reçoit que les actions autorisées, comme créer des interactions sans supprimer d'affaires.
Tester avec validation
Les messages aux clients et les changements d'étape démarrent avec une validation humaine.
Équipes IA prêtes à l’emploi qui utilisent Ploomes
Questions sur l’API Ploomes
L'API de Ploomes est-elle gratuite ?
En général, l'accès à l'API fait partie de l'abonnement Ploomes ; vérifiez les conditions de votre offre.
Faut-il programmer pour utiliser l'API de Ploomes avec iTeam ?
Pas nécessairement. L'outil HTTP d'iTeam lit la documentation et l'équipe de déploiement configure les flux.
Peut-on filtrer les affaires par champs personnalisés ?
Oui, les requêtes au standard OData permettent de filtrer et d'étendre des champs, y compris personnalisés.
