​

Onboarding do beta-tester

Siga este guia para criar uma conta, confirmar seu e-mail, gerar uma API key e executar sua primeira extração no Playground. O fluxo completo leva poucos minutos e não exige que você configure código ou use a API diretamente.

​

Objetivo

Ao final deste guia, você deverá conseguir:

• acessar uma conta Messora confirmada;
• criar e guardar uma API key com segurança;
• escolher uma URL pública para teste;
• executar uma extração no Playground;
• validar o resultado, o diagnóstico e o consumo de créditos.

​

Pré-requisitos

• Um endereço de e-mail ao qual você tenha acesso imediato;
• uma senha de 12 a 128 caracteres;
• uma URL pública para teste, como https://messora.dev;
• um navegador atualizado.

Não compartilhe sua senha, sua API key ou códigos de verificação com a equipe de suporte ou com outros beta-testers.

​

Fluxo resumido

1. Crie sua conta em /auth/signup.
2. Confirme o e-mail com o código de 6 dígitos.
3. Acesse o dashboard em /app.
4. Crie uma API key em API Keys.
5. Abra Playground e selecione Extract.
6. Informe uma URL pública e aguarde a estimativa.
7. Clique em Extrair dados e valide o resultado.

---

​

1. Criar sua conta

​

Como acessar

Abra www.messora.dev/auth/signup.

​

Campos

​

Passo a passo

1. Informe seu e-mail.
2. Crie uma senha com pelo menos 12 caracteres.
3. Repita a senha em Confirmar senha.
4. Leia e aceite os Termos de Uso, a Política de Privacidade e o Uso Aceitável.
5. Clique em Criar conta.
6. Aguarde o redirecionamento para a confirmação de e-mail.

O botão Criar conta permanece desabilitado enquanto os campos obrigatórios ou o aceite legal não estiverem completos.

​

Estados e erros comuns

• Email já cadastrado: use o login ou a recuperação de senha em vez de criar outra conta.
• Senha muito curta: informe pelo menos 12 caracteres.
• Senha muito longa: o limite é 128 caracteres.
• As senhas não coincidem: repita exatamente a mesma senha.
• Senha comprometida: escolha outra senha se o sistema informar que ela apareceu em vazamentos públicos.
• E-mail inválido: confira o formato do endereço.
• Erro de rede ou servidor: verifique sua conexão e tente novamente mais tarde.

​

Opção de login social

Também é possível continuar com Google ou GitHub depois de aceitar os documentos legais. O provedor valida o e-mail, mas a API key continua sendo criada manualmente em API Keys.

---

​

2. Confirmar o e-mail

Depois do cadastro, o Messora cria a sessão e abre /auth/verify-email.

​

Como funciona

1. Abra a caixa de entrada do e-mail informado no cadastro.
2. Localize a mensagem do Messora.
3. Copie o código de 6 dígitos.
4. Informe o código no campo Código de verificação.
5. Clique em Confirmar e-mail.
6. Aguarde a mensagem de sucesso e o redirecionamento para /app.

O código expira em 15 minutos. Cada código aceita até cinco tentativas; depois disso, solicite um novo código.

​

Reenviar o código

Se o e-mail não chegar:

1. Confira spam, promoções e filtros da sua caixa de entrada.
2. Clique em Reenviar código.
3. Aguarde o contador de 60 segundos antes de solicitar outro reenvio.

O primeiro reenvio não é bloqueado pelo cooldown. Reenvios seguintes respeitam o intervalo de 60 segundos.

​

Por que esta etapa é obrigatória?

Enquanto o e-mail não estiver confirmado, o Messora bloqueia operações de consumo, incluindo:

• criação ou rotação de API keys;
• execução do Playground;
• chamadas autenticadas com X-API-Key.

Billing, configurações e troca de senha podem continuar acessíveis, mas não liberam o uso da API.

​

Estados e erros comuns

• Código incorreto: confira os seis dígitos e tente novamente.
• Código expirado ou inválido: solicite um novo código.
• Muitas tentativas incorretas: use Reenviar código.
• Aguarde antes de reenviar: o cooldown de 60 segundos ainda está ativo.
• Sessão expirada: volte ao login e entre novamente.

