Pular para o conteúdo principal

​
Visão geral

Contatos representam as pessoas com quem você se comunica. Eles podem pertencer a empresas, serem donos de negócios e receber tarefas ou tickets. Este guia mostra como criar contatos, enriquecer dados e manter o cadastro limpo.

​
Criando contatos

  • App: vá em Contatos → Novo contato. Preencha nome, email e, se quiser, associe a uma empresa.
  • API: use POST /contacts (veja API Reference → Contacts). Inclua company_ids para vincular empresas na criação.
  • Importação em massa: envie CSV em Contatos → Importar. Mapeie colunas para campos e propriedades; valide a prévia antes de confirmar.

​
Propriedades personalizadas

Contatos suportam propriedades dinâmicas definidas em Configurações → Propriedades → Contatos. Use para cargo, estágio, LTV, opt-in de newsletter etc. Como usar:
  • Crie definições de propriedade em Configurações com chave, rótulo, tipo e obrigatoriedade.
  • No app, edite o contato e preencha os novos campos.
  • Na API, envie um objeto properties com as chaves das definições (ex.: "job_title": "CTO").

​
Associações

  • Empresas: vincule contatos a empresas para contexto compartilhado e relatórios.
  • Negócios (Deals): associe o contato como stakeholder para clareza de ownership.
  • Tarefas/Tickets: atribua tarefas ou tickets ao contato para follow-ups e suporte.

​
Boas práticas de dados

  • Prefira um email principal por contato; evite duplicar a mesma pessoa em várias empresas.
  • Normalize telefones para E.164 (+5511999999999) para integrá-los a outras ferramentas.
  • Use a checagem de duplicidade na importação; na API, PUT /contacts/upsert mantém idempotência por email.
  • Marque contatos com propriedades (segmentos) em vez de notas soltas para filtrar e automatizar depois.

​
Fluxos comuns

  • Upsert a partir de formulários: conecte submissões a PUT /contacts/upsert para evitar duplicatas.
  • Vincular a uma empresa: quando o email tiver domínio corporativo, associe ao registro de empresa correspondente.
  • Sincronizar com CRM: use automations/webhooks para enviar atualizações de contato a CRMs ou ferramentas de marketing.