Listar problemas detectados por IA

api-referenceGET

GEThttps://analytics.flowsery.com/analytics/api/v1/issues

Liste os problemas que a IA do Flowsery detectou ao analisar as gravações de sessão, deduplicados entre sessões e classificados por gravidade.

Token Bearer (token de workspace ou chave API de website)

Os tokens do espaço de trabalho precisam de um seletor de site

Os tokens da API do Workspace podem acessar todos os sites do workspace. Passe <code>websiteId</code> ou <code>domain</code> para que Flowsery saiba qual site consultar ou alterar. As chaves da API do site já têm como escopo um site, portanto o seletor pode ser omitido.

Seletor de site

Parametro	Tipo	Descricao
`websiteId`	`string`	ID do site a ser usado com um token de API do workspace. Omitir ao autenticar com uma chave de API de site.
`domain`	`string`	Site domain para usar com um token de API do espaço de trabalho quando websiteId não for fornecido. Omitir ao autenticar com uma chave de API de site.

Problemas suspensos ficam ocultos por padrão

A lista exclui problemas suspensos, a menos que sejam solicitados explicitamente com <code>status=suspended</code>.

Parametros opcionais

Parametro	Tipo	Descricao
`status`	`string`	Filtra por status de fluxo de trabalho: open, in_progress, resolved ou suspended. Se omitido, retorna todos os status exceto suspended.
`severity`	`string`	Filtra por gravidade: low, medium, high ou critical.
`search`	`string`	Busca textual nos títulos e descrições dos problemas. Máx. 200 caracteres.
`sort`	`string`	severity (padrão) ordena os problemas mais graves primeiro; recency ordena por lastSeenAt, dos mais recentes aos mais antigos.
`limit`	`number`	Número máximo de problemas a retornar (padrão: 100, máx: 1000).
`offset`	`number`	Linhas a pular para paginacao (min 0, padrao: 0).

Campos de resposta

Parametro	Tipo	Descricao
`id`	`string`	Identificador único do problema. Passe-o como issueId nos endpoints de detalhe e atualização.
`websiteId`	`string`	Site ao qual o problema pertence.
`title`	`string`	Resumo curto do problema gerado por IA.
`description`	`string`	Explicação gerada por IA do que dá errado e de como isso afeta os visitantes.
`severity`	`string`	Avaliação de impacto atribuída pela IA: low, medium, high ou critical.
`status`	`string`	Status de fluxo de trabalho: open, in_progress, resolved ou suspended.
`sessionsCount`	`number`	Quantas sessões analisadas encontraram este problema.
`firstSeenAt`	`string`	Quando o problema foi detectado pela primeira vez em uma gravação.
`lastSeenAt`	`string`	Gravação mais recente em que o problema apareceu.
`stepsToReplicate`	`array`	Passos ordenados de reprodução, derivados das gravações em que o problema ocorreu.
`sampleRecordingId`	`string`	Gravação que melhor demonstra o problema.
`externalTicketProvider / externalTicketKey / externalTicketUrl`	`string \| null`	Ticket vinculado em um rastreador externo, ou null quando nenhum ticket está vinculado.
`counts`	`object`	Totais de problemas por status (open, inProgress, resolved) do site selecionado, independentemente da janela de paginação.

Listar todos os problemas

curl --request GET \
  --url https://analytics.flowsery.com/analytics/api/v1/issues \
  --header 'Authorization: Bearer <api-key>'

Filtrar problemas críticos abertos

curl --request GET \
  --url "https://analytics.flowsery.com/analytics/api/v1/issues?status=open&severity=critical&search=checkout&sort=recency" \
  --header 'Authorization: Bearer <api-key>'

200

{
  "status": "success",
  "data": [
    {
      "id": "iss_64f1c2a9e8b4d90012ab34cd",
      "websiteId": "flid_abc123",
      "title": "Checkout button unresponsive on mobile Safari",
      "description": "Tapping the checkout button produces no navigation or feedback. Visitors tap repeatedly and abandon the cart.",
      "severity": "critical",
      "status": "open",
      "sessionsCount": 14,
      "firstSeenAt": "2026-08-02T09:14:31.000Z",
      "lastSeenAt": "2026-08-27T18:40:05.000Z",
      "stepsToReplicate": [
        "Open the store on an iPhone in Safari",
        "Add any product to the cart",
        "Tap the checkout button on the cart page"
      ],
      "sampleRecordingId": "rec_9f8e7d6c5b4a",
      "externalTicketProvider": "linear",
      "externalTicketKey": "SHOP-142",
      "externalTicketUrl": "https://linear.app/acme/issue/SHOP-142"
    },
    {
      "id": "iss_64f1c2a9e8b4d90012ab34ce",
      "websiteId": "flid_abc123",
      "title": "Pricing table overflows on narrow viewports",
      "description": "The pricing table renders outside the viewport below 375px, hiding the yearly plan column.",
      "severity": "medium",
      "status": "in_progress",
      "sessionsCount": 6,
      "firstSeenAt": "2026-08-10T12:03:12.000Z",
      "lastSeenAt": "2026-08-25T07:55:48.000Z",
      "stepsToReplicate": [
        "Open /pricing on a viewport narrower than 375px",
        "Scroll horizontally inside the pricing table"
      ],
      "sampleRecordingId": "rec_1a2b3c4d5e6f",
      "externalTicketProvider": null,
      "externalTicketKey": null,
      "externalTicketUrl": null
    }
  ],
  "counts": {
    "open": 5,
    "inProgress": 2,
    "resolved": 11
  },
  "pagination": {
    "limit": 100,
    "offset": 0,
    "total": 7
  }
}