Tudo que voce precisa para lancar, compartilhar e converter com o Ledgi Cards.

1. Crie sua conta

1. Clique em <strong>Comecar gratis</strong> na pagina inicial ou visite <code>/register</code>.
2. Insira seu nome completo, email e uma senha (minimo 8 caracteres).
3. Opcionalmente adicione empresa e cargo — eles pre-preenchem seu primeiro cartao.
4. Escolha seu idioma preferido (Ingles, Portugues ou Espanhol).
5. Clique em <strong>Criar workspace</strong>. Voce acessa o painel imediatamente.

Sua conta comeca no plano <strong>Starter</strong> — um cartao, insights de IA e analiticos inclusos gratuitamente.

2. Configure seu primeiro cartao

1. No painel, clique em <strong>Gerenciar cartoes</strong> ou navegue ate <code>/app/cards</code>.
2. Preencha o <strong>Nome de exibicao</strong> (como seu nome aparece no cartao).
3. Adicione <strong>Titulo</strong>, <strong>Empresa</strong> e <strong>Subtitulo</strong> — o subtitulo aparece como legenda no cartao publico.
4. Adicione dados de contato: <strong>Email</strong>, <strong>Telefone</strong>, <strong>Website</strong> e opcionalmente uma <strong>URL de agendamento</strong> (ex: link do Calendly).
5. Escreva uma <strong>Bio</strong> curta — visitantes a veem na pagina publica do cartao.
6. Escolha um <strong>Template de wallet</strong> entre 50 opcoes tematicas agrupadas por categoria (Profissional, Criativo, Industria, Tech, Lifestyle). A pre-visualizacao ao vivo mostra exatamente como ficara no Apple Wallet.
7. Clique em <strong>Criar cartao</strong>. Seu cartao recebe uma URL publica unica como <code>/cards/seu-nome</code>.

3. Navegue pelo seu workspace

1. <strong>Painel</strong> (<code>/app</code>) — Metricas gerais, cartoes recentes e ultimos contatos.
2. <strong>Cartoes</strong> (<code>/app/cards</code>) — Crie e gerencie todos os seus cartoes.
3. <strong>Contatos</strong> (<code>/app/contacts</code>) — Veja leads capturados com enriquecimento por IA.
4. <strong>Busca</strong> (<code>/app/search</code>) — Encontre contatos por nome, empresa, evento, contexto ou insights de IA.
5. <strong>Analiticos</strong> (<code>/app/analytics</code>) — Acompanhe visualizacoes, capturas, compartilhamentos e taxas de conversao.
6. <strong>Admin</strong> (<code>/app/admin</code>) — Administradores gerenciam usuarios, funcoes e planos de assinatura.

4. A pagina publica do cartao

Quando alguem visita seu cartao publico, ve:

1. Seu nome, titulo, empresa, subtitulo e bio.
2. Links de contato clicaveis (email, telefone, website).
3. Botoes de acao: Salvar contato, Wallet pass e Agendar reuniao.
4. <strong>Barra de compartilhamento</strong> — botoes para compartilhar o cartao no LinkedIn, X (Twitter), WhatsApp, email ou via compartilhamento nativo no celular.
5. <strong>QR code</strong> — um QR code com a marca que visitantes podem escanear para abrir o cartao instantaneamente.
6. Um <strong>formulario de captura</strong> onde visitantes compartilham seus dados de volta.

5. Todas as formas de compartilhar seu cartao

Cada cartao publico oferece multiplos canais de distribuicao integrados:

1. <strong>URL publica</strong> — Envie o link diretamente: <code>seusite.com/cards/seu-slug</code>. Funciona em qualquer navegador.
2. <strong>QR code</strong> — Cada pagina de cartao exibe um QR code com a marca. Visitantes escaneiam com a camera e abrem seu cartao instantaneamente. A imagem QR tambem esta disponivel em <code>/cards/seu-slug/qr</code> para uso em slides, assinaturas de email ou materiais impressos.
3. <strong>Compartilhamento social</strong> — Botoes de um clique para LinkedIn, X (Twitter) e WhatsApp. Cada um abre a respectiva plataforma com o link do seu cartao e uma mensagem pre-preenchida.
4. <strong>Compartilhamento nativo (celular)</strong> — Em celulares e tablets, o botao "Compartilhar" abre a folha de compartilhamento do sistema, permitindo enviar o cartao por qualquer app instalado — Mensagens, Telegram, Slack, etc.
5. <strong>Compartilhamento por email</strong> — Clique no botao de email para abrir um email pre-composto com o link do cartao no corpo, pronto para enviar.
6. <strong>Copiar link</strong> — Um clique copia a URL do cartao para a area de transferencia. Uma confirmacao "Copiado!" aparece brevemente.
7. <strong>Download vCard</strong> — Visitantes podem clicar em <strong>Salvar contato</strong> para baixar um arquivo <code>.vcf</code> padrao que funciona com qualquer app de contatos.
8. <strong>Apple Wallet pass</strong> — Visitantes clicam em <strong>Wallet pass</strong> para baixar um arquivo <code>.pkpass</code>. No iOS, isto adiciona seu cartao ao Apple Wallet — sempre acessivel, mesmo offline.
9. <strong>Link de agendamento</strong> — Se voce adicionou uma URL de agendamento, visitantes veem um botao <strong>Agendar reuniao</strong>.

