Faça a triagem de sessões quebradas com um conector do Meta Muse para análise de sessões

Um agente que puxa números de tráfego e um agente que faz a triagem de sessões quebradas fazem trabalhos diferentes, e um conector do Meta Muse para análise de sessões é do segundo tipo. A saída não é um gráfico, e sim uma lista curta e ordenada do que deu errado no seu site, com gravações anexadas, para o agente decidir o que um humano abre em seguida.

Versão curta: três dos quatro endpoints de sessão apenas leem. Monte o conector, cole um token de workspace flow_ws_ no campo seguro de credencial do Muse e diga a ele, na mesma mensagem, que PATCH /issues/{issueId} está proibido.

O próprio Muse escreve o conector a partir de uma spec de API pública, e a Parallel relatou em 14 de setembro de 2026 que o código que ele escreve roda dentro da célula de runtime em nuvem do próprio agente. O guia do conector do Meta Muse para analytics de site cobre esse mecanismo e o fluxo de credencial. Este post é sobre apontá-lo para os problemas.

O que o conector vê quando o Muse abre um problema?

O Muse vê o registro do problema que a Flowsery produziu, não a gravação por trás dele. A detecção da Flowsery revela cliques de raiva, erros de JavaScript, cliques mortos e abandonos, e cada registro carrega um título, uma descrição, uma gravidade, um status, sessionsCount, firstSeenAt, lastSeenAt, stepsToReplicate em ordem e um sampleRecordingId.

A gravidade aceita low, medium, high e critical. Um token de workspace cobre todos os sites do workspace, então cada chamada precisa de websiteId ou domain para nomear um deles.

GET /issues/{issueId} é a chamada que vale ensinar ao Muse logo no começo, porque ela devolve os comentários que seu time deixou em um problema junto com as sessões. Isso separa um abandono que ninguém viu de um que alguém já olhou na quinta-feira passada.

O Muse consegue assistir a uma gravação de sessão?

Não. Uma gravação tem formato de vídeo e a API devolve JSON, então o Muse lê um resumo estruturado de uma gravação em vez da gravação. O mais perto que a API chega é o array occurrences: cada momento sinalizado carrega uma descrição, uma gravidade e um deslocamento atSeconds dentro da gravação.

Na prática: o Muse consegue dizer que um cluster de cliques de raiva atingiu 41 sessões, ler para você os passos para reproduzi-lo e nomear a gravação que mostra isso melhor. Ele não consegue dizer que o botão de enviar parecia desabilitado. A rota do navegador não salva isso: a Meta diz que o subagente de navegação lê um snapshot da árvore de acessibilidade, não o DOM puro.

O que você cola no Muse para montar o conector?

Uma mensagem que carregue a URL da spec, o estilo de autenticação e a proibição de escrita. A proibição vai na primeira mensagem, e não em uma correção depois, porque o conector que o Muse salva é montado a partir do que ele leu durante a configuração.

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.

O guia de analytics de site percorre o campo de credencial passo a passo. O que muda nos problemas é o último parágrafo: nomeie as três leituras, nomeie a única escrita, proíba-a. Depois peça os problemas críticos abertos de um site, o que exercita o caminho de leitura e não escreve nada.

Quais chamadas de sessão leem, e qual escreve?

Quatro endpoints importam e exatamente um altera dados: PATCH /issues/{issueId} atualiza o status de um problema, e é aí que mora todo o problema de supervisão.

Mantenha o conector somente leitura na primeira semana. Por que um conector que o próprio Muse escreveu ganha menos isolamento do que um nativo, e o que os padrões de aprovação da Meta fazem a respeito, é assunto do guia de analytics de site. Nos problemas essa postura não custa nada, porque a triagem nunca precisa da escrita.

O Muse deve poder mudar o status de um problema?

Não na primeira semana, e não em horário fixo depois disso. Um agente com PATCH /issues/{issueId} na mão pode resolver algo que ninguém olhou, e um problema resolvido sai da lista que todo mundo abre de manhã. Suspenso é pior: um problema suspenso some da resposta padrão de GET /issues até alguém pedir status=suspended.

Higiene de status é exatamente a tarefa chata em que um agente parece bom, e uma varredura que move doze críticos parados para resolvido produz uma lista mais curta com o mesmo checkout quebrado embaixo dela.

