Pular para o conteúdo principal

Primeiros Passos Após a Instalação

Parabéns — o LeadHub está instalado e você está conectado ao painel de administração. Este guia orienta você por tudo o que deve fazer na primeira sessão para deixar o LeadHub totalmente operacional. Siga estes passos em ordem e você estará funcionando em menos de 30 minutos.

Conhecendo o Painel de Administração​

Antes de começar as tarefas de configuração, reserve 60 segundos para se orientar. O painel de administração do LeadHub tem uma barra lateral à esquerda. As seções principais são:

  • Dashboard — sua visão geral com estatísticas-chave: total de leads, novos leads hoje, esta semana, este mês, taxa de conversão, contagem de pipelines ativos e tempo médio de resposta. Os gráficos mostram o volume de leads ao longo do tempo, leads por fonte e distribuição de pipelines.
  • Leads — a lista completa de todos os leads no seu sistema. Você pode filtrar, pesquisar, ordenar, favoritar, marcar, atribuir e gerenciar leads a partir daqui.
  • Quadro Kanban — um quadro visual de arrastar e soltar mostrando seus leads classificados por estágio do pipeline (como o Trello, mas para leads).
  • Pipelines — onde você cria e gerencia seus estágios de vendas/qualificação.
  • Fontes de Leads — onde você conecta fontes externas como Facebook Lead Ads, Google Ads, Typeform, etc.
  • Formulários — o construtor de formulários web integrado para incorporar formulários de captura de leads no seu site.
  • Automações — onde você constrói fluxos de trabalho automatizados que são acionados quando certas coisas acontecem com os leads.
  • Integrações — conexões pré-construídas com ferramentas de terceiros.
  • Modelos de Email — modelos de email reutilizáveis para emails automatizados.
  • Equipe — gerencie usuários, funções e convites.
  • Relatórios — relatórios detalhados sobre volume de leads, desempenho de fontes, desempenho de agentes, funil de pipeline, taxas de conversão e mais.
  • Configurações — toda a configuração: configurações gerais, email, marca, segurança, chaves API, licença e mais.
  • Chaves API — crie e gerencie chaves API para conectar ferramentas externas.

A seção de Configurações é expandida na barra lateral e contém múltiplas subpáginas: Geral, Email, Marca, Segurança, Licença e outras.

Passo 1 — Configurar a Tarefa Cron​

Faça isso primeiro, antes de qualquer outra coisa. A tarefa cron é o que faz o LeadHub funcionar em tempo real. Sem ela:

  • Leads chegando do Facebook, Google Ads e outras fontes ficarão em uma fila e não aparecerão no seu dashboard
  • Automações não serão executadas
  • Emails programados não serão enviados
  • Fontes de email IMAP não serão verificadas
  • Relatórios programados não serão entregues

A tarefa cron é executada a cada minuto em segundo plano e cuida de tudo isso automaticamente. Você a configura uma vez e esquece.

Para instruções completas sobre como adicionar a tarefa cron no cPanel, Plesk e DirectAdmin, consulte o Guia de Hospedagem Compartilhada — Configurando a Tarefa Cron.

O comando que você precisa adicionar (executando a cada minuto) é:

php /home/yourusername/leadhub/cron.php >> /dev/null 2>&1

Substitua o caminho pelo caminho real do seu arquivo cron.php no seu servidor.

Passo 2 — Configurar o Email (Configurações → Email)​

O LeadHub precisa dos seus dados de email SMTP para enviar qualquer tipo de email — emails de convite para membros da equipe, emails de notificação de leads, emails de automação, emails de relatórios programados e emails de teste.