6. A barra de compartilhamento

A barra de compartilhamento aparece em cada pagina de cartao, logo abaixo dos botoes de acao. Inclui botoes para: Copiar link, LinkedIn, X, WhatsApp, Email e (no celular) compartilhamento nativo. Cada botao ja vem configurado com o nome e link do cartao — visitantes so precisam tocar.

7. QR codes

Cada cartao publico exibe um QR code com a marca na pagina, com o rotulo "Escaneie para salvar este cartao." O QR codifica a URL publica completa do cartao. Voce tambem pode acessar a imagem QR diretamente em <code>/cards/seu-slug/qr</code> — util para incorporar em apresentacoes, materiais impressos, rodapes de email ou crachas de conferencia. O QR usa as cores da sua marca para um visual profissional.

8. Pre-visualizacao de links (Open Graph)

Quando voce compartilha um link de cartao no LinkedIn, Twitter, WhatsApp, Slack ou iMessage, a plataforma exibe automaticamente uma pre-visualizacao rica com seu nome, titulo e foto. Isso e alimentado por meta tags Open Graph e Twitter Card incorporadas em cada pagina de cartao. Se seu cartao nao tem foto, uma imagem padrao do Ledgi Cards e usada.

9. Analiticos de compartilhamento

Toda vez que alguem clica em um botao de compartilhamento, a plataforma registra qual canal foi usado (LinkedIn, X, WhatsApp, email, copiar, nativo). Voce pode acompanhar isso no painel de analiticos para entender quais canais de distribuicao geram mais engajamento para cada cartao.

10. Entendendo os templates de wallet

O Ledgi Cards oferece <strong>50 templates de wallet profissionalmente desenhados</strong> organizados em cinco categorias:

• <strong>Profissional</strong> — Executive Slate, Boardroom Navy, Venture Midnight, Startup Electric e mais. Tons escuros e sofisticados para ambientes corporativos.
• <strong>Criativo</strong> — Studio Coral, Designer Violet, Photographer Dusk, Musician Indigo. Cores expressivas para artistas e criadores.
• <strong>Industria</strong> — Real Estate Forest, Legal Burgundy, Medical Ocean, Finance Emerald. Linguagens de cor especificas por setor.
• <strong>Tech</strong> — SaaS Gradient, DevOps Terminal, AI Nebula, Cyber Matrix. Esteticas nativas de tecnologia, do neon ao verde terminal.
• <strong>Lifestyle</strong> — Wellness Lavender, Fitness Orange, Travel Sky Blue, Personal Minimal. Quentes e acessiveis para coaches, freelancers e criadores.

Cada template define a <strong>cor de fundo</strong>, <strong>cor do texto</strong> e <strong>cor dos rotulos</strong> do seu Apple Wallet pass. A pre-visualizacao ao vivo no formulario de criacao atualiza em tempo real conforme voce seleciona diferentes templates.

11. Escolhendo o template certo

1. Pense na sua <strong>industria</strong> e <strong>audiencia</strong>. Um advogado pode escolher Legal Burgundy; um fundador de startup pode preferir Startup Electric.
2. Considere a <strong>legibilidade</strong>. Texto claro em fundos escuros e sempre nitido. Templates com texto escuro (como Personal Minimal) funcionam melhor se as informacoes do cartao sao curtas.
3. Use a <strong>pre-visualizacao ao vivo</strong> — conforme voce digita nome e titulo no formulario, a pre-visualizacao atualiza instantaneamente.
4. Voce pode criar multiplos cartoes com templates diferentes — um para conferencias, outro para networking casual.

12. Como funciona a captura de contatos

Quando alguem visita seu cartao publico, ve um formulario de captura com dois modos:

1. <strong>Captura rapida</strong> — Apenas nome e contexto opcional ("Onde se conheceram?"). Um clique para salvar.
2. <strong>Dados completos</strong> — Clique em "Adicionar mais detalhes" para revelar campos de email, empresa, telefone, nome do evento, localizacao e notas.

Apos enviar, o contato e salvo no seu workspace imediatamente. Nos bastidores, o pipeline de enriquecimento por IA e acionado em segundos.

13. Gerenciando contatos

Visite <code>/app/contacts</code> para ver todos os leads capturados. Cada cartao de contato mostra:

