Question 1

Crie e publique seu primeiro QR code

Accepted Answer

Escolha o tipo de conteúdo, use o modo dinâmico a menos que haja motivo para não usar, dê estilo ao código, publique e então leia a exportação real com um celular real antes que ela vá a qualquer lugar.

Question 2

Estático ou dinâmico: qual escolher

Accepted Answer

Um código estático guarda o conteúdo na própria matriz, então funciona para sempre e nunca pode ser alterado nem medido. Um código dinâmico guarda um endereço gerenciado da Mosaqo, então o destino continua editável e cada leitura é contada.

Question 3

Teste um QR code antes de assumir o compromisso

Accepted Answer

Teste o arquivo exportado, não a prévia, em pelo menos dois modelos de celular, na luz em que o código vai realmente viver, e siga o destino até o fim da cadeia de redirecionamentos.

Question 4

O que o plano gratuito inclui, e o que conta

Accepted Answer

Um espaço no plano gratuito tem lugar para 10 QR codes, 1 local e 3 pesquisas. Espaços criados antes de 2 de setembro de 2026 mantêm 25 códigos e não têm limite de locais nem de pesquisas. Todo código conta — rascunhos e arquivados também — e só excluir um definitivamente libera a vaga dele.

Question 5

O assistente integrado

Accepted Answer

O assistente é a pílula na parte de baixo de todas as telas do espaço. Ele lê este espaço — seus códigos, locais, pesquisas, leituras e respostas — e esta central de ajuda, e pode se oferecer para fazer coisas por você. Nada acontece até você apertar o botão no cartão dele.

Question 6

Códigos de URL e app links

Accepted Answer

Um código de URL carrega um endereço web. Um app link carrega uma URL que o sistema móvel reconhece como pertencente a um app instalado, e que cai no navegador quando o app não está lá.

Question 7

QR codes de Wi-Fi

Accepted Answer

Um código de Wi-Fi carrega o nome da rede, o tipo de segurança e a senha, e o celular oferece a conexão ao ler. Como os dados ficam dentro da matriz, quem fotografar o código tem a senha.

Question 8

Códigos de PDF, vCard e texto

Accepted Answer

Um código de PDF aponta para um documento hospedado, um vCard carrega dados de contato que o celular salva direto, e um código de texto mostra uma mensagem curta sem nada para abrir. Só o PDF precisa de rede.

Question 9

Onde guardar o PDF que um código abre

Accepted Answer

Um código de PDF aponta para um link público https:// de um arquivo hospedado por você. A Mosaqo não envia nem armazena o PDF, então o arquivo precisa estar em algum lugar que qualquer pessoa consiga abrir sem fazer login.

Question 10

Mude para onde um código impresso leva

Accepted Answer

Abra o código dinâmico no seu espaço, mude o destino e publique a alteração. A matriz impressa fica intocada — ela aponta para um endereço gerenciado da Mosaqo, e só o que esse endereço serve mudou.

Question 11

Como funciona um redirecionamento da Mosaqo

Accepted Answer

A matriz codifica um endereço curto da Mosaqo. A leitura abre esse endereço, a Mosaqo registra a leitura e responde com um redirecionamento ao destino atual, que o celular segue. Tudo o que você pode mudar fica do lado da Mosaqo.

Question 12

Publicar, arquivar e restaurar um código

Accepted Answer

Publicar faz um código dinâmico servir o destino. Arquivar interrompe isso sem invalidar nada do que já foi impresso. Restaurar e publicar de novo traz a mesma matriz impressa de volta à vida.

Question 13

Mande pessoas diferentes para lugares diferentes

Accepted Answer

Um código dinâmico pode mandar algumas leituras para outro lugar: por país, idioma, sistema operacional, tipo de dispositivo, parâmetro de URL, janela de datas ou divisão ponderada. As regras rodam de cima para baixo e a primeira que corresponder vence; todo o resto vai para o destino do código.

Question 14

Use seu próprio domínio nos links curtos

Accepted Answer

Proprietários e administradores podem colocar um código dinâmico no próprio domínio. Você adiciona o domínio, prova que é dono dele com um registro DNS, espera o certificado e o escolhe para um código antes de esse código ser publicado.

Question 15

Coloque um logo sem quebrar o código

