API de Ploomes: qué puedes hacer y cómo usarla con agentes de IA
Ploomes es un CRM brasileño. Su API permite leer y escribir clientes, contactos, negocios, propuestas, tareas e interacciones. La usan empresas B2B de Brasil e integradores que conectan Ploomes con el ERP y la atención al cliente. El acceso es por una clave de usuario de integración generada en la cuenta, en una API REST con consultas en el estándar OData.
Qué ofrece la API de Ploomes
Clientes y contactos
Empresas y personas, con campos estándar y personalizados.
Negocios
Oportunidades, embudos, etapas e importes.
Propuestas y documentos
Cotizaciones y propuestas generadas a partir de plantillas.
Tareas
Actividades del equipo con responsable y fecha límite.
Interacciones
Registros de contacto, como llamadas, correos y reuniones.
Webhooks
Avisos de creación y modificación de registros.
Cómo acceder a la API de Ploomes
- Con las credenciales de tu empresaClave de usuario (User-Key) generada para un usuario de integración en la cuenta de Ploomes y enviada en la cabecera de las solicitudes. Los permisos siguen el perfil de ese usuario.
- La clave hereda los permisos del usuario: usa un perfil dedicado y restringido.
- Hay límites de solicitudes; prefiere los webhooks a las consultas repetidas.
- Los datos de contactos B2B también son personales según la LGPD, la ley de protección de datos de Brasil.
Documentación oficial: developers.ploomes.com
Qué hace un agente de iTeam con la API de Ploomes
Propuesta enviada y olvidada
El agente sigue las propuestas sin respuesta y hace el seguimiento por correo con el tono del vendedor, registrando la interacción en el negocio.
Lead del sitio directo al embudo
El formulario llega al agente, que califica, crea el cliente y el negocio en Ploomes y programa la reunión del ejecutivo.
Previsión semanal
Cada viernes, el agente consolida los negocios por etapa y probabilidad y los envía al director comercial, destacando los que cambiaron de etapa.
Posventa activada
Cuando se gana el negocio, el agente crea las tareas de implantación y avisa al equipo de operaciones.
De la credencial al agente trabajando, con aprobación
Crea un usuario de integración
En Ploomes, genera la User-Key de un usuario con un perfil restringido a lo que necesitan los agentes.
Registra la clave en la bóveda de iTeam
La clave queda en la bóveda y cada agente recibe solo las acciones permitidas, como crear interacciones sin borrar negocios.
Prueba con aprobación
Los mensajes a clientes y los cambios de etapa empiezan con aprobación humana.
Equipos de IA listos que usan Ploomes
Preguntas sobre la API de Ploomes
¿La API de Ploomes es gratuita?
En general, el acceso a la API forma parte de la suscripción a Ploomes; confirma las condiciones de tu plan.
¿Necesito programar para usar la API de Ploomes con iTeam?
No necesariamente. La herramienta HTTP de iTeam lee la documentación y el equipo de implantación configura los flujos.
¿Se pueden filtrar los negocios por campos personalizados?
Sí, las consultas en el estándar OData permiten filtrar y expandir campos, también los personalizados.