Como configurar o email​

  1. No painel de administração, clique em Configurações na barra lateral.

  2. Clique em Email na seção de Configurações.

  3. Preencha o formulário de Configuração SMTP:

    CampoO que inserir
    HostO endereço do servidor SMTP do seu provedor de email (ex., smtp.gmail.com, smtp.mailgun.org, email-smtp.us-east-1.amazonaws.com)
    PortGeralmente 587 para TLS, ou 465 para SSL. Verifique com seu provedor de email.
    EncryptionEscolha TLS (mais comum) ou SSL. Use None apenas se seu provedor exigir.
    UsernameSeu nome de usuário SMTP (geralmente seu endereço de email, ou uma chave API dependendo do provedor)
    PasswordSua senha SMTP ou chave API

  4. Preencha a seção de Endereço do Remetente:

    CampoO que inserir
    From NameO nome que aparecerá nas caixas de entrada dos destinatários (ex., "Acme CRM" ou seu nome)
    From EmailO endereço de email de onde os emails parecerão vir (ex., [email protected])

  5. Clique em Salvar Configurações.

  6. Clique em Enviar Email de Teste (o botão no canto superior direito da página). O LeadHub enviará um email de teste para o endereço de email da sua conta de administrador. Se chegar, está tudo certo. Se falhar, você verá uma mensagem de erro indicando o que deu errado (geralmente credenciais SMTP incorretas ou porta bloqueada).

Configurações SMTP comuns por provedor​

Gmail / Google Workspace:

  • Host: smtp.gmail.com
  • Port: 587
  • Encryption: TLS
  • Username: seu endereço completo do Gmail
  • Password: uma Senha de Aplicativo (não sua senha regular do Gmail — você precisa gerar uma Senha de Aplicativo em Conta Google → Segurança → Verificação em 2 etapas → Senhas de aplicativo)

Mailgun:

  • Host: smtp.mailgun.org
  • Port: 587
  • Encryption: TLS
  • Username: seu nome de usuário SMTP do Mailgun (das configurações do seu domínio Mailgun)
  • Password: sua senha SMTP do Mailgun

Amazon SES:

  • Host: email-smtp.us-east-1.amazonaws.com (a região pode variar)
  • Port: 587
  • Encryption: TLS
  • Username e Password: suas credenciais SMTP do SES (criadas no console do SES em Configurações SMTP)

Para outros provedores, consulte a documentação deles sobre "configurações SMTP" — todos fornecem os valores exatos de que você precisa.

Passo 3 — Criar Seu Primeiro Pipeline​

Um pipeline é a sequência de estágios pelos quais um lead passa enquanto você trabalha com ele. Por exemplo: Novo Lead → Contatado → Qualificado → Proposta Enviada → Ganho (ou Perdido). Cada lead no LeadHub vive em um pipeline em um estágio específico.

Como criar um pipeline​

  1. Clique em Pipelines na barra lateral.
  2. Clique no botão "Novo Pipeline" (canto superior direito).
  3. Dê um nome ao seu pipeline (ex., "Pipeline de Vendas", "Funil de Marketing", ou o que fizer sentido para o seu negócio).
  4. Opcionalmente escreva uma descrição.
  5. Marque a caixa "Pipeline Padrão" se quiser que novos leads sejam automaticamente colocados neste pipeline. (Você pode mudar isso depois.)
  6. Clique em Salvar.

Adicionando estágios ao seu pipeline​

Após criar o pipeline, você o verá na lista. Clique nele (ou clique no botão Editar / Gerenciar Estágios) para abri-lo e adicionar estágios.

  1. Clique em "Adicionar Estágio".
  2. Insira um nome de estágio (ex., "Novo", "Contatado", "Qualificado", "Proposta Enviada", "Ganho", "Perdido").
  3. Escolha uma cor para o estágio (ajuda a distinguir visualmente os estágios no quadro Kanban).
  4. Clique em Salvar.
  5. Repita para cada estágio que desejar.
  6. Arraste e solte os estágios para reordená-los se necessário.

Seu pipeline está pronto. Os leads se moverão por esses estágios à medida que você trabalhar com eles.

Passo 4 — Conectar Sua Primeira Fonte de Leads​

Uma fonte de leads é como os leads entram no LeadHub. Você pode conectar múltiplas fontes simultaneamente. O LeadHub suporta 19 fontes diferentes.

