Saltar al contenido principal

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​

  1. Pulse Crear usuario de BI y dele una Etiqueta de 1 a 80 caracteres, por ejemplo Power BI.
  2. 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.
  3. 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.

VistaUna fila porColumnas principales
bi_cdrllamadacall_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_queueevento de colats, queue_id, call_id, event, agent_extension_id, agent_user_id, wait_ms, position, reason
bi_smsSMS o MMSts, message_id, conversation_id, direction, status, kind, from_number, to_number, segments, media_count, error_code
bi_aillamadacall_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 plugins de 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 init de nuevo (solo agrega los secretos que faltan) e inicie con -f compose.yaml -f compose.bi-feed.yaml.
  • Kubernetes: mpbx init escribe la contraseña en el Secret de la instalación; agregue el componente bi-feed a su overlay.
  • Configuración propia: defina clickhouse.bi_admin_user, clickhouse.bi_admin_password y, 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​

LlamadaPermiso
GET /api/v1/integrations/bi-feed: datos de conexión, vistas y credencialesintegrations:read
POST /api/v1/integrations/bi-feed/credentials con {"label": "Power BI"}: la respuesta trae la contraseña una sola vezintegrations: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/).