Priorice las sesiones rotas con un conector de Meta Muse para análisis de sesiones

Un agente que saca cifras de tráfico y un agente que prioriza sesiones rotas hacen trabajos distintos, y un conector de Meta Muse para análisis de sesiones es el segundo tipo. La salida no es un gráfico sino una lista corta y ordenada de lo que falló en su sitio, con grabaciones adjuntas, así que el agente decide qué abre una persona a continuación.

En corto: tres de los cuatro endpoints de sesión solo leen. Construya el conector, pegue un token de workspace flow_ws_ en el campo seguro de credenciales de Muse y dígale en ese mismo mensaje que PATCH /issues/{issueId} está prohibido.

Muse escribe el conector por su cuenta a partir de una especificación de API pública, y Parallel informó el 14 de septiembre de 2026 de que el código que escribe se ejecuta dentro de la propia celda de ejecución en la nube del agente. La guía conector de Meta Muse para analítica web cubre ese mecanismo y el flujo de credenciales. Este artículo trata de apuntarlo a los problemas.

¿Qué ve el conector cuando Muse abre un problema?

Muse ve el registro del problema que produjo Flowsery, no la grabación que hay detrás. La detección de Flowsery saca a la luz clics de rabia, errores de JavaScript, clics muertos y abandonos, y cada registro lleva un título, una descripción, una gravedad, un estado, sessionsCount, firstSeenAt, lastSeenAt, stepsToReplicate ordenados y un sampleRecordingId.

La gravedad toma low, medium, high y critical. Un token de workspace abarca todos los sitios web del workspace, así que cada llamada necesita websiteId o domain para nombrar uno.

GET /issues/{issueId} es la llamada que conviene enseñar pronto a Muse, porque devuelve los comentarios que su equipo dejó en un problema junto con las sesiones. Eso separa un abandono que nadie ha visto de uno que alguien ya miró el jueves pasado.

¿Puede Muse ver una repetición de sesión?

No. Una repetición tiene forma de vídeo y la API devuelve JSON, así que Muse lee un resumen estructurado de una grabación en lugar de la grabación. Lo más cerca que llega la API es el array occurrences: cada momento marcado lleva una descripción, una gravedad y un desplazamiento atSeconds dentro de la grabación.

La versión práctica: Muse puede decirle que un grupo de clics de rabia afectó a 41 sesiones, leerle los pasos para reproducirlo y nombrar la grabación que mejor lo muestra. No puede decirle que el botón de enviar se veía deshabilitado. La vía del navegador no lo rescata: Meta dice que el subagente de navegador lee una instantánea del árbol de accesibilidad, no el DOM en crudo.

¿Qué se pega en Muse para construir el conector?

Un solo mensaje que lleve la URL de la especificación, el estilo de autenticación y la prohibición de escritura. La prohibición va en el primer mensaje y no en una corrección posterior, porque el conector que Muse guarda se construye con lo que leyó durante la configuración.

Build a custom connector for Flowsery from the API reference at
https://flowsery.com/docs/api-introduction.md. It is public, so read it
without logging in. Full spec: https://flowsery.com/openapi.json.
 
Base URL: https://analytics.flowsery.com/analytics/api/v1
Auth: an "Authorization: Bearer <token>" header. I will paste the token into
the secure credential prompt, not into this chat. It starts with flow_ws_.
 
Use GET /issues, GET /issues/{issueId} and GET /visitors/{visitorId} only.
Do not call PATCH /issues/{issueId}. Start with GET /websites and list the
website IDs you can see.

La guía de analítica web recorre el campo de credenciales paso a paso. Lo que cambia en los problemas es el último párrafo: nombre las tres lecturas, nombre la única escritura, prohíbala. Luego pida los problemas críticos abiertos de un sitio web, lo que ejercita la vía de lectura y no escribe nada.

¿Qué llamadas de sesión leen y cuál escribe?

Importan cuatro endpoints y exactamente uno modifica datos: PATCH /issues/{issueId} actualiza el estado de un problema, y ahí está todo el asunto de la supervisión.

Mantenga el conector en solo lectura la primera semana. Por qué un conector que Muse escribió por su cuenta recibe menos aislamiento que uno integrado, y qué hacen al respecto los valores por defecto de aprobación de Meta, es el tema de la guía de analítica web. En los problemas esa postura no cuesta nada, porque el triaje nunca necesita la escritura.

¿Se le debe permitir a Muse cambiar el estado de un problema?

No en la primera semana, y tampoco según un horario después. Un agente que tiene PATCH /issues/{issueId} puede resolver algo que nadie miró, y un problema resuelto sale de la lista que todo el mundo abre por la mañana. Suspenderlo es peor: un problema suspendido desaparece de la respuesta por defecto de GET /issues hasta que alguien pide status=suspended.

La higiene de estados es justo la tarea en la que un agente luce bien, y un barrido que pasa doce críticos obsoletos a resolved produce una lista más corta con el mismo checkout roto debajo.