Como adicionar uma fonte de leads​

  1. Clique em Fontes de Leads na barra lateral.
  2. Clique em "Nova Fonte de Leads" ou "Conectar Fonte".
  3. Escolha o tipo de fonte da lista.
  4. Dê um nome à conexão (ex., "Facebook — Campanha de Verão").
  5. Siga as instruções na tela para essa fonte específica.

Tipos de fontes de leads explicados​

Integrações com plataformas de publicidade (baseadas em webhook):

Essas fontes enviam dados de leads para o LeadHub automaticamente sempre que alguém preenche um formulário de lead na plataforma de publicidade. Você as conecta uma vez e os leads fluem automaticamente.

  • Facebook Lead Ads — quando alguém preenche um formulário de lead no seu anúncio do Facebook, seus dados são enviados instantaneamente ao LeadHub. Você conecta isso através da URL de webhook do Facebook Lead Ads que o LeadHub gera.
  • Instagram Leads — igual ao Facebook Lead Ads, já que os anúncios do Instagram são gerenciados pela plataforma da Meta.
  • TikTok Lead Generation — formulários de leads de campanhas do TikTok.
  • Google Ads Lead Forms — leads das extensões de formulário de lead do Google.
  • LinkedIn Lead Gen Forms — leads de publicidade do LinkedIn.
  • YouTube Lead Forms — leads de campanhas publicitárias do YouTube.
  • Microsoft Advertising — leads de campanhas publicitárias da Microsoft/Bing.
  • Snapchat Lead Ads — leads de publicidade do Snapchat.
  • Pinterest Lead Ads — leads de publicidade do Pinterest.
  • Twitter / X — leads de publicidade do Twitter/X.

Integrações com plataformas de mensagens (baseadas em webhook):

  • WhatsApp Business — mensagens ou opt-ins do WhatsApp Business.
  • Telegram — leads via bot do Telegram.
  • Viber — leads via Viber.

Integrações com ferramentas de formulários (baseadas em webhook):

Essas se conectam a construtores de formulários de terceiros para que os envios de formulários sejam automaticamente enviados ao LeadHub.

  • Typeform — envios dos seus formulários Typeform. Conecte via a URL de webhook mostrada no LeadHub.
  • JotForm — envios dos seus formulários JotForm. Conecte via a integração webhook do JotForm.
  • Calendly — quando alguém agenda uma reunião via Calendly, é adicionado como lead no LeadHub.

Baseadas em email:

  • Email (IMAP) — o LeadHub se conecta a uma caixa de entrada de email via IMAP e converte emails recebidos em leads. Bom para capturar leads que enviam emails diretamente para você. Você fornece o endereço do servidor IMAP, porta, nome de usuário e senha. A tarefa cron verifica a caixa de entrada regularmente.

Formulários integrados:

  • Formulário Web LeadHub — um formulário que você cria inteiramente no LeadHub (veja a seção de Formulários na barra lateral). Você o incorpora no seu site com um pequeno trecho de código. Os envios vão diretamente para o LeadHub — nenhum serviço de terceiros necessário.

Manual:

  • Entrada Manual — simplesmente adicione leads manualmente. Clique em "Novo Lead" de qualquer lugar na seção de Leads e preencha os detalhes. Bom para leads que chegam por telefone, cartão de visita ou outros métodos offline.

Passo 5 — Convidar Membros da Equipe (Configurações → Equipe)​

Se outras pessoas vão usar o LeadHub com você, convide-as aqui.

Como convidar alguém​

  1. Vá para Configurações → Equipe (ou clique em Equipe se aparecer na sua barra lateral).
  2. Clique em "Convidar Membro".
  3. Insira o endereço de email da pessoa.
  4. Escolha a função dela (veja as descrições de funções abaixo).
  5. Clique em Enviar Convite.

O LeadHub enviará um email com um link para aceitar o convite e configurar a conta. (O email deve estar configurado para que isso funcione — veja o Passo 2.)

Funções explicadas​

O LeadHub tem cinco funções. Cada uma determina o que a pessoa pode ver e fazer.

