# Sparkle Leadz — documentação

> Manual do Sparkle Leadz, CRM com Chat de conversas (WhatsApp, Instagram, Messenger e chat do site), funis de automação e agentes de IA. Cada página abaixo tem uma versão em Markdown puro: basta acrescentar .md ao endereço.

## Começar

- [O que é o Sparkle Leadz](https://docs.sparkleleadz.com/comecar/o-que-e-o-sparkle-leadz.md): Um resumo do que o sistema faz, como as peças se encaixam e o que você precisa para começar.
- [Primeiros passos](https://docs.sparkleleadz.com/comecar/primeiros-passos.md): O roteiro completo para sair do zero e chegar ao primeiro atendimento e à primeira automação.
- [Conheça as telas](https://docs.sparkleleadz.com/comecar/conheca-as-telas.md): Um passeio pelo menu do Leadz, item por item, para você saber onde fica cada coisa.

## Canais

- [Visão geral dos canais](https://docs.sparkleleadz.com/canais/visao-geral.md): Conheça os canais de mensagem do Leadz, a diferença entre os dois tipos de WhatsApp e como gerenciar várias contas.
- [WhatsApp API oficial](https://docs.sparkleleadz.com/canais/whatsapp-oficial.md): Conecte o número oficial da sua empresa pela API da Meta e atenda pelo Chat de conversas.
- [Templates do WhatsApp](https://docs.sparkleleadz.com/canais/templates-do-whatsapp.md): Crie modelos de mensagem, acompanhe a aprovação da Meta e use-os no Chat de conversas, no funil e nos disparos.
- [Janela de 24 horas](https://docs.sparkleleadz.com/canais/janela-de-24-horas.md): Entenda a regra da Meta que define quando você pode escrever livremente e quando precisa de um template.
- [WhatsApp por QR Code](https://docs.sparkleleadz.com/canais/whatsapp-qr-code.md): Conecte um número de WhatsApp por QR Code ou código, com suporte a grupos e sem templates.
- [Instagram](https://docs.sparkleleadz.com/canais/instagram.md): Conecte a conta profissional do Instagram e atenda as mensagens diretas pelo Chat de conversas.
- [Messenger](https://docs.sparkleleadz.com/canais/messenger.md): Conecte a Página do Facebook e atenda as mensagens do Messenger pelo Chat de conversas.
- [Chatbot do site](https://docs.sparkleleadz.com/canais/chatbot-do-site.md): Crie um chat para o seu site, com a sua aparência, artigos de ajuda, IA e atendimento da equipe.
- [Instalar o Chatbot no site](https://docs.sparkleleadz.com/canais/chatbot-instalar.md): Coloque o chat no ar com um código no site, um link direto, um espaço dentro da página ou um arquivo pronto.
- [Email](https://docs.sparkleleadz.com/canais/email.md): Autentique o seu domínio e crie os remetentes usados nas campanhas e nos funis de email.

## Atendimento

- [Chat de conversas](https://docs.sparkleleadz.com/atendimento/chat-de-conversas.md): Atenda WhatsApp, Instagram, Messenger e o Chatbot do site em uma só tela.
- [Enviar mensagens e mídia](https://docs.sparkleleadz.com/atendimento/enviar-mensagens-e-midia.md): Texto, imagem, vídeo, áudio, documento, template, transmissão e funil a partir de uma conversa.
- [Respostas rápidas](https://docs.sparkleleadz.com/atendimento/respostas-rapidas.md): Guarde textos e arquivos prontos e use em qualquer conversa com dois cliques.
- [Mini-chat](https://docs.sparkleleadz.com/atendimento/mini-chat.md): Responda conversas de qualquer tela do Leadz, sem sair do que você está fazendo.
- [Painel](https://docs.sparkleleadz.com/atendimento/painel.md): Entenda de onde vem cada número do Painel e monte a sua própria visão.

## Vendas

- [CRM](https://docs.sparkleleadz.com/vendas/crm.md): Organize suas oportunidades em quadros com etapas e acompanhe cada card até a venda.
- [Contatos](https://docs.sparkleleadz.com/vendas/contatos.md): Encontre, filtre, cadastre e organize todas as pessoas do seu workspace.
- [Campos personalizados e tags](https://docs.sparkleleadz.com/vendas/campos-personalizados-e-tags.md): Guarde as informações que só o seu negócio usa e classifique os contatos com tags e status.
- [Importar e exportar contatos](https://docs.sparkleleadz.com/vendas/importar-e-exportar-contatos.md): Traga a sua lista de uma planilha e leve os contatos do Leadz para fora quando precisar.
- [Negociações](https://docs.sparkleleadz.com/vendas/negociacoes.md): Registre o que cada contato está negociando ou já comprou, à mão ou por automação.
- [Tarefas](https://docs.sparkleleadz.com/vendas/tarefas.md): Organize as pendências da equipe e agende contatos feitos por agentes de IA.

## Funil

- [Visão geral do Funil](https://docs.sparkleleadz.com/funil/visao-geral.md): Entenda o que é um funil, como criar, organizar em pastas e usar o editor visual.
- [Gatilhos](https://docs.sparkleleadz.com/funil/gatilhos.md): Todos os acontecimentos que fazem um funil começar, o que configurar em cada um e exemplos de uso.
- [Blocos de mensagem](https://docs.sparkleleadz.com/funil/blocos-de-mensagem.md): Envie texto, mídia, áudio, botões, cartões, template e email pelo funil, com variáveis que personalizam cada mensagem.
- [Blocos de lógica](https://docs.sparkleleadz.com/funil/blocos-de-logica.md): Divida o caminho com condições, espere um tempo ou um acontecimento, faça teste A/B e leve o contato para outro funil.
- [Blocos de ação](https://docs.sparkleleadz.com/funil/blocos-de-acao.md): Mova cards, aplique tags, preencha campos, crie tarefas, abra negociações e envie dados para outros sistemas pelo funil.
- [IA no funil](https://docs.sparkleleadz.com/funil/ia-no-funil.md): Use blocos de inteligência artificial para responder, decidir o caminho, extrair dados e chamar um Agente IA dentro do funil.
- [HTTP Request](https://docs.sparkleleadz.com/funil/http-request.md): Busque ou envie dados para um site ou sistema externo pelo funil e use a resposta em mensagens, condições, campos e tags.
- [Funil e janela de 24 horas](https://docs.sparkleleadz.com/funil/funil-e-janela-de-24-horas.md): Saiba o que o funil consegue enviar quando a janela da Meta está fechada, como o editor avisa e como montar esperas longas sem perder mensagens.
- [Testar e publicar](https://docs.sparkleleadz.com/funil/testar-e-publicar.md): Entenda a diferença entre rascunho e publicado, simule o funil sem enviar nada e coloque no ar com segurança.
- [Execuções e métricas](https://docs.sparkleleadz.com/funil/execucoes-e-metricas.md): Veja por onde cada contato passou no funil, por que uma execução parou e quais blocos entregam, perdem ou recebem cliques.

## Disparos

- [Disparos](https://docs.sparkleleadz.com/disparos/visao-geral.md): Envie uma mensagem para muitos contatos de uma vez, com audiência filtrada, ritmo controlado, agendamento e acompanhamento por destinatário.

## Agentes IA

- [Visão geral dos Agentes IA](https://docs.sparkleleadz.com/agentes-ia/visao-geral.md): O que é um Agente IA no Leadz, o que ele faz, onde atende e quando fica calado.
- [Provedores e modelos de IA](https://docs.sparkleleadz.com/agentes-ia/provedores-e-modelos.md): Conecte sua chave da OpenAI, Anthropic, Google, Groq ou Mistral e escolha o modelo que o agente usa.
- [Criar um agente](https://docs.sparkleleadz.com/agentes-ia/criar-um-agente.md): O passo a passo da tela de criação, do nome às instruções, contas, horários e transferência.
- [Boas práticas de prompt](https://docs.sparkleleadz.com/agentes-ia/boas-praticas-de-prompt.md): Como escrever instruções que funcionam no Leadz, com exemplos de certo e errado.
- [Manual para criar o prompt](https://docs.sparkleleadz.com/agentes-ia/manual-para-criar-o-prompt.md): Um arquivo para colar no ChatGPT, no Claude ou no Gemini, que ensina a outra IA a escrever o prompt do seu agente do jeito que o Leadz entende.
- [Ações no CRM](https://docs.sparkleleadz.com/agentes-ia/acoes-no-crm.md): Libere o que o agente pode fazer além de responder: gravar campos, pôr tags, mover o card, criar tarefas e enviar eventos.
- [Materiais e base de conhecimento](https://docs.sparkleleadz.com/agentes-ia/materiais-e-base-de-conhecimento.md): Cadastre textos, documentos, imagens, vídeos e links que o agente consulta para responder e envia ao contato.
- [Botões e mídia](https://docs.sparkleleadz.com/agentes-ia/botoes-e-midia.md): Como o agente envia botões e links, e como entende o áudio, a imagem e o arquivo que o contato manda, em cada canal.
- [Testar o agente](https://docs.sparkleleadz.com/agentes-ia/testar-o-agente.md): Converse com o agente como se fosse um contato, veja as ações que ele faria e ajuste as instruções antes de ligar.

## Integrações

- [Visão geral das integrações](https://docs.sparkleleadz.com/integracoes/visao-geral.md): Veja o que se liga ao Sparkle Leadz e qual caminho usar em cada caso.
- [Sparkle Tracker](https://docs.sparkleleadz.com/integracoes/sparkle-tracker.md): Receba leads, compras e reembolsos rastreados, com a origem do anúncio, e use esses eventos nos seus funis.
- [Checkouts e plataformas de venda](https://docs.sparkleleadz.com/integracoes/checkouts-e-plataformas.md): Ligue Hotmart, Kiwify, Monetizze, Eduzz e outras plataformas de venda ao Leadz pelo Sparkle Tracker ou por webhook.
- [Webhooks de entrada](https://docs.sparkleleadz.com/integracoes/webhooks-de-entrada.md): Receba dados de qualquer plataforma em um endereço do Leadz e transforme cada envio em contato, negociação e gatilho de funil.
- [Postbacks](https://docs.sparkleleadz.com/integracoes/postbacks.md): Receba conversões de redes de afiliados, corretoras e trackers por um endereço com parâmetros e ligue cada evento ao contato certo.
- [Webhook de saída](https://docs.sparkleleadz.com/integracoes/webhook-de-saida.md): Avise outro sistema quando algo acontece no Leadz, usando os blocos Webhook e HTTP Request do funil.
- [API de eventos](https://docs.sparkleleadz.com/integracoes/api-de-eventos.md): Envie eventos do seu sistema para o Leadz com uma chave pessoal, em um formato fixo de JSON.
- [Conexões de IA (MCP)](https://docs.sparkleleadz.com/integracoes/conexoes-de-ia-mcp.md): Ligue o Claude, o ChatGPT e ferramentas de automação ao seu CRM, com permissões e aprovação das ações de risco.

## Receitas prontas

- [Recuperar Pix gerado e boleto em aberto](https://docs.sparkleleadz.com/receitas/recuperar-pix-e-boleto.md): Um funil que espera o pagamento, confere se ele caiu e só chama no WhatsApp quem ainda não pagou.
- [Boas-vindas para quem chama pela primeira vez](https://docs.sparkleleadz.com/receitas/boas-vindas-automatica.md): Um funil que responde na hora, pergunta o que a pessoa procura e deixa o contato organizado no CRM.
- [Agente IA que qualifica e move o card](https://docs.sparkleleadz.com/receitas/agente-que-qualifica-e-move-o-card.md): Um agente que faz as perguntas certas, grava as respostas na ficha do contato e avança a etapa no CRM.

## Conta e equipe

- [Criar conta e entrar](https://docs.sparkleleadz.com/conta/criar-conta-e-entrar.md): Faça o cadastro, crie o primeiro workspace, entre no Leadz e recupere a senha quando precisar.
- [Workspaces](https://docs.sparkleleadz.com/conta/workspaces.md): Entenda o que é um workspace, troque de ambiente, crie outro e ajuste nome, logo e descrição.
- [Equipe e cargos](https://docs.sparkleleadz.com/conta/equipe-e-cargos.md): Convide pessoas, defina o que cada cargo pode acessar e limite os números e páginas que cada membro vê.
- [Segurança e verificação em duas etapas](https://docs.sparkleleadz.com/conta/seguranca-e-verificacao-em-duas-etapas.md): Proteja a sua conta com um código do celular, guarde os códigos de recuperação e encerre sessões abertas.
- [Perfil e preferências](https://docs.sparkleleadz.com/conta/perfil-e-preferencias.md): Ajuste o seu nome e a sua foto, escolha o tema, acompanhe as notificações e use o Leadz no celular.
- [Planos e limites](https://docs.sparkleleadz.com/conta/planos-e-limites.md): Entenda o que conta em cada limite do plano, o que acontece ao atingir o teto e como mudar de plano.
- [Financeiro](https://docs.sparkleleadz.com/conta/financeiro.md): Veja o seu plano, a próxima cobrança e os pagamentos, atualize a forma de pagamento e cancele a assinatura.
- [Seus dados](https://docs.sparkleleadz.com/conta/seus-dados.md): Exporte contatos, atenda pedidos de titulares, apague um contato por completo e saiba o que acontece ao encerrar a conta.

## Ajuda

- [Perguntas frequentes](https://docs.sparkleleadz.com/ajuda/perguntas-frequentes.md): As dúvidas que mais aparecem sobre o Sparkle Leadz, com respostas curtas e o caminho para o guia completo.
- [Solução de problemas](https://docs.sparkleleadz.com/ajuda/solucao-de-problemas.md): Os erros mais comuns do Leadz, por assunto, com a causa e o que fazer em cada um.
- [Glossário](https://docs.sparkleleadz.com/ajuda/glossario.md): Os termos do Sparkle Leadz e do mercado de vendas por mensagem, explicados em uma ou duas frases.
- [Falar com o suporte](https://docs.sparkleleadz.com/ajuda/falar-com-o-suporte.md): Onde fica o botão de suporte e o que mandar junto para o seu caso ser resolvido mais rápido.

## Arquivos

- [Manual para criar o prompt do agente IA](https://docs.sparkleleadz.com/manual-agente-ia.md): cole numa IA para ela escrever o prompt do agente no formato que o Leadz entende.