---

​

3. Primeiro acesso ao dashboard

Após a confirmação, você chegará ao dashboard em /app.

​

O que conferir

• Primeiros passos: mostra o progresso do onboarding da conta;
• API Keys: abre o gerenciamento de chaves;
• Uso & Analytics: mostra consumo e histórico;
• Faturamento: mostra plano e opções de créditos;
• Playground: abre as ferramentas de extração;
• Uso: mostra o percentual consumido;
• Assinatura: mostra o plano atual e os créditos disponíveis.

Quando a conta ainda não concluiu o onboarding, use o botão Abrir Playground do card Primeiros passos ou a opção Playground da navegação lateral.

---

​

4. Criar uma API key

​

Como acessar

No dashboard, clique em API Keys ou abra diretamente www.messora.dev/app/keys. Clique em Nova API Key.

​

Passo a passo

1. Clique em Nova API Key.
2. Informe um rótulo que identifique o uso, como beta-playground ou teste-local.
3. Clique em Criar key.
4. Copie a chave imediatamente.
5. Guarde-a em um gerenciador de senhas ou secret manager.
6. Feche o modal somente depois de confirmar que a chave foi armazenada.

​

Regra importante: a chave é exibida uma única vez

O valor completo da API key aparece somente no momento da criação. Depois disso, a interface exibe apenas o prefixo. Se você fechar o modal sem copiar a chave, crie outra. Não tente recuperar o valor completo a partir da tabela.

​

O que aparece na tabela

Uma conta pode ter até 10 API keys ativas. Para criar outra quando o limite for atingido, revogue uma key que não é mais necessária.

​

Boas práticas

• Crie uma key por ambiente ou finalidade.
• Use rótulos que expliquem o contexto de uso.
• Nunca coloque a chave em screenshots, tickets, commits ou mensagens.
• Nunca envie a chave para o navegador ou para o client-side de uma aplicação.
• Revogue chaves expostas ou que não serão mais utilizadas.
• Ao rotacionar, atualize o segredo no sistema consumidor antes de remover o acesso antigo.

---

​

5. Abrir o Playground

Abra www.messora.dev/app/playground pelo menu lateral. O Playground começa na ferramenta Extract, recomendada para a primeira execução.

​

Ferramentas disponíveis

Para este onboarding, permaneça em Extract.

---

​

6. Executar a primeira extração

​

Configuração mínima

1. No campo URL para extrair, informe uma URL pública, por exemplo https://messora.dev.
2. Aguarde o cálculo da estimativa.
3. Confirme se o saldo cobre a execução.
4. Mantenha Markdown selecionado em Saída.
5. Clique em Extrair dados.
6. Aguarde o resultado.

O Extract padrão informa 1 crédito por página. A estimativa exibida pelo próprio Playground é a referência para a configuração atual, especialmente quando você ativa saída estruturada ou opções avançadas.

​

Parâmetros

Clique em Parâmetros para abrir o drawer lateral. Os controles disponíveis incluem:

• Chave de API: atribui a execução a uma key no relatório de uso;
• Orientação de extração: adiciona instruções sobre como interpretar a página;
• Verificação de fatos: restringe a extração a valores explicitamente suportados pela página;
• Seguir subdomínios: permite seguir links em subdomínios no extract multi-page;
• Incluir frames: inclui referências de iframes no Markdown, sem buscar o conteúdo externo;
• Máximo de páginas: define o limite de páginas analisadas, de 1 a 10 no Playground;
• Profundidade máxima: limita a profundidade do extract multi-page;
• Analisar PDF: processa PDFs encontrados;
• Cache maxAge: define o TTL do cache de scrape;
• Tags: adiciona rótulos para filtrar o uso no dashboard;
• Saída: Markdown, JSON ou Raw;
• Renderizar JavaScript: renderiza páginas que dependem de JavaScript;
• Somente conteúdo principal: remove conteúdo periférico quando suportado;
• Tempo limite: define o timeout da execução;
• Espera após carregar: aguarda milissegundos adicionais após o carregamento.

Para o primeiro teste, mantenha os padrões e altere apenas a URL. Isso facilita identificar se um problema vem do domínio ou de uma configuração avançada.