FunçãoO que podem fazer
Super AdminAcesso completo a tudo — todos os leads, todas as configurações, todo o gerenciamento de equipe, toda a cobrança. A conta que instala o LeadHub começa com esta função. Deve haver apenas um ou dois Super Admins.
AdminQuase o mesmo que Super Admin. Pode gerenciar tudo incluindo membros da equipe, configurações e todos os leads. Não pode gerenciar a licença ou configurações em nível de sistema. Adequado para um gerente ou coproprietário de confiança.
ManagerPode ver e gerenciar leads (incluindo importar, exportar e atribuir), gerenciar pipelines, criar e editar formulários e automações, ver integrações, ver relatórios e ver membros da equipe. Não pode convidar novos usuários ou mudar configurações.
AgentPode ver e criar leads, adicionar notas e atividades, atribuir leads, ver formulários e automações, e ver relatórios. Não pode excluir leads, gerenciar pipelines ou mudar nenhuma configuração. Bom para equipe de vendas ou manipuladores de leads.
ViewerAcesso somente leitura. Pode ver leads, estágios do pipeline, formulários e relatórios mas não pode fazer nenhuma alteração. Adequado para partes interessadas que precisam de visibilidade sem poder modificar nada.

Passo 6 — Criar Sua Primeira Automação​

As automações permitem que o LeadHub faça coisas automaticamente quando algo acontece com um lead — sem que você precise estar lá. Por exemplo: "Quando um novo lead chegar do Facebook, atribuí-lo à Sara e enviar um email de notificação para a Sara."

Como criar uma automação​

  1. Clique em Automações na barra lateral.

  2. Clique em "Nova Automação".

  3. Dê um nome (ex., "Novo Lead — Atribuir e Notificar").

  4. Escolha um Gatilho — o evento que inicia a automação. As opções incluem:

    • Novo Lead Recebido — é acionado sempre que um novo lead chega (de qualquer fonte)
    • Estágio do Lead Alterado — é acionado quando um lead se move para um estágio de pipeline diferente
    • Lead Atribuído a Usuário — é acionado quando um lead é atribuído a alguém
    • Tag Adicionada ao Lead — é acionado quando uma tag específica é adicionada
    • Pontuação do Lead Cruza Limite — é acionado quando a pontuação de um lead fica acima ou abaixo de um número
    • Sem Atividade (Baseado em tempo) — é acionado quando um lead não teve atividade por um número definido de dias
    • Formulário Enviado — é acionado quando um formulário específico é enviado
    • Gatilho Manual — é acionado apenas quando você clica manualmente em "Executar" em um lead

  5. Adicione Passos — as ações que a automação realiza. Você pode adicionar quantos passos quiser, em ordem. Tipos de passos disponíveis:

    • Condição — só continua se o lead atender a certos critérios (ex., "apenas se a fonte for Facebook")
    • Atraso — espera um tempo especificado antes do próximo passo
    • Ação — fazer algo. As ações disponíveis incluem:
      • Enviar um email para o lead
      • Enviar uma notificação interna para os usuários
      • Atribuir o lead a um usuário específico
      • Adicionar ou remover uma tag
      • Mover o lead para um estágio do pipeline
      • Alterar o status do lead
      • Enviar um webhook para uma URL externa
      • Criar uma tarefa ou lembrete
      • Enviar uma notificação do Slack
      • Enviar um SMS para o lead

  6. Ative o interruptor Habilitado para ligar a automação.

  7. Clique em Salvar.

A automação agora será executada automaticamente toda vez que a condição do gatilho ocorrer. A tarefa cron (que é executada a cada minuto) processa a fila de automação em segundo plano.

Passo 7 — Personalizar Sua Marca (Configurações → Marca)​

O LeadHub pode ser totalmente personalizado com marca branca — você pode substituir o nome, logo, cores e aparência da página de login pela sua própria marca.

