Docs/API Pública/Cadastro de Lead Simplificado

Cadastro de Lead Simplificado

Cadastra novos leads no CRM Inforce a partir de formulários, landing pages, portais ou campanhas de marketing.

POST/v2/leads/create/simplificadoScalar Oficial

Exemplo de Requisição

bash

curl --request POST \
  --url https://api-public.inforcedata.com.br/v2/leads/create/simplificado \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer SEU_TOKEN_API' \
  --header 'Content-Type: application/json' \
  --data '{
    "nome": "Maria Carolina",
    "email": "maria.carolina@gmail.com",
    "telefoneCelular": "+5521981750001",
    "telefoneContato": "+552127750001",
    "mensagem": "Gostaria de agendar uma visita ao apartamento",
    "produto": "AP3058",
    "filaDistribuicao": "Equipe Vendas Zona Sul",
    "responsavel": "ana-clara",
    "temperatura": "quente",
    "contatoVia": "online",
    "finalidade": "venda",
    "origem": "landing-page",
    "origemExterna": "Google Ads",
    "origemUrl": "https://meusite.com.br/imovel/AP3058",
    "utm": "utm_source=Google&utm_medium=cpc&utm_campaign=lancamento_lotus"
  }'

Estrutura do Corpo da Requisição (Body JSON)

Propriedade	Tipo	Descrição & Exemplos
`nome`	string	Campo para nome Exemplo: `Maria Carolina`
`telefoneCelular`	string	Número de telefone celular Exemplo: `+5521981750001`
`telefoneContato`	string	Número de telefone contato Exemplo: `+552127750001`
`email`	string	Campo de e-mail Exemplo: `maria.carolina@gmail.com`
`mensagem`	string	Mensagem para compor o cadastro Exemplo: `Lead criado por Sistema de Relacionamento`
`produto`	string	Campo para associar produtos ao cadastro do Lead. "99999" => ProdutoId "Abcde" => ImovelCodigo ou EmpreendimentoNome ou EmpreendimentoSlug "ImvId=1000" => ImovelId "ImvCodigo=AP3058" => ImovelCodigo "EmpId=2000" => EmpreendimentoId "EmpSlug=residencial-lotus" => EmpreendimentoSlug "EmpNome=Residencial Lotus" => EmpreendimentoNome Ex.: "ImvId=1001; ImvId=1002; EmpNome=Residencial Lotus" Exemplo: `AP3058`
`filaDistribuicao`	string	Id ou Nome da Fila de Distribuição. Exemplo: `Nome da Fila de Distribuição`
`responsavel`	string	Id ou Slug do Responsável Exemplo: `ana-clara`
`captador`	boolean	Indica se o lead deve ser captado por um captador.
`filial`	string	Slug da filial onde o lead será registrado. Exemplo: `filial-a`
`setor`	string	Slug do setor onde o lead será registrado. Exemplo: `setor-b`
`temperatura`	string	Slug do setor onde o lead será registrado. Padrão: "frio" Exemplo: `frio`
`contatoVia`	string	Slug da Via de Contato que será registrado. Padrão: "online" Exemplo: `online`
`finalidade`	string	Slug da Finalidade que será registrado. Padrão: "venda" Exemplo: `venda`
`origem`	string	Slug da origem que será registrado. Padrão: "outros" Exemplo: `outros`
`origemExterna`	string	Origem externa do lead, como Google Ads, Facebook Ads, etc. Exemplo: `Facebook Ads`
`origemUrl`	string	Origem URL de onde o lead foi capturado. Exemplo: `https://facebooke.com.br/page/234234324234`
`utm`	string	UTM da campanha de marketing que gerou o lead. Exemplo: `utm_source=Google&utm_medium=CPC&utm_campaign=blackfriday&utm_content=aproveite%20agora&utm_term=cpc-google-blackfriday`
`gclid`	string	Código de clique do Google Ads (gclid) para rastreamento de campanhas. Exemplo: `6.546546546498651e+41`
`fbclid`	string	Código de clique do Facebook Ads (fbclid) para rastreamento de campanhas. Exemplo: `6.546546546498651e+41`

Respostas HTTP & Códigos de Retorno

201Lead registrado com sucesso no CRM.

400Requisição inválida. Verifique os campos enviados no JSON.

500Erro interno no processamento do servidor.