Leads

Leads

Adicionando um novo lead

Use o método POST para adicionar um novo lead. Segue exemplo de JSON à ser enviado.

{
  "clientKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "teamKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "conversionGoal": "API v2.0",
  "name": "Lead de teste",
  "email": "teste@teste.com.br", 
  "message": "Apenas um teste de inserção de lead usando a API v2.0."
}
Rota
https://www.followize.com.br/api/v2/Leads/
Parâmetros obrigatórios
Nome Tipo Limite Descricao
clientKeyTexto 32Chave do cliente encontrada no menu configurações.
teamKeyTexto 32Chave da equipe encontrada no menu configurações.
conversionGoalTexto 100Identificador do ponto de conversão. Ex.: Formulário de contato, Landing page
nameTexto 100Nome
emailTexto 150E-mail do cliente.
Parâmetros opcionais
Nome Tipo Limite Descricao
attendantIdNúmero10ID do atendente que irá receber o Lead. Obs.: Se identificar o atendente, o rodízio na equipe será ignorado.
attendantEmailTexto 100E-mail do atendente que irá receber o Lead. Obs.: Se identificar o atendente, o rodízio na equipe será ignorado.
messageTexto Mensagem
hubUtmzTexto 632Gerado pela TAG de rastreamento. Valor esperado: utmcsr=ORIGEM|utmccn=CAMPANHA|utmcmd=MÍDIA|utmcct=FORMATO|
phoneTexto 40Telefone do cliente.
cellPhoneTexto 40Celular do cliente.
addressLine1Texto 200Endereço do cliente.
addressLine2Texto 20Complemento do endereço do cliente.
neighborhoodTexto 50Bairro do cliente.
cityTexto 50Cidade do cliente.
stateTexto 50Estado do cliente.
countryTexto 50País do cliente.
zipCodeTexto 9CEP do cliente.
registrationNumberTexto 20CPF do cliente.
jobTitleTexto 50Cargo do cliente.
companyNameTexto 100Nome da empresa do cliente.
companyPhoneTexto 40Telefone da empresa do cliente.
companyEmailTexto 150E-mail da empresa do cliente.
companyWebsiteTexto 150Website da empresa do cliente.
companyRegistrationNumberTexto 20CNPJ da empresa do cliente.
socialTwitterTexto 50Usuário no Twitter do cliente.
socialFacebookTexto 50Usuário no Facebook do cliente.
socialLinkedinTexto 50Usuário no LinkedIn do cliente.
socialGoogleplusTexto 50Usuário no Google Plus do cliente.
socialSkypeTexto 50Usuário no Skype do cliente.
socialWhatsappTexto 50Número de telefone cadastrado no Whatsapp do cliente.
emailOptInBooleano (0=não, 1=sim)Cliente aceita ou não receber email marketing.
productIdNúmero 10ID do produto cadastrado no Followize.
productTitleTexto 200Título do produto.
productReferNúmero 10ID de referência do produto cadastrado no site e/ou ERP próprio.
categoryIdNúmero 10ID da categoria cadastrada no Followize.
categoryTitleTexto 200Título da categoria.
categoryReferNúmero 10ID de referência da categoria cadastrada no site e/ou ERP próprio.
brandIdNúmero 10ID da marca cadastrada no Followize.
brandTitleTexto 200Título da marca.
brandReferNúmero 10ID de referência da marca cadastrada no site e/ou ERP próprio.
locationIdNúmero 10ID da unidade cadastrada no Followize.
locationTitleTexto 200Título da unidade.
locationReferNúmero 10ID de referência da unidade cadastrada no site e/ou ERP próprio.
Respostas
Erro Descrição
4000Um ou mais campos obrigatórios não enviados.
4001Chave de cliente inválida.
4002Chave de equipe inválida.
4003Falha ao cadastrar o contato.
4004Nenhum atendente encontrado na equipe enviada.
4005Falha ao cadastrar a conversão.
Exemplos

PHP

<?php
	$apiURL = "https://www.followize.com.br/api/v2/Leads/";

	$data["clientKey"] = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";
	$data["teamKey"] = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";
	$data["conversionGoal"] = "API v2.0";
	$data["name"] = $_POST["name"];
	$data["email"] = $_POST["email"];

	$data["message"] = $_POST["message"];
	$data["hubUtmz"] = $_POST["hubUtmz"];

	$data = json_encode($data);

	$curl = curl_init();
	curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
	curl_setopt($curl, CURLOPT_URL, $apiURL);
	curl_setopt($curl, CURLOPT_HEADER, false);
	curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
	curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
	curl_setopt($curl, CURLOPT_POST, true);
	curl_setopt($curl, CURLOPT_POSTFIELDS, $data);
	$result = json_decode(curl_exec($curl), true);
	curl_close($curl);

	if ($result["success"] == 1){
		echo "Lead inserido com sucesso.";
	} else {
		echo "Houve um erro na inserção do lead.";
	}
?>

Clique aqui e faça o download desse exemplo.

Ficou interessado?

Converse com um de nossos consultor, tire suas dúvidas e conheça todas as vantagens do Followize.

Solicitar Demonstração