Responda a perguntas de tráfego com um template de Grok Bot para analytics de site

Montar um template de Grok Bot para analytics de site é menos interessante do que aquilo que ele expõe. Números de tráfego em um chat são truque de festa. O que realmente vale colocar atrás de um agente é a lista de problemas que a Flowsery monta a partir das gravações de sessão, porque esses são os dados que ninguém abre com a frequência necessária.

Versão curta: instale o template da Flowsery em x.ai/bot/tOP05p0n0XVUcpJDfPH0k, cole um token de workspace no campo de credencial e pergunte: "quais são os problemas críticos abertos e quantas sessões cada um atingiu?"

O que é um template de Grok Bot?

Um template de Grok Bot é um link de compartilhamento que copia o Grok Bot já configurado de outra pessoa para o seu próprio app. A SpaceXAI ligou o recurso em 28 de agosto de 2026 com uma única frase publicada pela conta do Grok Bot: "agora você pode compartilhar templates dos seus Bots com outras pessoas". O link é x.ai/bot/ mais um id de 21 caracteres, e o botão "Add to Grok Bot" é um deep link para o app de desktop ou iOS, grokbot://app/v1/bot-template?id=<id>.

O Grok Bot foi lançado em 11 de agosto de 2026, em beta inicial. Cada Bot roda no próprio computador na nuvem, e é por isso que a xAI pode dizer que ele funciona "entre apps, ferramentas e sites, inclusive plataformas sem uma API limpa ou MCP". O acesso exige um plano pago elegível: SuperGrok, SuperGrok Plus ou SuperGrok Heavy, ou Cursor Pro, Pro+ ou Ultra, ou Cursor Teams Standard ou Premium. O preço de entrada em x.ai/bot é de $30 por mês no SuperGrok e $20 por mês no Cursor.

Por que colocar analytics atrás de uma interface de chat?

Uma interface de chat ganha quando a pergunta é exploratória e a pergunta seguinte importa mais do que a primeira resposta. Painéis são bons nas perguntas que você já sabia que tinha. Cada detalhamento da Flowsery, por página, referenciador, canal, campanha, país, dispositivo, navegador, é um gráfico que alguém precisa lembrar de abrir.

É na pergunta seguinte que um bot se justifica. "O tráfego caiu 18% em relação à semana passada" é uma chamada. "Qual canal, e a queda se concentrou em uma página?" são mais três, e um bot encadeia tudo sem que você decida a ordem de antemão.

O que vem no template de Grok Bot da Flowsery?

O template da Flowsery contém um perfil de bot, uma skill que descreve a API REST pública da Flowsery e uma rotina semanal. A skill é escrita em texto corrido para que qualquer pessoa que revise um template de terceiros consiga ler exatamente no que o bot pode mexer.

Purpose: query analytics and AI-detected issues through the Flowsery REST API.
 
Auth: every request needs the header "Authorization: Bearer <token>". The owner
creates a workspace token at https://flowsery.com/api-tokens (it starts with
flow_ws_). Keep it in the connector credential field, never in the conversation.
Workspace tokens span several websites, so pass websiteId or domain on every
call. GET /websites lists them.
 
Base URL: https://analytics.flowsery.com/analytics/api/v1
Full spec: GET /openapi.json on the same base URL, no auth needed.
 
Workflow:
1. GET /websites once to learn website IDs and domains.
2. Issues: GET /issues (filters: status open | in_progress | resolved |
   suspended, severity low | medium | high | critical, sort severity | recency)
   for the ranked list with sessions-affected counts. GET /issues/{issueId} for
   occurrences, affected sessions and steps to replicate. PATCH /issues/{issueId}
   with {"status": "resolved"} only when the owner says an issue is fixed.
3. Traffic: GET /overview and GET /timeseries for visitors, sessions, revenue
   and conversion over a startAt/endAt range. GET /realtime for who is on the
   site now.
4. Breakdowns: GET /pages, /referrers, /campaigns, /channels, /countries,
   /devices, /browsers to find where a drop-off concentrates.
5. Revenue: GET /goals for completions. POST /goals and POST /payments record
   server-side conversions.
 
Validation: confirm with the owner before any PATCH or POST. Reads need no
confirmation.
 
Failure: a 404 means the websiteId or domain does not belong to this workspace.
List /websites and ask, do not guess.

A regra do token de workspace é a que derruba todo mundo. Um token de workspace consegue ler vários sites, então cada chamada precisa de websiteId ou domain para dizer qual. Chaves de API de site já são restritas a um site só e podem dispensar o seletor. Erre nisso e você recebe um 404 que parece problema de permissão, mas é parâmetro faltando.

O que o bot pode ler e o que ele pode alterar?