• Nome, empresa e cargo
• <strong>Resumo de IA</strong> — Descricao de 2-3 frases do contato e contexto do relacionamento
• <strong>Proxima melhor acao</strong> — Uma recomendacao especifica de follow-up com prazo
• <strong>Forca do relacionamento</strong> — Fraco, moderado ou forte baseado nos dados disponiveis
• <strong>Iniciadores de conversa</strong> — 3 pontos de conversa personalizados baseados no contexto da reuniao
• <strong>Tags de interesse</strong> — Interesses profissionais inferidos pelo contexto

14. Como funciona o enriquecimento por IA

1. Quando um contato e capturado, o sistema envia seus dados (nome, empresa, email, contexto da reuniao, evento, localizacao, notas) para um modelo de IA.
2. A IA analisa os dados e retorna inteligencia estruturada: inferencia de cargo, detalhes da empresa, interesses, resumo, score de confianca, proxima melhor acao, forca do relacionamento, iniciadores de conversa, timing de follow-up e tags.
3. Se nenhuma chave de API de IA estiver configurada, um <strong>fallback heuristico</strong> gera padroes razoaveis a partir de analise de palavras-chave.
4. O enriquecimento acontece em segundo plano — nao bloqueia a resposta do formulario de captura.

Provedores de IA suportados: <strong>OpenAI</strong> (GPT-4), <strong>Anthropic</strong> (Claude), <strong>Google</strong> (Gemini). Configure via variaveis de ambiente.

15. Entendendo os scores de confianca

Cada enriquecimento inclui um score de confianca de 0 a 1:

• <strong>0.9+</strong> — Dados ricos: email, empresa e contexto detalhado da reuniao fornecidos.
• <strong>0.5–0.7</strong> — Dados parciais: nome e algum contexto, mas sem email ou empresa.
• <strong>0.3–0.5</strong> — Dados minimos: apenas um nome foi capturado.

Score mais alto significa que as sugestoes da IA (proxima melhor acao, iniciadores de conversa) sao mais confiaveis.

16. Como a busca funciona

A busca do Ledgi Cards vai alem da correspondencia simples de nomes. Usa um sistema de pontuacao multi-sinal:

• <strong>Correspondencia fuzzy</strong> — Encontra contatos mesmo com pequenos erros de digitacao (ex: "Jhon" encontra "John").
• <strong>Campos ponderados</strong> — Correspondencias de nome pontuam mais alto, seguidas por empresa, cargo, email, evento e resumo de IA.
• <strong>Vies de recencia</strong> — Contatos recentes sao classificados mais alto que antigos.
• <strong>Palavras-chave de acao</strong> — Consultas como "follow up" ou "agendar reuniao" sao impulsionadas se contatos correspondentes tem acoes pendentes.
• <strong>Bonus de frase exata</strong> — Se sua consulta completa aparece literalmente em qualquer campo, aquele contato recebe um impulso significativo.

17. Dicas de busca

1. <strong>Busque por contexto</strong>: "conferencia tech miami" encontra todos que voce conheceu naquele evento.
2. <strong>Busque por intencao</strong>: "follow up" exibe contatos com recomendacoes pendentes de proxima melhor acao.
3. <strong>Busque por empresa</strong>: "Acme" encontra todos os contatos daquela empresa.
4. <strong>Busque por interesse</strong>: "IA pagamentos" encontra contatos cujo perfil de enriquecimento inclui esses topicos.
5. Resultados de busca mostram <strong>pills de motivo de correspondencia</strong> explicando por que cada contato foi classificado — "Correspondencia de nome", "Contato recente", "Correspondencia de empresa", etc.

18. Acompanhando desempenho

O painel de analiticos (<code>/app/analytics</code>) mostra metricas-chave:

• <strong>Cartoes</strong> — Numero total de cartoes ativos.
• <strong>Contatos</strong> — Total de leads capturados em todos os cartoes.
• <strong>Visualizacoes</strong> — Total de visualizacoes de perfil em todos os cartoes publicos.
• <strong>Compartilhamentos</strong> — Total de cliques em botoes de compartilhamento, discriminados por canal (LinkedIn, X, WhatsApp, email, copiar, nativo).

Use essas metricas para medir quais cartoes e canais geram mais engajamento.

19. Planos de assinatura

• <strong>Starter (Gratis)</strong> — 1 cartao, enriquecimento basico por IA, analiticos, compartilhamento e captura de contatos.
• <strong>Pro (US$29/mes)</strong> — 5 cartoes, insights avancados de IA, entrega por wallet, busca contextual e analiticos de compartilhamento.
• <strong>Enterprise (US$99/mes)</strong> — 100 cartoes, provisionamento de equipe, cartoes com marca e integracoes completas.

Todos os planos incluem workspace de relacionamento, painel, botoes de compartilhamento, QR codes e gerenciamento de contatos.