Como configurar a marca​

  1. Vá para Configurações → Marca na barra lateral.
  2. Preencha a seção de Identidade:
    • Nome da Aplicação — substitua "LeadHub" pelo nome da sua marca (ex., "Acme CRM"). Isso aparece na barra superior, na página de login, nos assuntos de email e nos títulos das abas do navegador.
    • Upload de Logo — faça upload do seu arquivo de logo (PNG ou SVG recomendado, idealmente 300×80 pixels). Ou cole uma URL de uma imagem de logo hospedada em outro lugar.
    • Upload de Favicon — o pequeno ícone que aparece nas abas do navegador (32×32 pixels, formato ICO ou PNG).
  3. Preencha a seção de Cores:
    • Cor Primária — clique no seletor de cor e escolha a cor principal da sua marca. Isso afeta botões, links e elementos destacados em todo o painel.
    • Cor de Destaque — uma cor secundária usada para destaques e emblemas.
  4. Preencha a seção de Página de Login:
    • Cor de Fundo — a cor atrás do formulário de login.
    • Upload de Imagem de Fundo do Login — opcionalmente faça upload de uma imagem de fundo em página inteira para a tela de login (tamanho recomendado: 1920×1080 pixels).
  5. Preencha a seção de Marca do Email:
    • Nome do Remetente do Email — o nome que aparece no campo "De" dos emails que o LeadHub envia (ex., "Suporte Acme").
    • Endereço de Email do Remetente — o endereço de email de onde os emails enviados saem.
    • Texto do Rodapé — texto que aparece na parte inferior de todos os emails enviados e formulários públicos (ex., "© 2026 Acme Corp. Todos os direitos reservados.").
  6. Clique em Salvar Marca.

As alterações entram em vigor imediatamente para todos os usuários no seu workspace.

Passo 8 — Habilitar Recursos de IA (Opcional)​

O LeadHub inclui recursos opcionais alimentados por IA para enriquecimento de leads, pontuação e resumos. Esses recursos requerem uma chave API da OpenAI.

O que os recursos de IA fazem​

  • Enriquecimento de leads — preenche automaticamente detalhes ausentes do lead (empresa, cargo, perfil do LinkedIn, setor) com base no endereço de email do lead
  • Assistência na pontuação de leads — sugestões assistidas por IA para qualidade do lead
  • Resumos de leads — gera um resumo em linguagem simples da atividade e notas do lead

Como habilitar os recursos de IA​

  1. Primeiro, você precisa de uma chave API da OpenAI. Vá para platform.openai.com, cadastre-se ou faça login, vá para API Keys e crie uma nova chave.
  2. Na sua instalação do LeadHub, abra o arquivo .env (na pasta raiz do LeadHub — pode ser necessário habilitar "Mostrar Arquivos Ocultos" no Gerenciador de Arquivos do cPanel para vê-lo).
  3. Encontre a linha OPENAI_API_KEY= e adicione sua chave após o sinal de igual: 
    OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  4. Salve o arquivo.

Os recursos de IA estarão disponíveis imediatamente. Você verá botões relacionados à IA nos registros individuais de leads.

Nota sobre custo: A OpenAI cobra por uso. Os recursos de enriquecimento e resumo de leads fazem chamadas API à OpenAI cada vez que são usados. Os custos são tipicamente muito pequenos (frações de centavo por lead) mas se acumularão com altos volumes. Monitore seu painel de uso da OpenAI.

Passo 9 — Verificar Seu Dashboard e Relatórios​

Com seus primeiros leads chegando, seu pipeline configurado e sua equipe convidada, explore o dashboard e os relatórios para entender como tudo está.

Dashboard​

O Dashboard (a página inicial do painel de administração) mostra:

  • Cartões de estatísticas — Total de Leads, Novos Hoje, Novos Esta Semana, Novos Este Mês, Taxa de Conversão, Ativos no Pipeline e Tempo Médio de Resposta. Cada cartão mostra um indicador de tendência (seta para cima/baixo) comparando com o período anterior.
  • Gráfico de Leads ao Longo do Tempo — um gráfico de linha ou barras mostrando o volume de leads por dia ou semana.
  • Gráfico de Leads por Fonte — uma análise de quais fontes de leads estão entregando mais leads.
  • Gráfico de Distribuição do Pipeline — quantos leads estão em cada estágio do seu pipeline.
  • Feed de Leads ao Vivo — um feed em tempo real dos leads mais recentemente adicionados.

