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, 2 = público para todos na empresa.
0, 1, 2 Lista de IDs de tags existentes. IDs inexistentes resultam em erro.
IDs de pessoas já cadastradas que serão associadas.
Organização existente. Conflita com organization.
Rastreio de marketing. Todos os valores são sanetizados (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.