Um assistente de IA para seus códigos QR e o feedback dos clientes

01

O que você pode perguntar

As perguntas que as pessoas realmente têm sobre seus códigos QR são comparações e listas: quais códigos foram mais escaneados neste mês, quais ninguém escaneou desde a impressão, como esta semana se compara com a anterior, qual posicionamento de uma campanha está fazendo o trabalho. Um assistente responde isso numa frase, em vez de um painel que você precisa ler, e dá o nome dos códigos para você conferir.

Com feedback é igual: a tendência de uma pesquisa, qual pergunta tem a nota mais baixa, quantas pessoas responderam desde que o cardápio mudou. Via MCP, um assistente recebe os números — contagens, escolhas, a distribuição por pergunta, quantas pessoas escreveram um comentário — e nunca o texto de um comentário. O assistente integrado pode ler os comentários escritos mais recentes, para as mesmas pessoas a quem a caixa de entrada de respostas os mostra, e assim dizer numa frase do que eles tratam.

• Os códigos mais escaneados e os silenciosos, pelo nome
• Este período contra o anterior, para um código ou para o espaço de trabalho inteiro
• Notas de pesquisas e a distribuição por trás de uma média
• Detalhes de leitura limitados pelas próprias configurações de privacidade do espaço de trabalho

02

O que ele pode mudar, e quem diz sim

No espaço de trabalho, o assistente nunca age sozinho. Ele propõe: um código novo, um modelo de cartão escrito a partir da sua descrição, as perguntas de uma pesquisa, um novo destino para um código dinâmico, publicar ou arquivar. Cada proposta chega como um cartão que diz o que vai acontecer, e nada muda até alguém apertá-lo — com a função dessa própria pessoa, então um leitor pode ler uma proposta, mas não executá-la.

Via MCP, o assistente chama as ferramentas que a chave ou o login dele permitem. Toda ferramenta que grava é marcada como tal, e arquivar é marcado como destrutivo, então um cliente que respeita essas marcações pergunta a você antes de executá-las. Não existe ferramenta que apague um código: arquivar é o máximo a que ele chega, e um código arquivado pode ser restaurado.

• Integrado: criar códigos de URL, Wi-Fi, texto, vCard e link de app; rascunhar modelos de cartão e pesquisas
• Integrado e via MCP: apontar um código dinâmico para outro lugar, publicar, arquivar
• Via MCP: criar códigos de URL como rascunhos e iniciar uma importação CSV que é só uma simulação, a menos que você diga o contrário
• Em nenhum dos dois: apagar um código, convidar pessoas ou mudar quem tem acesso

03

Duas formas de conectar um assistente externo

O servidor MCP tem um único endereço: https://api.mosaqo.app/v1/mcp. O jeito mais simples de entrar é uma chave de API. Um proprietário ou administrador cria uma em Lotes e API, marca o que ela pode fazer e a cola no cliente. Uma chave pode ter data de expiração e uma lista de IPs permitidos, e revogá-la a interrompe na hora.

O outro jeito é um login. O cliente se registra e abre uma página do Mosaqo, onde um proprietário ou administrador o aprova para um espaço de trabalho. Depois ele aparece em Assistentes conectados, e Desconectar o encerra imediatamente. Nos dois casos, uma credencial alcança um único espaço de trabalho.

• qr:read e qr:write para códigos, exports:read para as imagens deles
• analytics:read para leituras, reviews:read para locais e relatórios de pesquisa
• bulk:write e webhooks:write só quando você precisar deles
• Uma ferramenta fora do acesso que você concedeu nem chega a ser oferecida ao assistente

04

Comece com menos acesso do que acha que precisa

Uma chave somente leitura responde à maior parte do que as pessoas querem de um assistente: relatórios, comparações, a lista de códigos que precisam de atenção. Dê a ela qr:read e analytics:read, use por uma semana e adicione qr:write quando houver uma mudança que você realmente queira fazer a partir de uma conversa.

Mantenha uma chave separada para cada ferramenta e cada pessoa. Assim, uma chave que vazou, ou um experimento que você já encerrou, pode ser revogado sem mexer em mais nada.

05

Limites que vale conhecer antes de depender dele

O assistente integrado responde a até 60 perguntas por espaço de trabalho por hora e 300 por dia, e se mantém no assunto do espaço de trabalho: uma pergunta sem relação recebe uma recusa educada. Cada pessoa pode ocultá-lo dos próprios espaços de trabalho em Preferências.

Via MCP, cada chave ou login pode fazer 600 requisições por minuto, uma proteção contra um loop descontrolado, e não um limite de plano. A análise de leituras cobre apenas códigos dinâmicos, porque um código estático nunca passa pelo Mosaqo depois de impresso.