Criação de lead
Cria um lead na empresa vinculada à chave de integração usando o usuário que criou a chave como ator padrão. - O estágio padrão é a primeira etapa do funil primário se stage_id não for informado. - Se responsible_id não for enviado, o responsável será o criador da chave. - A única forma de informar uma origem manual é por crm_lead_source_id. O campo lead_source não é aceito nesta API. - A visibilidade padrão é privada (visibility = 0). - Quando marketing.wegly_code corresponder a um tracker ativo da empresa, a fonte do lead será forçada para a origem atrelada ao tracker, mesmo que crm_lead_source_id seja enviado (a origem manual continua sendo registrada no histórico de marketing). - Quando não houver tracker nem crm_lead_source_id, marketing.wegly_source ou marketing.utm_source busca/cria a origem automaticamente (wegly_source tem prioridade). - marketing.url_conversion é parseada automaticamente para preencher parâmetros wegly_*, utm_*, gclid, fbclid e wegly_conversion_tool faltantes; valores enviados manualmente prevalecem sobre os extraídos da URL. - Deduplicação de pessoa: quando person.avoid_duplicate = true e duplicate_check_types estiver preenchido, o serviço busca contatos existentes (pelos tipos informados) e reaproveita a pessoa encontrada, adicionando contatos faltantes. Nesse caso, a pessoa é incluída automaticamente em persons_id.
Authorizations
Utilize o token de integração no header Authorization: Bearer {token}. O domínio de origem (Origin/Referer) deve respeitar allowed_domain, quando configurado na chave.
Body
150Estágio alvo. Caso omitido, usa a primeira etapa do funil primário.
Responsável pelo lead. Padrão: criador da chave.
1, 2, 3, 4, 5 Motivo da qualificação; obrigatório se o funil exigir.
0 = privado (responsável, membros dos times do responsável e supervisores), 1 = restrito ao responsável e times relacionados.
0, 1 Lista de IDs de tags existentes. IDs inexistentes resultam em erro.
IDs de pessoas já cadastradas que serão associadas.
Pessoa associada ao lead. Envie telefone, e-mail e redes sociais em contacts; phone e email no topo do lead não são aceitos.
Organização existente. Conflita com organization.
Rastreio de marketing. Todos os valores são sanitizados (trim) e campos vazios são ignorados. utm_* são normalizados para wegly_* equivalentes quando estes não forem enviados. utm_term vira utm_search_term se o campo específico não for enviado. url_conversion tem seus parâmetros extraídos automaticamente (wegly_, utm_, gclid, fbclid, conversion_tool_name). Quando wegly_code referencia um tracker válido, a origem do lead é extraída do tracker. Quando não há tracker nem origem explícita, wegly_source ou utm_source busca/cria a origem automaticamente.
Origem existente. Única forma aceita para informar origem manual nesta API.
Seguidores adicionados após a criação do lead. Usuários duplicados na lista são ignorados.
