Analítica
Segment en tu producto y en tus agentes de IA, con una API
El toolkit de Segment lee las fuentes, los destinos y los data warehouses de un workspace en la región US mediante la Public API, además de métricas de entrega, sincronizaciones de warehouse y el volumen de eventos recibidos. Con Connect, un producto o agente de IA inspecciona el pipeline de datos del cliente sin construir la integración.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/segment_list_sources/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {}
}Cómo funciona
Del cliente conectado a la primera llamada a Segment.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Segment. 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 Segment.
Salud del pipeline en tu producto
Muestra qué destinos reciben datos de cada fuente y lee las métricas de entrega de un período para detectar entregas fallidas.
Revisión de sincronizaciones del warehouse
Lista las últimas sincronizaciones de un warehouse con estado y duración para comprobar si los datos están llegando.
Volumen de eventos para un agente
Deja que un agente de IA lea cuántos eventos recibió el workspace por intervalo, agrupados por fuente o nombre de evento, y explique una caída o un pico.
Tools
11 tools de Segment
- Listar fuentesGETLista las fuentes del workspace con id, name, slug, enabled, metadata y labels. Devuelve las primeras 200, porque la conexión no envía paginación; pagination.totalEntries indica si hay más.
- Obtener fuenteGETDevuelve una fuente con su configuración, write keys, metadata y labels.
- Listar destinos conectadosGETLista los destinos que reciben datos de una fuente, con id, name, enabled y metadata. Devuelve los primeros 200, porque la conexión no envía paginación.
- Listar warehouses conectadosGETLista los warehouses que reciben datos de una fuente. Devuelve los primeros 200, porque la conexión no envía paginación.
- Listar destinosGETLista los destinos del workspace con id, name, enabled, metadata y el sourceId al que pertenece cada uno. Devuelve los primeros 200, porque la conexión no envía paginación; pagination.totalEntries indica si hay más.
- Obtener destinoGETDevuelve un destino con su configuración, metadata y el sourceId al que pertenece.
- Obtener métricas de entregaGETDevuelve las métricas de entrega de un destino para los eventos de una fuente en un período, cada métrica con su total y desglose. Sin fechas, cubre la última hora por minuto.
- Listar warehousesGETLista los warehouses del workspace con id, enabled, metadata y settings. Devuelve los primeros 200, porque la conexión no envía paginación; pagination.totalEntries indica si hay más.
- Obtener warehouseGETDevuelve un warehouse con su configuración y metadata.
- Listar sincronizaciones del warehouseGETLista las últimas sincronizaciones de un warehouse, con estado y duración, para comprobar si los datos están llegando. Devuelve las primeras 200, porque la conexión no envía paginación.
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 Segment
¿Necesito implementar la API de Segment?
No. Connect ya trae 11 tools de Segment 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 Segment?
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.
