Alterar solicitação / Incluir mensagens – (gravalead)

*** POST (Usaremos a ferramenta Postman)

url: https://nomedoxpro.xpro.me/gestaodeleads/gravalead

Para Alterar / Incluir mensagem em uma solicitação se faz necessário inserir os parâmetros obrigatórios citados a seguir:

Parâmetro : idlead – (Número do protocolo encontrando dentro da plataforma X-Pro na solicitação que gostaria de alterar)

Parâmetro : nome – “Xvision Tecnologia”

Para identificação do cliente é obrigatório utilização de um dos três dos parâmetros abaixo:

telefone – (Nesse campo pode ser inserido o número do celular do cliente)

email – (Inserir e-mail váido)

idcliente – (Id encontrado dentro do cadastro do cliente no X-Pro)

Obs: É possível o envio de todos esses parâmetros para validação.

Parâmetro : token

E como vou gerar o token?

Utilizaremos o método Base64, para auxiliar no processo de conversão. Seguem os dados que iremos converter, assim como o detalhamento de onde encontrar as informações:

base64_encode(date(‘YmdHis’).’TOKENORIGEMDELEAD’.’|IDPROJETO|TOKENTIPODELEAD’).’|’.date(‘W’))

(date(‘YmdHis’) – Data utilizada para inclusão da solicitação composto por: ano, mês, dia, hora, minutos, segundos. Ex: 20201116153100

TOKENORIGEMDELEAD – Esse token é possível ser encontrado dentro da sua plataforma X-Pro.
Menu > Administrar > Origens (Lembrando que a origem que aparecerá nas solicitações que serão incluídas através desse EndPoint será a que está utilizando esse token)

IDPROJETO – O Id do projeto é encontrado dentro da sua plataforma X-Pro.

Menu > Administrar> Projetos > ID é o número do Projeto ( 1 – XPro), Lembrando que o projeto que aparecerá nas solicitações que serão incluídas através desse EndPoint será a que está utilizando esse ID.

TOKENTIPODELEAD – Esse token é possível ser encontrado dentro da sua plataforma X-Pro.

Menu > Administrar > Tipos (Lembrando que o tipo que aparecerá nas solicitações que serão incluídas através desse EndPoint será a que está utilizando esse token).

date(‘W’) – Insira 1 nesse campo.

Segue exemplo de como ficará após inserção das informações:

20201116153100b540124a9fd2e820472b6358b437265b|1|36f4e721a0635dfe616bd1c2c0b4ae94|1

Depois de convertido:

MjAyMDExMTYxNTMxMDB8YjU0MDEyNGE5ZmQyZTgyMDQ3MmI2MzU4YjQzNzI2NWJ8MXwzNmY0ZTcyMWEwNjM1ZGZlNjE2YmQxYzJjMGI0YWU5NHwxCg==

Para além desses parâmetros obrigatórios segue agora os parâmetros opcionais que irão promover as alterações dentro de uma solicitação:

Parâmetro – mensagem: “Olá, tudo bem?”

Parâmetro – idstatusalterar – Para alterar o status utilizar um dos IDs:

Parâmetro – dataproximocontatoalterar – inserir a data que deseja alterar – YYYY-MM-DD HH:ii:ss

{{ano com 4 dígitos}}-{{mês com 2 dígitos}}-{{dia com 2 dígitos}} {{hora com dois dígitos}}:{{minuto com 2 dígitos}}:{{segundo com 2 dígitos}}

Parâmetro – idtipoalterar – Informação encontrada na plataforma X-Pro através do caminho No menu > Administrar > Tipo > o Id será encontrado do lado do nome do tipo que quer utilizar.

Parâmetro – idconsultoralterar – Informação encontrada na plataforma X-Pro através do caminho No menu > Administrar > usuários > o Id será encontrado do lado do nome do usuário que gostaria de alterar.

Pronto, agora já sabemos os parâmetros obrigatórios e como podemos utilizar os parâmetros para realizar as alterações desejadas para dar continuidade na nossa integração, colocaremos o exemplo de como ficará no Postman.

Segue imagem e url que irá retornar no postman:

Para além dessa informação iremos exemplificar como irá ficar em CODE em Php

Php Pecl_HTTP

<?php
$client = new http\Client;
$request = new http\Client\Request;
$request->setRequestUrl(‘https://cs.xpro.me/gestaodeleads/gravalead?token=MjAyMDExMTYxNTMxMDBiNTQwMTI0YTlmZDJlODIwNDcyYjYzNThiNDM3MjY1YnwxfDM2ZjRlNzIxYTA2MzVkZmU2MTZiZDFjMmMwYjRhZTk0fDEK&nome=Marllon Alexander Paula de Almeida&telefone=Xvision Tecnologia &idlead=455&idstatusalterar=1&retorno=json’);
$request->setRequestMethod(‘POST’);
$request->setOptions(array());
$request->setHeaders(array(
‘Cookie’ => ‘PHPSESSID=00klmgkr0g48d22evgei7k8u3m’
));
$client->enqueue($request)->send();
$response = $client->getResponse();
echo $response->getBody();

NodeJs – Request

var request = require(‘request’);
var options = {
‘method’: ‘POST’,
‘url’: ‘https://cs.xpro.me/gestaodeleads/gravalead?token=MjAyMDExMTYxNTMxMDBiNTQwMTI0YTlmZDJlODIwNDcyYjYzNThiNDM3MjY1YnwxfDM2ZjRlNzIxYTA2MzVkZmU2MTZiZDFjMmMwYjRhZTk0fDEK&nome=Marllon Alexander Paula de Almeida&telefone=Xvision Tecnologia &idlead=455&idstatusalterar=1&retorno=json’,
‘headers’: {
‘Cookie’: ‘PHPSESSID=00klmgkr0g48d22evgei7k8u3m’
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});

Lembramos que os parâmetros indicados neste documento precisam ter valores válidos, caso necessite de algum parâmetro específico entrar em contato.