CRM y ventas
Capsule CRM en tu producto y en tus agentes de IA, con una API
El toolkit de Capsule CRM cubre personas y organizaciones, oportunidades con sus pipelines e hitos, usuarios y tareas. Con Connect, tu producto o agente de IA lo llama todo por un solo endpoint, mientras Connect guarda y renueva las credenciales y registra cada ejecución.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/capsule_create_party/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"party": {}
}
}Cómo funciona
Del cliente conectado a la primera llamada a Capsule CRM.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Capsule CRM. Recibes el id de la conexión.
- 2
Tu producto llama a la tool
Un POST a /api/tools/{tool}/execute con el id de la conexión y los argumentos. Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app.
- 3
Connect se encarga del resto
Guarda la credencial cifrada, renueva tokens en conexiones OAuth que admiten renovación y registra las ejecuciones en un historial de auditoría disponible por API.
Casos de uso
Qué hace tu producto con Capsule CRM.
Crea contactos desde registros
Un SaaS busca una party en Capsule y, si no existe, crea la persona y vincula la organización.
Abre negocios en un pipeline
Una herramienta de presupuestos crea una oportunidad en el hito correcto y la mueve a Won o Lost cuando se conoce el resultado.
Agente que programa seguimientos
Un agente de IA lista las tareas abiertas y crea una tarea con vencimiento en una fecha, vinculada a una party o a una oportunidad.
Tools
15 tools de Capsule CRM
- Listar partiesGETLista las personas y organizaciones de la cuenta, 50 por página por defecto. Pagina con page, empezando en 1, y perPage, hasta 100; una página más corta que perPage es la última.
- Buscar partiesGETBusca personas y organizaciones con los mismos resultados de la búsqueda global de Capsule, por nombre, código postal o teléfono, por ejemplo. Pagina con page, empezando en 1, y perPage, hasta 100.
- Obtener partyGETDevuelve una persona u organización, con sus correos, teléfonos, direcciones y sitios web y el id de cada uno.
- Crear partyPOSTCrea una persona o una organización. Envía firstName y lastName para una persona y name para una organización. organisation vincula una persona por id, o por nombre, lo que crea la organización si aún no existe. Sin owner, la party va al usuario conectado.
- Actualizar partyPUTActualiza una persona u organización; los campos omitidos no cambian. En los arrays, un elemento sin id se añade, un elemento con id se modifica y un elemento con id y _delete true se elimina. Los ids vienen de Obtener party.
- Listar oportunidadesGETLista las oportunidades de la cuenta, con party, milestone, value y expectedCloseOn, 50 por página por defecto. Pagina con page, empezando en 1, y perPage, hasta 100; una página más corta que perPage es la última.
- Crear oportunidadPOSTCrea una oportunidad para una party, en un milestone de un pipeline. name, party y milestone son obligatorios.
- Actualizar oportunidadPUTActualiza una oportunidad; los campos omitidos no cambian. Moverla a otro milestone, como Won o Lost, es un cambio de milestone.
- Listar pipelinesGETLista los pipelines de ventas de la cuenta. Usa el id de un pipeline en Listar milestones del pipeline.
- Listar milestones del pipelineGETLista los milestones de un pipeline, con la probabilidad de cada uno; complete es true en los que cierran la oportunidad, como Won y Lost. Usa el id de un milestone como milestone en las herramientas de oportunidades.
Clave de API
Tu cliente pega la clave de la app en una pantalla de Connect, o tu sistema envía la clave con POST /api/customer-toolkits, sin pantalla.
OAuth con la app de tu producto
Registras la app OAuth de tu producto una sola vez, con POST /api/merchants/credentials/capsule, y tu cliente autoriza la cuenta en una pantalla de consentimiento. Connect renueva el token cuando está por vencer.
Preguntas sobre el toolkit de Capsule CRM
¿Necesito implementar la API de Capsule CRM?
No. Connect ya trae 15 tools de Capsule CRM descritas y listas. Tu cliente conecta la cuenta y tu sistema llama a cada tool por el mismo endpoint, con el mismo formato de solicitud.
¿Cómo conecta mi cliente su cuenta de Capsule CRM?
Con el modo que acepta el toolkit: Clave de API, OAuth con la app de tu producto. Connect guarda la credencial cifrada y nunca la devuelve a tu sistema.
¿Funciona con agentes de IA?
Sí. El input de cada tool está descrito en JSON Schema, que tu agente usa directamente como definición de tool. El agente elige la tool y los argumentos, y tu sistema hace la llamada a Connect.
¿Mi cliente necesita una cuenta en Reportei?
No. Tu cliente conecta la cuenta en una pantalla de Connect, o tu sistema envía la credencial por la API, y sigue usando solo tu producto.
Toolkits de la misma categoría
Ver los 100 toolkitsMira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
