API - Passos básicos para cadastrar Lead (Postman)

Criada por Larissa Korosue, Modificado em Qui, 5 Jan, 2023 na (o) 8:48 AM por Larissa Korosue

Atualmente no Spotter temos algumas formas de realizar o cadastro de Leads. Neste artigo, trataremos da inserção de Leads via API com Postman (caso não tenha ele instalado, pode baixar clicando aqui).

Após realizar o download, abrindo o Postman clique em "Collections" > + > Atribua um nome a essa pasta (onde ficarão as requisições) > clique nos três pontinhos > Add Request:

O primeiro passo é identificar a documentação correta, a partir disso teremos o EndPoint a ser utilizado. Se tratando de uso do Spotter V2, esta é a documentação a ser utilizada: https://exactspotter.docs.apiary.io/#/reference/0/leads-insercao

Após acessar a documentação, localize no Postman onde inserir o EndPoint e os Headers:

IMPORTANTE: O Token é encontrado no Spotter acessando o menu lateral esquerdo "Configurações" > Integrações > Token Exact API.

Após feito o ajuste inicial, vamos para o conteúdo a ser enviado para o Spotter. Pela documentação vemos algumas opções de informações a serem enviadas. Para preencher quais dados deseja enviar, selecione primeiro a parte de "Body" > Raw. Neste artigo faremos a requisição por JSON:

Por obrigatoriedade, apenas o valor "name" deve ser preenchido. A origem e o mercado, que são campos obrigatórios de preenchimento dentro do Spotter, quando não são preenchidos na requisição via API, ficam com o valor "N/A" no Spotter e o Lead é enviado aleatoriamente entre os SDRs disponíveis, a menos que seja inserido na requisição o e-mail do SDR {sdrEmail} a ser atribuído.

Para preenchimento do campo CPF/CNPJ, a opção de preenchimento deve estar habilitada por dentro do Spotter. Para isto, pode ser verificado acessando o menu Configurações > Configurações avançadas > Outros:

Caso o campo esteja desabilitado e o dado seja enviado mesmo assim para o Lead, não constará a informação nos detalhes do Lead.

Porém ao habilitar a função de CPF/CNPJ, o valor constará conforme enviado na requisição:

Avalie esse artigo para que possamos melhorar nosso atendimento

Até a próxima!