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:
- 0 Pendente
- 1 Em atendimento
- 2 Concluído
- 3 Contato futuro
- 4 Perdido
- 5 Cancelado
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.