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

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 5

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 6

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 7

Mude para onde um código impresso leva

Accepted Answer

Abra o código dinâmico no seu workspace, 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 8

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 9

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 10

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 11

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 12

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 13

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 14

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 15

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 16

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 17

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 18

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 19

Rode sua primeira campanha de feedback

Accepted Answer

Uma campanha guarda o objetivo e o formulário, um ponto é um material impresso com o próprio QR, e publicar coloca os três no ar em uma única operação. A configuração passa por sete etapas e não publica até que um telefone real tenha escaneado o código dentro de uma janela de teste.

Question 20

O que acontece quando alguém dá nota baixa

Accepted Answer

Toda resposta cai na caixa de entrada, qualquer que seja a nota. Uma nota igual ao seu limite ou abaixo dele também manda e-mail na hora para donos e admins e pode disparar um webhook — mas nenhum dos dois leva contatos nem o que o cliente escreveu.

Question 21

Publicar resposta na página de avaliações

Accepted Answer

Cada local pode ter uma página pública de avaliações. Nada chega lá sem duas coisas: a pessoa marcou o consentimento de publicação no formulário e você aprovou aquela resposta na caixa de entrada depois.

Question 22

Papéis e o que cada um permite

Accepted Answer

Os workspaces 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 workspace.

Question 23

Convide alguém para um workspace

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 24

Trabalhar em mais de um workspace

Accepted Answer

Um workspace é a fronteira de códigos, templates, assets, membros e chaves de API. Workspaces separados mantêm separado o que é separado; nada atravessa, inclusive as chaves.

Question 25

Templates pessoais e compartilhados

Accepted Answer

Um template 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 template do workspace é compartilhado com o time; um pessoal não é.

Question 26

Brand kit

Accepted Answer

O brand kit guarda as cores e os logos que o workspace pode usar, para que um código feito por quem nunca viu o manual da marca saia mesmo assim dentro da marca.

Question 27

Gerenciar logos, imagens e adesivos

Accepted Answer

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

Question 28

Prepare um CSV para geração em lote

Accepted Answer

Exporte em UTF-8, uma linha por código, deixe a linha de cabeçalho exatamente como se espera, e valide um punhado de linhas antes de subir milhares. A maioria das falhas em lote é de codificação ou coluna, não da Mosaqo.

Question 29

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 30

Reexecute um job em lote sem duplicar tudo

Accepted Answer

Rodar o arquivo inteiro de novo depois de uma falha parcial é como um workspace 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 31

Crie uma chave de API e escolha os scopes

Accepted Answer

Crie a chave no workspace 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 32

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 33

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 34

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 35

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 36

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 37

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 38

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 39

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 workspace fica no armazenamento local do navegador, ou seja, está preso àquele perfil e some junto com ele.

Question 40

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 41

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 42

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

Workspace e equipe

Templates, brand kit e assets

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?