> ## Documentation Index > Fetch the complete documentation index at: https://docs.messora.dev/llms.txt > Use this file to discover all available pages before exploring further. # Onboarding do beta-tester > Do cadastro à primeira extração no Playground do Messora. # 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. Durante o beta, use apenas URLs públicas e respeite os termos de uso, robots.txt, limites de acesso e políticas dos sites consultados. ## 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](https://www.messora.dev/auth/signup). Tela de criação de conta ### Campos | Campo | Descrição | Obrigatório | Exemplo | | --------------- | ----------------------------------------------------------------------- | ----------- | -------------------- | | Email | Endereço que receberá o código de verificação. | Sim | `voce@empresa.com` | | Senha | Senha da conta. Deve ter entre 12 e 128 caracteres. | Sim | Uma senha exclusiva | | Confirmar senha | Repetição da senha para validação. | Sim | Igual ao campo Senha | | Termos legais | Confirmação dos Termos de Uso, Política de Privacidade e Uso Aceitável. | Sim | Caixa marcada | ### 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`. Tela de confirmação de e-mail ### 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`. Dashboard inicial do Messora ### 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](https://www.messora.dev/app/keys). Gerenciamento de API Keys Clique em **Nova API Key**. Modal de criação de 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 | Coluna | Significado | | ---------- | ---------------------------------------------------------- | | Chave | Prefixo da key, nunca o valor completo. | | Rótulo | Nome dado no momento da criação. | | Criada | Data de criação. | | Último uso | Último uso registrado ou indicação de que nunca foi usada. | | Status | **Ativa** ou **Revogada**. | | Ações | Rotacionar ou revogar a key, conforme o estado. | 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](https://www.messora.dev/app/playground) pelo menu lateral. O Playground começa na ferramenta **Extract**, recomendada para a primeira execução. ### Ferramentas disponíveis | Ferramenta | Uso inicial | | --------------- | ---------------------------------------------------- | | Extract | Extrair uma página e escolher Markdown, JSON ou Raw. | | Crawl de site | Percorrer várias páginas a partir de uma URL. | | Busca web | Consultar resultados de busca. | | Busca (legado) | Compatibilidade com o modo antigo de busca. | | Scrape Markdown | Obter conteúdo em Markdown. | | Scrape HTML | Obter HTML bruto. | 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. Resultado de uma extração bem-sucedida 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 | Estado | O que significa | Próxima ação | | ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ | | Pronto para executar | A URL ainda não foi executada. | Informe a URL e aguarde a estimativa. | | Calculando estimativa | O custo da configuração está sendo validado. | Aguarde e não clique repetidamente. | | Sessão expirada | A autenticação deixou de ser válida. | Faça login novamente. | | Nenhuma API key ativa | A conta não tem key utilizável. | Crie uma API key em **API Keys**. | | Saldo insuficiente | O saldo não cobre a execução. | Reduza o escopo ou recarregue créditos. | | URL indisponível no beta | O domínio está na denylist do beta (hoje: `linkedin.com`, `instagram.com`) ou foi recusado. API `detail`: `domain_not_supported_in_beta`. | Teste outro domínio público — créditos não são cobrados. | | Anti-bot detectado | O site bloqueou ou protegeu a tentativa. | Teste outra URL; a interface informa que esse caso não consome créditos. | | Tempo limite atingido | A página demorou além do timeout. | Tente outra URL ou ajuste as opções avançadas. | | Extração falhou | O motor não conseguiu concluir a extração. | Revise a URL e tente novamente. | | Limite da conta atingido | Há rate limit temporário. | Aguarde e tente novamente. | | Serviço temporariamente indisponível | O serviço não respondeu corretamente. | Aguarde alguns instantes e repita. | | Sucesso | O resultado foi produzido. | Revise o conteúdo e registre as métricas do teste. | 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](/pt-BR/authentication#domínios-recusados-no-beta). ### 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](/pt-BR/introduction) * [Quickstart](/pt-BR/quickstart) * [Autenticação](/pt-BR/authentication) * [API reference: Scrape](/pt-BR/api-reference/scrape) * [Guia do Playground: Scrape](/pt-BR/playground/scrape) * [Uso & Analytics](https://www.messora.dev/app/usage) * [Faturamento](https://www.messora.dev/app/billing) * [API Keys](https://www.messora.dev/app/keys) * [Playground](https://www.messora.dev/app/playground)