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. - Se crm_lead_source_id e lead_source forem enviados simultaneamente, a requisição é rejeitada. - 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/lead_source sejam enviados (estes ainda são registrados em histórico de marketing). - 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.
Origem existente. Conflita com lead_source.
Seguidores adicionados após a criação do lead. Usuários duplicados na lista são ignorados.