Accepted Answer

Um QR code carrega correção de erro, e um logo gasta essa correção. Mantenha o logo centralizado, mantenha pequeno em relação à matriz e teste de novo a cada mudança — o ponto em que ele para de ler chega de repente.

Question 16

Contraste e zona de silêncio

Accepted Answer

Os módulos precisam ser escuros sobre fundo claro, com contraste de verdade, e o código precisa de margem vazia nos quatro lados. Códigos invertidos e margens invadidas são as duas causas mais comuns de um código que não lê.

Question 17

Molduras, chamadas para ação e adesivos

Accepted Answer

Um código pelado na parede recebe menos leituras do que o mesmo código com três palavras embaixo. Molduras e adesivos dão essa instrução — desde que fiquem fora da zona de silêncio.

Question 18

Crie um cartão em volta do código

Accepted Answer

O editor monta um cartão em volta do seu código — fundo, texto, stickers e uma foto — como pôster 4:5, post 1:1 ou adesivo recortado. O código sempre mantém a zona de silêncio, e um design que não seria lido é barrado antes da exportação ou da publicação.

Question 19

PNG, SVG ou PDF: qual exportação usar

Accepted Answer

Use SVG ou PDF para tudo que vai para impressão — é vetor, e continua nítido em qualquer tamanho. Use PNG para telas. Um PNG ampliado para um cartaz é a causa mais comum de código borrado e ilegível.

Question 20

Que tamanho o código precisa ter

Accepted Answer

Quanto mais longe o leitor estiver, maior o código precisa ser. Uma regra prática é um décimo da distância de leitura: lido a um metro, ele quer uns dez centímetros; num outdoor, muito mais do que um designer imagina.

Question 21

Brilho, curvas, tecido e foil

Accepted Answer

Tudo que reflete, dobra ou estica custa tentativas de leitura. O brilho gera reflexo, embalagem curva distorce a grade, e tecido e foil deslocam os módulos. A correção é mais tamanho, mais contraste e um teste físico — nunca um logo maior.

Question 22

Leituras totais e leituras únicas

Accepted Answer

O total conta cada evento de leitura. O único conta um aparelho uma vez dentro da janela de agregação. Uma pessoa que lê três vezes soma três ao primeiro número e um ao segundo, e por isso os dois nunca batem.

Question 23

Por que um código estático não tem analytics

Accepted Answer

Um código estático guarda o conteúdo na matriz e nunca fala com a Mosaqo, então nenhuma leitura é observada. Analytics exige um código dinâmico, porque só um redirecionamento gerenciado enxerga a leitura acontecer.

Question 24

Exportação CSV e parâmetros de campanha

Accepted Answer

Exporte a série em CSV, ou leia pela API, quando precisar das linhas cruas em vez do painel. Parâmetros de campanha no destino deixam a sua própria analytics atribuir a visita também.

Question 25

Configure um local e receba as primeiras avaliações

Accepted Answer

Um local é um ponto físico do seu negócio. A configuração tem quatro etapas — o nome, onde ficam as avaliações, o que você pergunta e uma última etapa com o endereço da página e um código para imprimir. Nos modos que fazem perguntas, a página só aceita respostas depois que você mesmo abriu o formulário e apertou Publicar.

Question 26

O que acontece quando alguém dá nota baixa

Accepted Answer

Toda resposta cai em **Avaliações → Caixa de entrada**, qualquer que seja a nota. Uma nota igual ao seu limite ou abaixo dele também manda e-mail aos proprietários e administradores e pode disparar um webhook. Nenhum dos dois leva contatos nem o que o cliente escreveu.

Question 27

Sua página pública de avaliações e o consentimento

Accepted Answer

Cada local tem uma página pública de avaliações, ligada quando o local é criado. Uma avaliação vai para ela no momento em que o autor marca o consentimento no formulário; uma resposta sem essa marcação nunca pode ser publicada. Depois, você pode ocultar uma avaliação informando o motivo, e a página diz quantas estão ocultas.

Question 28

Faça uma pesquisa

Accepted Answer

Uma pesquisa é um conjunto de perguntas com endereço próprio. Ela não tem página pública e não manda ninguém ao Google: as respostas chegam à sua caixa de entrada e à tela da própria pesquisa. Como um local, ela só aceita respostas depois que você a abriu uma vez e apertou Publicar.