​

Resultado esperado

Uma execução bem-sucedida apresenta:

• resultado em Markdown, JSON ou Raw;
• tempo de resposta;
• botão Copiar;
• botão Baixar resultado;
• créditos usados;
• link Ver no Uso;
• diagnóstico da execução;
• status HTTP;
• engine utilizada;
• número de páginas solicitadas e analisadas;
• créditos estimados e usados;
• latência;
• tentativas;
• URL final.

No diagnóstico, o estado esperado é Sucesso e o status HTTP normalmente é 200 para uma página disponível.

​

O que registrar no teste beta

Depois da primeira execução, anote:

• URL testada;
• ferramenta utilizada;
• saída escolhida;
• tempo de resposta;
• status do diagnóstico;
• status HTTP;
• créditos usados;
• URL final, se diferente da URL informada;
• mensagem de erro, se houver.

Não inclua sua API key no relato.

---

​

Estados possíveis no Playground

Falhas de extração não devem ser tratadas como sucesso. Registre a mensagem exibida e o domínio testado para a triagem do beta.

​

Boas práticas para o beta

• Comece com uma página pública simples antes de testar sites complexos.
• Faça uma execução por vez e aguarde o diagnóstico final.
• Use Markdown no primeiro teste; experimente JSON depois que o fluxo básico funcionar.
• Ative Renderizar JavaScript somente quando a página depender de conteúdo carregado no navegador.
• Não use URLs privadas, páginas que exigem login ou dados pessoais de terceiros.
• Não tente contornar CAPTCHA, WAF, robots.txt ou limites do site.
• Não compartilhe resultados que contenham dados pessoais sem revisar o conteúdo.
• Verifique Uso & Analytics depois de uma execução bem-sucedida.
• Relate o domínio, a mensagem e o horário aproximado; nunca envie a API key.

​

FAQ

​

Preciso criar uma API key antes de confirmar o e-mail?

Não. Primeiro confirme o e-mail. A criação e a rotação de keys ficam bloqueadas enquanto a conta não estiver verificada.

​

O Playground pede que eu digite a API key?

Não para a execução pela sessão autenticada. O Playground pode atribuir o uso a uma key pelo drawer Parâmetros. Os snippets de código usam YOUR_API_KEY como placeholder para integrações externas.

​

Onde guardo a API key?

Em um gerenciador de senhas ou secret manager. Para uma integração, use uma variável de ambiente no servidor. Nunca a coloque em código versionado ou no client-side.

​

O que faço se fechar o modal sem copiar a chave?

Crie uma nova API key. O valor completo só é exibido na criação.

​

O que faço se o código de e-mail não chegar?

Verifique spam e filtros, aguarde alguns segundos e use Reenviar código. Respeite o cooldown de 60 segundos entre reenvios.

​

Quanto custa a primeira extração?

O Extract padrão informa 1 crédito por página. O custo final depende da configuração; confirme sempre a estimativa apresentada antes de executar.

​

Posso testar qualquer site?

Não. Durante o beta, use somente URLs públicas permitidas e respeite as restrições do domínio. linkedin.com e instagram.com (incluindo subdomínios) são recusados antes do fetch com 403 / domain_not_supported_in_beta e não consomem créditos. A denylist pode crescer — veja Autenticação.

​

Como pedir ajuda?

Envie para customer@messora.dev a rota, o domínio testado, o horário aproximado, a ferramenta, o status HTTP e a mensagem exibida. Remova senhas, códigos, API keys e dados pessoais do relato.

​

Critério de conclusão do onboarding

O onboarding está concluído quando o beta-tester consegue:

• entrar em /app;
• confirmar que o e-mail está verificado;
• visualizar uma API key ativa sem expor o valor completo;
• abrir /app/playground;
• obter uma estimativa antes da execução;
• executar uma URL pública;
• visualizar um resultado com status Sucesso;
• identificar créditos usados e diagnóstico.

​

Relacionado

• Introdução
• Quickstart
• Autenticação
• API reference: Scrape
• Guia do Playground: Scrape
• Uso & Analytics
• Faturamento
• API Keys
• Playground