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. Clique em Novo lead para adicionar uma empresa-alvo, com prioridade e o e-mail e telefone do contato principal.
  3. 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.
  4. 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.
  5. 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).
  6. 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), email, telefone e camposExtras opcionais. 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 ou camposExtras. E-mail e telefone atualizam o contato principal; camposExtras é mesclado com o que já estava salvo.
  • 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