Question 29

Mude as perguntas sem perder respostas

Accepted Answer

As perguntas ficam num formulário em **Avaliações → Formulários**. Editar não muda nada do que o cliente vê até você publicar: publicar grava a próxima versão, e as respostas já dadas mantêm as perguntas a que responderam.

Question 30

Personalize sua página de avaliações

Accepted Answer

A página de cada local, e cada pesquisa, pode levar a sua marca: logo, foto de capa, cores, seus contatos e horário de funcionamento, e suas próprias palavras no título e no botão.

Question 31

Mostre avaliações no seu próprio site

Accepted Answer

O widget mostra no seu site as avaliações publicadas de um local. Escolha um layout, cole uma linha de código na sua página e ele se mantém atualizado sozinho.

Question 32

Papéis e o que cada um permite

Accepted Answer

Os espaços da Mosaqo têm cinco papéis — owner, admin, editor, analyst e viewer — do controle total ao somente leitura. Dê o papel mais estreito que permita trabalhar, e reserve owner para quem responde pelo espaço.

Question 33

Convide alguém para um espaço

Accepted Answer

Convide pelo endereço de e-mail e escolha o papel no mesmo momento. O convite pertence a esse endereço, então precisa ser aceito pela conta que o possui.

Question 34

Trabalhar em mais de um espaço

Accepted Answer

Toda conta começa com um espaço próprio. Você também pode ser integrante dos espaços de outras pessoas quando elas o convidam, e alternar entre eles pela barra lateral. Criar mais espaços próprios é algo que está chegando.

Question 35

Compartilhe um código para revisão e aprove

Accepted Answer

Você pode mostrar um código a alguém de fora do espaço com um link de compartilhamento, recolher comentários no próprio código e — se o espaço exigir — fazer um proprietário ou administrador aprovar o código antes que ele possa ser publicado.

Question 36

Pastas e tags

Accepted Answer

Um código fica em uma pasta e pode ter várias tags. Pastas servem para lugares e objetos — uma loja, uma linha de produtos; tags servem para o que atravessa esses grupos, normalmente campanhas.

Question 37

Login, dispositivos e exclusão da conta

Accepted Answer

Você entra com Google ou Apple; a Mosaqo não guarda senha. Seus dispositivos, seu método de login e a exclusão da conta ficam todos em **Preferências**.

Question 38

Modelos pessoais e compartilhados

Accepted Answer

Um modelo guarda um visual pronto — cores, logo, moldura, estilo dos módulos — para o próximo código começar aprovado em vez de começar em branco. Um modelo do espaço é compartilhado com o time; um pessoal não é.

Question 39

Recursos da marca: logos e imagens para os seus cartões

Accepted Answer

**Recursos** guarda os logos e as fotos que os seus cartões usam. Envie uma vez; depois de uma rápida verificação de segurança, eles podem ir para qualquer cartão, como foto ou como o logo no meio do código.

Question 40

Gerenciar logos, imagens e adesivos

Accepted Answer

Recursos são os logos, imagens e adesivos que um espaço reutiliza. Guardá-los na biblioteca compartilhada em vez de em notebooks individuais é o que torna os modelos reproduzíveis.

Question 41

Prepare um CSV para importação em lote

Accepted Answer

Uma linha por código, uma linha de cabeçalho com o nome das colunas, salvo em UTF-8. As colunas são reconhecidas pelo nome, então a ordem delas não importa. Todo código importado chega como rascunho, e um único clique no job publica todos.

Question 42

Ler erros de prévia e validação

Accepted Answer

A validação informa a linha e o que está errado nela. Corrija a planilha de origem em vez do arquivo exportado, para a correção sobreviver à próxima exportação.

Question 43

Reexecute um job em lote sem duplicar tudo

Accepted Answer

Rodar o arquivo inteiro de novo depois de uma falha parcial é como um espaço acaba com milhares de duplicatas. Reenvie só as linhas que falharam, e use uma chave de idempotência pela API para uma nova tentativa não criar tudo em dobro.

Question 44

Crie uma chave de API e escolha os scopes

Accepted Answer