Meta dice que algunas acciones del agente no se pueden deshacer y deja el arreglo en sus manos. A 20 de septiembre de 2026 su rastro es el registro de Actividad de Muse, un historial cronológico de las acciones que tomó y los permisos que usted concedió, así que léalo antes de ampliar un permiso. Permita una escritura una sola vez, para el problema que tiene delante, después de haber abierto la repetición.

¿Qué falla específicamente en el análisis de sesiones?

Cinco cosas salen mal aquí que no salen mal en un conector de informes.

Una regla se traslada desde la guía de analítica web: la VM de Muse vive en la nube de Meta, así que cualquier cosa detrás de su VPN o en su portátil queda fuera de alcance. Para el mismo circuito sin Muse, la plantilla de Grok Bot para análisis de sesiones ejecuta la misma cadena de llamadas.

Preguntas frecuentes

¿Meta Muse admite MCP para el análisis de sesiones?

Parallel no encontró ningún ajuste de "add MCP server" el 14 de septiembre de 2026, y la guía de analítica web tiene la respuesta completa sobre MCP. Para el triaje no cambia nada: las tres lecturas y la única escritura van por REST en cualquier caso, y el servidor MCP alojado de Flowsery sirve a Claude, Cursor y Codex en su lugar.

¿Puede Muse cerrar un problema de Flowsery por su cuenta?

Solo si usted se lo permite. PATCH /issues/{issueId} es la única llamada que mueve un problema entre open, in_progress, resolved y suspended, y el mensaje de configuración de arriba lo prohíbe sin rodeos. Los avisos de aprobación de Meta aparecen en la interfaz del cliente y no en el chat, así que una escritura inesperada se ve antes de que ocurra.

¿Qué ve Muse sobre un visitante?

Más que una cronología. GET /visitors/{visitorId} devuelve un bloque identity con país, región, ciudad, navegador, SO, dispositivo y viewport, más activity, revenue y un profile con userId, name y email una vez que su sitio ha llamado a identify. El id de visitante es el valor propio _fs_vid, y Flowsery no almacena direcciones IP ni fija identificadores entre sitios. Decida si Muse debe tener eso antes de crear el token.

¿Esto sustituye a abrir la repetición?

No. El conector ordena y acota, y la grabación es donde vive el motivo. Deje que Muse elija las tres sesiones que valen diez minutos, y luego dedique los diez minutos. Las preguntas agregadas pertenecen al lado de analítica web del mismo conector.

¿Qué plan de Flowsery necesito?

Cualquiera de los dos. GET /issues y el análisis de sesiones con IA que hay detrás están en Team, a $250 al mes, y en Pro, a $500 al mes, y ambos abren con una prueba gratuita de 14 días que no pide tarjeta. La guía de analítica web desglosa los límites de puestos, sitios web y retención de grabaciones que los separan.

¿Qué necesita Muse para llamar a GET /issues con un token de workspace?

Un token de workspace cubre todos los sitios web del workspace, así que cada llamada necesita websiteId o domain para nombrar uno. Sin eso, Flowsery devuelve 404 Website not found, no un error de autenticación. Dile a Muse que ejecute primero GET /websites y arrastre el ID.

¿De dónde saca Muse un ID de visitante para GET /visitors/{visitorId}?

De GET /realtime/map, la única lectura que devuelve visitorId. El endpoint espera un valor _fs_vid y ningún payload de problema lo incluye. Un id inventado devuelve 404, así que dile a Muse que no invente ninguno.

¿Qué pasa cuando Muse llega a un límite de tasa de Flowsery?

Flowsery responde con un 429 y añade Retry-After en segundos. Cada respuesta también incluye RateLimit-Remaining y RateLimit-Reset. Dile a Muse que lea esas cabeceras y ajuste el ritmo en lugar de reintentar a ciegas.

¿Por qué falta un problema suspendido en los resultados de Muse?

GET /issues omite los problemas suspendidos en la respuesta por defecto hasta que pides status=suspended. Los cuatro estados son open, in_progress, resolved y suspended. Si un problema desapareció sin que lo esperaras, revisa el Activity log de Muse.

¿Qué debe hacer Muse cuando un problema no tiene grabación de muestra?

sampleRecordingId puede ser nulo, así que algunos problemas llegan sin nada que abrir. Muse debe informar del problema sin grabación en lugar de sustituirla por una cercana. Aun así recibes su gravedad y sessionsCount.

Cree un token de workspace y ejecute un barrido de problemas de solo lectura, o lea antes la referencia de la API.

Fuentes: el artículo de ayuda de Meta sobre los conectores de Muse, How we built safety into Muse, el análisis de Parallel sobre las integraciones personalizadas de Muse (14 de septiembre de 2026), y la referencia de la API de Flowsery. Revisado el 20 de septiembre de 2026.