Central de Ajuda Dealist

Vendas: seu funil comercial

O Vendas é o funil comercial da sua startup: enquanto a Captação organiza a relação com investidores, aqui você acompanha a prospecção e o fechamento de clientes. Cada lead vira um card que avança por etapas — da prospecção ao negócio fechado — para nenhuma oportunidade ficar esquecida.

Para que serve

  • Centralizar todos os leads comerciais em um funil visual, no lugar de planilhas soltas.
  • Guardar contatos, próximos passos e o histórico de cada negociação em um só card.
  • Saber de relance quantos negócios estão em cada etapa e onde estão os gargalos.
  • Receber leads automaticamente de formulários e sistemas externos via API — e manter dados sincronizados com atualizações parciais pelo id do lead.

Quando usar

Sempre que sua startup vende para clientes e precisa controlar o relacionamento comercial — do primeiro contato à assinatura do contrato. É o complemento da Captação: um cuida de quem investe na empresa, o outro de quem compra dela.

Como usar (passo a passo)

  1. O funil já vem com 7 etapas padrão: Prospecção, Contato iniciado, Qualificação, Proposta, Negociação, Fechado e Perdido.
  2. Se a empresa tiver mais de um funil, a tela pergunta qual abrir (dá para memorizar a escolha neste navegador). O nome do funil ativo fica no título — clique nele para trocar, criar outro (copia etapas e etiquetas, sem leads) ou gerenciar. Dá para ter até 10 funis; excluir só vale se o funil estiver vazio e não for o último.
  3. Clique em Novo lead para adicionar uma empresa-alvo, com prioridade e o e-mail e telefone do contato principal.
  4. Abra o card para registrar a próxima ação, um responsável, vários contatos da empresa, comentários na linha do tempo e os campos próprios da sua operação.
  5. Informe o valor da proposta no card (em reais, com centavos). Todo lead começa em R$ 0,00 — que significa "ainda sem valor" — e você pode preencher ou zerar quando quiser. Com valor preenchido, ele aparece no card do funil.
  6. Quando pelo menos um lead da coluna tem valor, surge um ícone de cifrão no topo dela. Clique para ver o total das propostas daquela etapa e quantos leads já têm valor informado.
  7. Na seção Anexos do card, inclua até 5 arquivos de 15 MB cada (documentos, imagens ou vídeos — sem compactados, executáveis ou scripts). Um clipe discreto no card indica quando há anexos. Ao clicar em um anexo, imagens, vídeos, PDFs e textos abrem em tela cheia sem sair do funil; os demais são baixados. Você pode adicionar e remover anexos quando quiser.
  8. Arraste o card entre as colunas conforme a conversa avança — a cada etapa, deixe registrada a próxima ação para não perder o follow-up.
  9. Use etiquetas coloridas para marcar e filtrar leads, e ajuste a ordenação de cada coluna (por nome, data de criação, prioridade ou responsável).
  10. Em Configurações, ajuste as etapas do funil, crie campos personalizados, publique formulários de captação e gere uma chave de API para receber leads automaticamente.

Formulários de captação

Em Configurações › Formulários você cria uma página de preenchimento para sua audiência — sem precisar de programador. Cada envio vira um lead na etapa que você escolher e chega no seu e-mail.

  • Defina um título, uma descrição, a etapa de destino e quais campos pedir (nome é sempre solicitado; e-mail, telefone e seus campos personalizados são opcionais).
  • Você pode ter vários formulários ativos ao mesmo tempo, cada um caindo em uma etapa diferente.
  • Escreva também uma mensagem de confirmação (exibida após o envio) e informe um ou mais e-mails para aviso, separados por ponto e vírgula (;) — todos recebem cada novo lead.
  • Publique pelo link curto (app.dealist.com.br/c/...) nas suas redes sociais, ou copie o código (iframe) para embutir o formulário no seu site.
Aparência: a opção "Usar a aparência pronta do Dealist" (recomendada) já entrega um visual limpo e neutro, sem a marca Dealist, que funciona em qualquer lugar. A opção "Herdar o visual do meu site" entrega o formulário sem estilo, para assumir as cores e fontes da página onde for incorporado — escolha esta só se for embutir no seu próprio site. Para compartilhar o link direto em redes sociais, prefira a aparência pronta.

Exemplo prático

Um formulário do site envia um novo interessado com POST /api/v1/vendas/leads direto para Prospecção. Quando o CRM externo atualiza o e-mail ou um campo personalizado, sua automação chama PATCH /api/v1/vendas/leads/{id} com só o que mudou. O vendedor qualifica no funil, registra a próxima ação e, ao fechar, move o card para Fechado — com todo o histórico preservado.

Erros comuns e como evitar

  • Misturar investidores e clientes: relacionamento com fundos é na Captação; clientes ficam no Vendas.
  • Deixar cards parados sem registrar a próxima ação — o funil perde a função de lembrete.
  • Criar campos demais: configure só os que a equipe realmente preenche.
  • Tratar a coluna do funil como status fiscal/contratual — são controles diferentes.
No plano gratuito você visualiza o quadro. O DealMatch ativo libera criar e mover leads, comentários, campos personalizados, configuração das etapas, etiquetas coloridas, ordenação das colunas, os formulários de captação e a integração via API.

Integração via API

Com o DealMatch ativo, gere uma chave em Configurações › API e autentique com Authorization: Bearer vd_... (ou header X-Api-Key). A chave é exibida uma única vez — guarde-a com segurança.

  • Criar lead — POST /api/v1/vendas/leads com nome (obrigatório) e, opcionais, email, telefone, valorProposta e camposExtras. O lead entra na coluna Prospecção. A resposta traz o id para consultas e atualizações futuras.
  • Atualizar lead — PATCH /api/v1/vendas/leads/{id} sem precisar informar a etapa do funil. Envie só os campos que mudaram: nome, e-mail, telefone, prioridade, próxima ação, lembrete, valorProposta ou camposExtras. E-mail e telefone atualizam o contato principal; camposExtras é mesclado com o que já estava salvo. Se não enviar valorProposta, o valor atual é mantido; enviar 0 zera.
  • Mover de etapa — PATCH /api/v1/vendas/leads/{id}/lane com vendasLaneId (use GET /api/v1/vendas/leads ou o detalhe para descobrir os ids das colunas).
  • Consultar — GET /api/v1/vendas/leads/{id} retorna contatos e campos personalizados; GET /api/v1/vendas/ping testa se a chave está válida.
Campos personalizados precisam existir em Configurações › Campos antes de serem aceitos na API. Na requisição, use a chave do campo, não o rótulo da tela: nomes compostos viram minúsculas com underscore — ex. rótulo Faturamento anual → faturamento_anual em camposExtras. Chaves desconhecidas são ignoradas.

Próximo passo recomendado

Crie seu primeiro lead manualmente para conhecer o card. Em seguida, gere uma chave em Configurações › API, teste com Testar chave agora e conecte seu site ou CRM — use o id retornado no POST para sincronizar alterações com o PATCH.

Ir para a tela no painel Falar com a Dealist