Crie a chave no espaço em que ela vai agir, conceda só os scopes de que a integração precisa e guarde como segredo. Uma chave é mostrada uma vez — se sumir, revogue e emita outra em vez de caçar a original.

Question 45

Conectar um assistente de IA (MCP)

Accepted Answer

Crie uma chave de API só com os escopos de que o assistente precisa e dê ao cliente o endereço https://api.mosaqo.app/v1/mcp com essa chave como token bearer. O assistente faz exatamente o que a chave permite e nada além disso, e você pode desconectá-lo quando quiser em Lotes e API.

Question 46

Diagnosticar 401, 403, 422 e 429

Accepted Answer

401 quer dizer que a chave não foi aceita de jeito nenhum. 403 quer dizer que foi aceita mas a operação não é permitida. 422 quer dizer que a requisição foi entendida e o payload estava errado. 429 quer dizer que você passou do limite e deve recuar em vez de repetir na hora.

Question 47

Paginar resultados e ficar dentro dos limites

Accepted Answer

Endpoints de listagem paginam por cursor e não por offset, então siga o cursor que a resposta devolve em vez de calcular um. Fique de olho nos headers de limite e use `updatedSince` para consultar em vez de reler tudo.

Question 48

Confira uma assinatura de webhook

Accepted Answer

Calcule a assinatura sobre o corpo bruto da requisição, antes de qualquer parse de JSON, e compare em tempo constante. Reserializar o payload muda os bytes, e a assinatura nunca mais vai bater.

Question 49

Conectar Make, Zapier e n8n

Accepted Answer

A Mosaqo se integra a plataformas de automação pela API HTTP e por webhooks, não por um conector publicado em marketplace. Todas essas ferramentas têm um módulo HTTP genérico, e é ele que se usa.

Question 50

Links de imagem assinados para Airtable, Notion e Sheets

Accepted Answer

Para exibir a imagem de um código numa ferramenta que só aceita URL, dê a ela um link que possa ser buscado em vez de subir um arquivo à mão. Trate esse link como compartilhável: quem o tem vê a imagem.

Question 51

Web, mobile e extensão: o que usar e quando

Accepted Answer

Crie no app web, onde ficam o editor e as ferramentas em lote. Use os apps móveis para testar leitura e compartilhar em campo. Use a extensão do Chrome para um código rápido a partir da página em que você está. Os três compartilham uma conta.

Question 52

Permissões de câmera e testes de leitura

Accepted Answer

Ler exige permissão de câmera do sistema operacional. Se a visualização fica preta ou nunca abre, a permissão foi negada em algum momento e precisa ser concedida nas configurações do sistema, não no app.

Question 53

O que a extensão do Chrome guarda

Accepted Answer

A extensão gera códigos a partir da página em que você está. O trabalho que não foi salvo em um espaço fica no armazenamento local do navegador, ou seja, está preso àquele perfil e some junto com ele.

Question 54

Confira se o problema é só seu

Accepted Answer

Um código que parou para todo mundo ao mesmo tempo e um código que falha em um celular pedem mensagens diferentes. Cinco minutos de conferência decidem qual você está escrevendo, e isso decide quão rápido ela é tratada.

Question 55

O que incluir numa solicitação de suporte

Accepted Answer

Plataforma e versão, os passos que seguiu, o resultado esperado, o resultado obtido e o identificador do que deu errado. Uma mensagem completa é respondida mais rápido do que cinco curtas, porque cada ida e volta custa um dia útil.

Question 56

Como as solicitações são priorizadas, e o que nunca enviar

Accepted Answer

A prioridade segue impacto e urgência, não a escolha de palavras. E nenhuma solicitação deve jamais carregar senha, token de acesso, segredo de API, header `Authorization` ou conteúdo privado de QR — nem na mensagem, nem em captura de tela, nem em log anexado.

Como podemos ajudar?

Navegar por área

Primeiros passos

Tipos de QR code

Códigos dinâmicos e redirecionamentos

Design e legibilidade

Impressão e exportação

Analytics de leituras

Feedback e avaliações

Espaço e equipe

Modelos e recursos da marca

Geração em lote e CSV

API pública

Webhooks e integrações

Apps móveis e extensão do Chrome

Falar com o suporte

Ainda travado?