A API pública da Flowsery tem 26 operações, e 21 delas apenas leem. Cinco podem alterar dados, e o skill usa três delas. Essa proporção é o motivo de este template ser confortável de automatizar.

PATCH /issues/{issueId} é o que exige vigilância. Marcar um problema como resolved o tira da lista padrão, e a lista padrão é o que todo mundo olha. Um agente que resolve problemas por conta própria encolhe seu backlog de bugs em silêncio, sem consertar nada.

Como eu instalo e testo?

Instalar o template de Grok Bot da Flowsery tem quatro passos: abra o link de compartilhamento no Grok Bot, crie um token de workspace flow_ws_, cole-o no campo de credenciais e peça a lista dos seus sites como teste somente de leitura.

O que a rotina semanal deveria dizer de fato?

Uma boa rotina nomeia a comparação, a ordenação e o que fazer numa semana parada. O template vem com esta:

Name:      Site health report
Schedule:  weekly, Monday 09:00, owner's timezone
What:      Pull last week's /overview against the week before, the top pages and
           referrers, and all open issues sorted by severity. If a new critical
           or high issue appeared since the last run, lead the report with it,
           including sessions affected and steps to replicate. One message,
           numbers first, no fluff.
If empty:  send the report anyway. Traffic of zero is itself a finding.

Essa última linha é o oposto do que eu recomendaria para uma rotina de alerta de leads, e de propósito. Uma semana parada numa caixa de menções é normal. Uma semana parada no tráfego do site significa ou que nada aconteceu ou que o script de rastreamento quebrou, e você quer saber qual das duas.

O caminho habitual da xAI para criar uma rotina é a demonstração: "peça a um Bot para acompanhar enquanto você executa um fluxo de trabalho uma vez. Ele salva como rotina e roda sozinho na próxima". Para um relatório movido a API, escrever é melhor. Você consegue especificar "ordenados por severidade" em vez de torcer para o Bot ter deduzido isso vendo você rolar a tela.

O que o template não leva junto?

Um template leva o perfil, o texto da skill e as rotinas, e mais nada. Ele não leva o token de workspace de quem criou, nem os sites, nem as gravações de sessão, nem a lista de problemas, nem qualquer conversa que o Bot dessa pessoa tenha tido. Sua cópia começa vazia e lê apenas os sites que o seu próprio token enxerga.

A xAI coloca uma linha em toda página de compartilhamento: um bot de terceiros "pode agir em seu nome". É verdade. Uma skill é um conjunto de instruções, instruções podem citar qualquer endpoint, e a única defesa é você poder lê-las.

Perguntas frequentes

Quais dados o Grok Bot consegue ver?

O bot vê o que o token permitir, o que no caso de um token de workspace são todos os sites daquele workspace. A Flowsery funciona sem cookies e não guarda dados pessoais, então o bot lê tráfego agregado, receita, objetivos concluídos e os problemas encontrados nas gravações de sessão.

O bot pode fechar bugs sozinho?

Não com a skill que vem pronta. PATCH /issues/{issueId} é a única chamada que muda o status de um problema, e a skill exige a confirmação do dono antes de qualquer PATCH ou POST. As leituras rodam sem confirmação.

Por que o bot recebe um 404 em um site que ele consegue ver?

Um token de workspace abrange vários sites, então cada chamada precisa de websiteId ou domain para dizer qual. Um seletor ausente devolve 404, e não 403, o que parece erro de permissão. A skill manda o bot chamar GET /websites e perguntar em vez de adivinhar.

O Grok Bot substitui o painel da Flowsery?

Não. O bot responde perguntas e escreve relatórios; ele não desenha funis, não reproduz sessões e não mostra mapas de calor. Ele é mais rápido para "qual página perdeu tráfego na semana passada" e inútil para assistir à gravação de alguém socando de raiva um botão quebrado.

Qual a diferença entre isso e conectar a Flowsery por MCP?

Os endpoints e as permissões são idênticos. MCP serve a clientes que falam esse protocolo, como Claude, Cursor e Codex. O template de Grok Bot existe porque o Grok Bot lê skills escritas em texto corrido, e não definições de ferramentas MCP.

Preciso de um plano pago do Grok para isso?

Sim. O Grok Bot exige uma assinatura elegível, e o template é gratuito por cima dela. O preço de entrada em x.ai/bot é de $30 por mês no SuperGrok e $20 por mês no Cursor. A xAI observa que o Grok Bot "vem com consumo próprio, separado dos seus planos do Grok e do Cursor".

Instale o template de Grok Bot da Flowsery e faça suas perguntas de analytics em um chat, ou leia antes a documentação da API.

Fontes: x.ai/bot, Introducing Grok Bot (11 de agosto de 2026), @bot no X (28 de agosto de 2026) e a especificação OpenAPI da Flowsery. Verificado em 30 de agosto de 2026.