Analítica
Baremetrics en tu producto y en tus agentes de IA, con una API
El toolkit de Baremetrics lee las métricas de la cuenta por día, con desglose por plan y los clientes detrás de cada métrica, además de fuentes, planes, clientes, suscripciones y usuarios. También crea y elimina anotaciones en los gráficos. Con Connect, un producto o agente de IA accede a estos datos sin construir la integración con Baremetrics.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/baremetrics_create_annotation/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"metric": "<metric>",
"annotation": "<annotation>",
"date": "<date>",
"global": true,
"user_id": "<user_id>"
}
}Cómo funciona
Del cliente conectado a la primera llamada a Baremetrics.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Baremetrics. 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 Baremetrics.
Métricas en tu dashboard
Trae mrr, arr, arpu y user_churn de un rango de fechas y muéstralos junto al resto de los datos de tu cliente.
Explicar un pico de churn
Deja que un agente de IA liste los clientes detrás de una métrica en un día y el desglose por plan, y resuma qué cambió.
Anotar lanzamientos
Crea una anotación en el gráfico cuando tu producto lance una versión o inicie una campaña, para que la fecha aparezca en los gráficos de Baremetrics.
Tools
12 tools de Baremetrics
- Listar fuentesGETLista las fuentes de la cuenta: cada proveedor de pagos conectado, como Stripe, y la propia API de Baremetrics. El id de una fuente es el source_id que aceptan planes, clientes y suscripciones.
- Obtener resumen de métricasGETDevuelve todas las métricas de la cuenta para cada día de un rango de fechas, como mrr, arr, arpu, ltv, active_customers, new_customers y user_churn. Los valores monetarios vienen en centavos.
- Obtener métricaGETDevuelve el valor de una métrica para cada día de un rango de fechas, cada uno con el valor de compare_to días antes y el cambio porcentual. Los valores monetarios vienen en centavos, así que un mrr de 6024087 es 60.240,87.
- Listar clientes de una métricaGETLista, para cada día de un rango de fechas, los clientes que componen una métrica, con la contribución de cada uno al MRR en centavos y el plan actual y el anterior. Por ejemplo, la métrica upgrades devuelve los clientes que hicieron upgrade en el rango.
- Obtener métrica por planGETDesglosa una métrica por plan para cada día de un rango de fechas: cada valor viene con el plan al que pertenece. Los valores monetarios vienen en centavos.
- Listar planesGETLista los planes de una fuente con name, oid, intervalo de facturación e importes en centavos. La respuesta tiene meta.pagination.has_more; envía page para leer la página siguiente.
- Listar clientesGETLista los clientes de una fuente con oid, correo, LTV y MRR actual en centavos, planes actuales y si están activos o cancelados. La respuesta tiene meta.pagination.has_more; envía page para leer la página siguiente.
- Listar suscripcionesGETLista las suscripciones de una fuente con cliente, plan, cantidad, descuento y las fechas de inicio y cancelación como timestamps Unix. La respuesta tiene meta.pagination.has_more; envía page para leer la página siguiente.
- Listar usuariosGETLista los usuarios de la cuenta de Baremetrics con id, nombre, correo y si son administradores. El id es el user_id que acepta Create annotation.
- Listar anotacionesGETLista las anotaciones de los gráficos, cada una con id, métrica, texto, fecha, si aparece en todos los gráficos y el usuario que la agregó. La respuesta tiene meta.pagination.has_more; envía page para leer la página siguiente.
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.
Preguntas sobre el toolkit de Baremetrics
¿Necesito implementar la API de Baremetrics?
No. Connect ya trae 12 tools de Baremetrics 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 Baremetrics?
Con el modo que acepta el toolkit: Clave de API. 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.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
