[email protected]  +55 27 99639-3419
0

Enviando Leads para o Perfex CRM

O Perfex é um CRM, ou seja, um gerenciador de relacionamento com os clientes. Mas enquanto um futuro cliente ainda não efetivou a compra ele permanece no estado de Lead. Os Leads tem um tratamento específico no PerfexCRM, utilizando a PerfexAPI você pode receber dados de leads vindos de outras ferramentas e adiciona-los ao Perfex CRM ou apenas atualizar um campo de um determinado Lead.

Como enviar Leads ao Perfex CRM?

Você pode enviar enviar um Lead para o PerfexCRM através do método de caixa de emails monitorada, este método possui uma serie de limitações, além de não permitir que seja selecionado status, fonte e proprietário, neste método é possível enviar apenas dados que componham os campos gerais dos Leads, e, em caso de reenvio, os dados são sobrescritos (o que pode ser um problema em grandes volumes de clientes).

Um outro método que pode auxiliar no manejo destes dados é a PerfexAPI, por ela é possível não só acessar a campos relacionados aos Leads que são originalmente inacessíveis como é possível usar funções que evitam atualizações ou criações indesejadas de novos Leads no Perfex CRM. Nos textos abaixo serão potuados os processos de criação, atualização e as funções disponíveis para o endpoint perfexAPI/leads_api

Criando ou atualizando um Lead

O primeiro passo é apontar a saída de dados de sua aplicação para o endpoint lead_api, com ele é possível realizar as seguintes ações: Criar um novo contato, Atualizar um contato e/ou Solicitar dados do contato.

Para criar um novo lead, é necessário enviar um POST com os campos que deseja alimentar. Porem para ação de criar novo lead existem certos campos que são essenciais. São eles:

  • Assigned: Quem é o proprietário do Lead
  • Source: A fonte de onde o Lead está vindo
  • Status: A qual status pertence este Lead
  • Nome: O nome pelo qual o Lead é identificado
  • Email*: O email de identificação do Lead
    *Na ausencia do email, você pode identificar o Lead pelo Telefone
  • Telefone: O numero de telefone pelo qual o Lead será identificado.

Enviando algum valor nestes campos um novo lead será criado. A Api utiliza o email como identificador único primário e o Telefone como identificador suplente. Caso ja exista no sistema algum Lead com o email apontado, ele será atualizado com os dados enviados no POST.

Para atualizar um lead é necessário enviar um dos campos de identificação, Email ou Telefone (na ausencia do Email). E os campos que deseja atualizar. Caso o Lead enviado já possua seu email registrado no PerfexCRM a API não irá criar um novo lead. Mas irá atualizar às informações do PerfexCRM substituindo pelos dados contidos no POST.

Campos que podem ser alimentados

Lista de campos disponíveis para serem enviados pela PerfexAPI para compor um novo Lead ou realizar um update.

sourceidCampo referente ao ID das fontes de dados (Source) configuradas no Perfex CRM
assignedidCampo referente ao ID dos usuários (Staff) configurados no Perfex CRM
statusidCampo referente ao ID dos status dos Leads configurados no Perfex CRM
email@Campo referente ao email do Lead a ser cadastrado ou resgatado no Perfex CRM
nametextCampo referente ao Nome e Sobrenome do Lead a ser cadastrado ou resgatado no Perfex CRM
companytextCampo referente ao Nome e Sobrenome do Lead a ser cadastrado ou resgatado no Perfex CRM
titletextCampo referente ao Position do Lead a ser cadastrado ou resgatado no Perfex CRM
websiteurlCampo referente ao Website do Lead a ser cadastrado ou resgatado no Perfex CRM
phonenumbertextCampo referente ao Telefone do Lead a ser cadastrado ou resgatado no Perfex CRM
addresstextCampo referente ao Endereço (Rua, numero, complemento) do Lead a ser cadastrado ou resgatado no Perfex CRM
citytextCampo referente ao Cidade do Lead a ser cadastrado ou resgatado no Perfex CRM
statetextCampo referente ao Estado do Lead a ser cadastrado ou resgatado no Perfex CRM
countryrefererCampo referente ao Pais do Lead a ser cadastrado ou resgatado no Perfex CRM. Este valor possui uma tabela de referencias baseada no banco da dados do próprio Perfex CRM.
ziptextCampo referente ao CEP do Lead a ser cadastrado ou resgatado no Perfex CRM
tagstextCampo referente às Tags do Lead a ser cadastrado ou resgatado no Perfex CRM. O campo tags aceita mais de um valor que podem ser separados por ‘,’. Para remover uma tags é necessário entrar com ‘-‘ frente ao nome da tag a ser removida.
descriptiontextareaCampo referente à Descrição a ser adicionada ao Lead a ser cadastrado ou resgatado no Perfex CRM. Este campo possui a propriedade de adicionar o valor enviado em uma novalinha abaixo do valor presente no perfil do Lead.
leads_?textCampo referente aos “Custom Fields” ativos do Lead ser cadastrado ou resgatado no Perfex CRM. O termo utilizado para apontamento do campo é o valor slug da tabela de campos personalizados. Cada campos personalizado deve ser enviado de forma separada, adicionando um novo campo no webhook para cara campo personalizado a ser enviado.

Funções especificas do endpoint leads_api

A PerfexAPI no endpoint Leads_api possui algumas funções que permitem uma maior inteligencia no tráfegor de dados. Assim é possivel que você atualize ou crie apenas os Leads que ja estão no Perfex CRM ou apenas os novos. Além disto é possivel retornar dados referentes aos campos ou e aos valores dos campos do Lead.

Tokentoken = SenhaO Token é necessário em todas as requisições, caso não envie o token ou envie um token invalido, a API retornará erro.
Block Create Leadblockcreatelead = 1Esta função verifica se o email enviado ja existe no banco de dados, caso exista, ele pode ser atualizado, caso não exista, ele não será criado.
Block Update Leadblockupdatelead = 1Esta função verifica se o email enviado ja existe no banco de dados, caso exista, ele não poderá receber a atualização. Caso exista, ele não será criado.
Return Active Fieldsreturnactivefields = 1Esta função retorna todos os valores disponíveis para os campos: Status, Source e Assigned.
Return Custom Fieldsreturncustomfields = 1Esta função retorna todos os valores disponíveis para os campos customizados globais.
email = email consultadoAo adicionar um email esta função retorna todos os valores disponíveis para os custom fields designados a este Lead.
Return Inforeturninfo = 1Esta função retorna todos os campos disponíveis globais.
email = email consultado
value = 1
Ao adicionar um email esta função retorna todos os valores disponíveis para os todos os campos do lead que pertence ao email consultado

Fique de olho em nosso Changelog

O chancelog é a página aonde você irá encontrar os dados das versões e os upgrades mais importante. Por ela é possível acompanhar se houve alguma alteração nas funções ou se existe alguma alteração nas funções e nome dos campos.


Apoie este projeto.

Receba agora o acesso à API.