A Meta diz que algumas ações do agente não podem ser desfeitas e deixa o conserto com você. Até 20 de setembro de 2026, sua trilha é o Activity log do Muse, um registro cronológico das ações que ele tomou e das permissões que você concedeu, então leia antes de ampliar uma permissão. Autorize uma escrita uma vez, para o problema na sua frente, depois de ter aberto a gravação.

O que quebra especificamente na análise de sessões?

Cinco coisas dão errado aqui que não dão errado em um conector de relatórios.

Uma regra vem junto do guia de analytics de site: a VM do Muse fica na nuvem da Meta, então qualquer coisa atrás da sua VPN ou no seu notebook está fora de alcance. Para o mesmo ciclo sem o Muse, o modelo de Grok Bot para análise de sessões roda a mesma cadeia de chamadas.

Perguntas frequentes

O Meta Muse suporta MCP para análise de sessões?

A Parallel não encontrou nenhuma configuração de "adicionar servidor MCP" em 14 de setembro de 2026, e o guia de analytics de site tem a resposta completa sobre MCP. Para a triagem isso não muda nada: as três leituras e a única escrita vão por REST de qualquer jeito, e o servidor MCP hospedado da Flowsery atende Claude, Cursor e Codex.

O Muse pode fechar um problema da Flowsery por conta própria?

Só se você deixar. PATCH /issues/{issueId} é a única chamada que move um problema entre open, in_progress, resolved e suspended, e a mensagem de configuração acima a proíbe de forma direta. Os pedidos de aprovação da Meta aparecem na interface do cliente, e não no chat, então uma escrita inesperada fica visível antes de acontecer.

O que o Muse vê sobre um visitante?

Mais do que uma linha do tempo. GET /visitors/{visitorId} devolve um bloco identity com país, região, cidade, navegador, sistema operacional, dispositivo e viewport, além de activity, revenue e um profile com userId, name e email quando o seu site já chamou identify. O id de visitante é o valor first-party _fs_vid, e a Flowsery não armazena endereços IP nem define identificadores entre sites. Decida se o Muse deve ter isso em mãos antes de criar o token.

Isso substitui abrir a gravação?

Não. O conector ordena e estreita, e o motivo mora na gravação. Deixe o Muse escolher as três sessões que valem dez minutos, e então gaste os dez minutos. Perguntas agregadas pertencem ao lado de analytics de site do mesmo conector.

De qual plano da Flowsery eu preciso?

Qualquer um dos dois. GET /issues e a análise de sessões por IA por trás dele estão tanto no Team a $250 por mês quanto no Pro a $500 por mês, e os dois começam com um teste grátis de 14 dias que não pede cartão. O guia de analytics de site detalha os limites de assentos, sites e retenção de gravações que separam os dois.

O que o Muse precisa para chamar GET /issues com um token de workspace?

Um token de workspace cobre todos os sites do workspace, então cada chamada precisa de websiteId ou domain para indicar um. Sem isso, a Flowsery retorna 404 Website not found, não um erro de autenticação. Diga ao Muse para rodar GET /websites primeiro e levar o ID adiante.

De onde o Muse tira um ID de visitante para GET /visitors/{visitorId}?

De GET /realtime/map, a única leitura que retorna visitorId. O endpoint recebe um valor _fs_vid, e nenhum payload de problema traz um. Um id inventado retorna 404, então diga ao Muse para não inventar nenhum.

O que acontece quando o Muse atinge um limite de taxa da Flowsery?

A Flowsery responde com 429 e adiciona Retry-After em segundos. Toda resposta também traz RateLimit-Remaining e RateLimit-Reset. Diga ao Muse para ler esses cabeçalhos e ajustar o ritmo em vez de tentar de novo às cegas.

Por que um problema suspenso não aparece nos resultados do Muse?

GET /issues deixa os problemas suspensos fora da resposta padrão até você pedir status=suspended. Os quatro status são open, in_progress, resolved e suspended. Se um problema sumiu sem você esperar, confira o Activity log do Muse.

O que o Muse deve fazer quando um problema não tem gravação de amostra?

sampleRecordingId pode ser nulo, então alguns problemas chegam sem nada para abrir. O Muse deve relatar o problema sem gravação em vez de trocar por uma próxima. Você ainda recebe a gravidade e o sessionsCount dele.

Crie um token de workspace e rode uma varredura de problemas somente leitura, ou leia a referência da API primeiro.

Fontes: artigo de ajuda da Meta sobre os conectores do Muse, How we built safety into Muse, análise da Parallel sobre integrações customizadas do Muse (14 de setembro de 2026) e a referência da API da Flowsery. Verificado em 20 de setembro de 2026.