Relatórios​

Clique em Relatórios na barra lateral para acessar análises detalhadas:

  • Relatório de Volume de Leads — leads ao longo do tempo com filtragem por intervalo de datas
  • Relatório de Desempenho de Fontes — quais fontes entregam mais leads, melhores taxas de conversão e resposta mais rápida
  • Relatório de Funil do Pipeline — quantos leads passam por cada estágio e onde ocorre a perda
  • Relatório de Desempenho de Agentes — quantos leads cada membro da equipe está gerenciando, tempos de resposta e taxas de conversão
  • Relatório de Tempo de Resposta — quão rapidamente os leads estão sendo contatados após a chegada
  • Relatório de Estatísticas de Automação — quantas vezes cada automação foi executada, taxas de sucesso/falha
  • Relatório de Análise de Formulários — taxas de envio, visualizações e conversões para cada formulário web
  • Log de Auditoria — um registro completo de cada ação realizada no sistema, por quem e quando

Passo 10 — Configurar Chaves API (Se Necessário)​

Se você quer conectar o LeadHub a uma ferramenta externa (como um site personalizado, um CRM ou uma plataforma sem código como Zapier ou Make), você pode criar uma chave API para autorizar essas conexões.

Como criar uma chave API​

  1. Clique em Chaves API na barra lateral (ou vá para Configurações → Chaves API se aparecer lá).

  2. Clique em "Nova Chave API".

  3. Dê à chave um nome descritivo (ex., "Integração com Site" ou "Conexão Zapier").

  4. Escolha os escopos (permissões) que esta chave deve ter. Os escopos controlam o que a ferramenta externa pode fazer:

    • read:leads — ver leads
    • write:leads — criar e atualizar leads
    • delete:leads — excluir leads
    • read:pipelines — ver pipelines
    • write:pipelines — criar e atualizar pipelines
    • read:tags / write:tags — gerenciar tags
    • read:users / write:users / delete:users — gerenciar usuários
    • read:forms / write:forms / delete:forms — gerenciar formulários
    • read:automations / write:automations / delete:automations — gerenciar automações
    • read:integrations / write:integrations — gerenciar integrações

    Conceda apenas os escopos que a ferramenta externa realmente precisa.

  5. Opcionalmente defina uma data de expiração para a chave (bom para segurança — obriga a renovação).

  6. Opcionalmente defina um limite de taxa (máximo de chamadas API por hora).

  7. Clique em Criar Chave.

Importante: A chave API completa (começando com lh_) é mostrada apenas uma vez, imediatamente após a criação. Copie-a e armazene-a em um local seguro (como um gerenciador de senhas). Se você a perder, precisará criar uma nova chave — não há como recuperar a original.

Use a chave API no cabeçalho Authorization das suas requisições HTTP:

Authorization: Bearer lh_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

A documentação completa da API está disponível na seção API desta documentação.

Você Está Pronto​

Se você completou os passos acima, o LeadHub está totalmente operacional. Aqui está um resumo do que você deveria ter feito:

  • Tarefa cron configurada e executando a cada minuto
  • Email configurado e email de teste recebido
  • Primeiro pipeline criado com estágios
  • Primeira fonte de leads conectada
  • Membros da equipe convidados (se aplicável)
  • Pelo menos uma automação criada (opcional mas recomendado)
  • Marca personalizada com seu logo e cores
  • Recursos de IA habilitados (opcional)
  • Dashboard revisado e com boa aparência
  • Chaves API criadas (se conectando ferramentas externas)

A partir daqui, explore o resto da documentação para aprender sobre recursos avançados como regras de pontuação de leads, relatórios programados, incorporação de formulários web, webhooks de saída e mais.