Feed de BI
El feed de BI da a Power BI, Looker Studio y Metabase acceso SQL de solo lectura a las métricas de llamadas, colas, SMS e IA de su propia empresa. Cada credencial es un usuario de base de datos de solo lectura que ve únicamente las filas de su empresa. No hay ruta de escritura.
Abra Admin > Conexiones > Feed de BI (/admin/bi-feed). Necesita integrations:read para ver los datos de conexión e integrations:write para emitir y revocar credenciales.
Emitir una credencial
- Pulse Crear usuario de BI y dele una Etiqueta de 1 a 80 caracteres, por ejemplo
Power BI. - Copie la Contraseña de inmediato. Se muestra una sola vez y no se puede recuperar. Si la pierde, revoque la credencial y emita una nueva.
- Use la Dirección, la Base de datos, el Usuario y la contraseña en su herramienta de BI.
Una empresa puede tener 10 credenciales activas. Revocar elimina el usuario de base de datos de inmediato. Emitir y revocar se escriben en la bitácora de auditoría.
Si la Dirección muestra "El administrador no la publicó", o la página responde que la función no está configurada, el operador no configuró el feed de BI. Vea Configuración del operador.
Qué ve una herramienta de BI
Cuatro vistas, con horas en UTC. Cada vista tiene además una columna tenant_id, siempre su empresa.
| Vista | Una fila por | Columnas principales |
|---|---|---|
bi_cdr | llamada | call_id, start_time, answer_time, end_time, direction, caller_e164, callee_e164, did, trunk_id, disposition, ring_ms, talk_ms, hold_ms, queue_wait_ms, cost_micros, tags, sip_final_code |
bi_queue | evento de cola | ts, queue_id, call_id, event, agent_extension_id, agent_user_id, wait_ms, position, reason |
bi_sms | SMS o MMS | ts, message_id, conversation_id, direction, status, kind, from_number, to_number, segments, media_count, error_code |
bi_ai | llamada | call_id, start_time, direction, disposition, talk_ms, has_ai_summary, ai_summary_chars, ai_summary |
No se exponen las referencias a grabaciones ni las cadenas marcadas sin procesar. ai_summary es el texto del resumen de IA de la llamada, así que trate un espacio de BI que lo contenga como trata las grabaciones.
La credencial tiene SELECT sobre estas cuatro vistas y nada más. Una política de filas en cada vista filtra las filas a su empresa, así que un WHERE, una subconsulta o un UNION no pueden eludirla. El usuario es de solo lectura y sus consultas tienen límites (60 segundos cada una, 1,000,000 de filas de resultado).
Conectar una herramienta
- Power BI. Use la interfaz HTTP de ClickHouse mediante una fuente de datos web con credenciales Basic (el usuario y la contraseña de arriba). No se necesita ningún controlador. Un controlador ODBC o un conector de ClickHouse funciona con el mismo usuario.
- Looker Studio. Use el conector MySQL integrado contra el puerto MySQL de ClickHouse (9004) con la base de datos, el usuario y la contraseña, y una consulta personalizada por fuente de datos. El operador debe abrir ese puerto con TLS.
- Metabase. Agregue el controlador ClickHouse de código abierto a la carpeta
pluginsde Metabase (Metabase Cloud ya lo incluye) y luego agregue una base de datos ClickHouse con el host, el puerto, la base de datos, el usuario y la contraseña.
Las vistas leen datos en vivo y no están materializadas. Filtre los paneles pesados por start_time o ts.
Configuración del operador
Los servidores instalados con el instalador de MonoPbx no necesitan configuración: el instalador (y, en un servidor más
antiguo, la siguiente actualización) crea el usuario de base de datos que administra los usuarios de BI, guarda su
contraseña con los demás secretos de la instalación y activa el feed. La página Feed de BI de la consola muestra
entonces Feed de BI listo y ofrece Crear usuario de BI. Para mantener el feed desactivado, agregue
MPBX_BI_FEED=off al .env de la instalación y reinicie.
Las herramientas de BI se conectan directamente a la base de datos de análisis solo a través de una dirección que el
operador publica (un proxy inverso o una regla de firewall limitada a las redes que la necesitan). Mientras tanto, la
página lo indica y las empresas pueden crear usuarios de BI y descargar las vistas como CSV. Para mostrar la dirección
publicada en la página, defina MPBX_BI_PUBLIC_URL (por ejemplo https://bi.example.com) en .env.
Otras instalaciones:
- Docker Compose a mano: ejecute
mpbx initde nuevo (solo agrega los secretos que faltan) e inicie con-f compose.yaml -f compose.bi-feed.yaml. - Kubernetes:
mpbx initescribe la contraseña en el Secret de la instalación; agregue el componentebi-feeda su overlay. - Configuración propia: defina
clickhouse.bi_admin_user,clickhouse.bi_admin_passwordy, opcionalmente,clickhouse.bi_public_url.
Cuando el feed está desactivado, la página del feed de BI lo dice en una frase con un enlace a esta guía; la API responde
503 MPBX-API-NOT-CONFIGURED.
API
| Llamada | Permiso |
|---|---|
GET /api/v1/integrations/bi-feed: datos de conexión, vistas y credenciales | integrations:read |
POST /api/v1/integrations/bi-feed/credentials con {"label": "Power BI"}: la respuesta trae la contraseña una sola vez | integrations:write |
DELETE /api/v1/integrations/bi-feed/credentials/{id} | integrations:write |
Límites
- Una credencial ve las cuatro vistas.
- No hay exportación CSV para instalaciones que no pueden publicar ClickHouse.
- Las plantillas listas de Power BI, Looker Studio y Metabase están en el repositorio (
docs/guides/bi-feed/).