Leads Api
Las operaciones que podemos realizar en el API de Leads tienen la siguiente ruta base
https://api-leads.qa.vmas.com.pe
La autenticacion es a traves de Basic Autentication
Usuario : usr_test
Clave : rdsf31
Registra un nuevo lead en base de datos, la ruta del api es :
Request body
Estructura de petición de registro
Examples
Ejemplo de lead
{
"aceptarPoliticas": "S",
"adCampaign": "Conversion+-+Stories+-+Landing+-+Promo149+0319",
"adContent": "cpospromo-fimagen-d290319",
"adSource": "facebook",
"adTerm": "Leads+VendeMas+no+convertidos",
"apellidos": "Perez",
"celular": "999999999",
"ciudad": "Lima",
"dataSource": "LandingVendeMas",
"descripcion": "Registro de prueba",
"dni": "12345678",
"email": "correo@gmail.com",
"fechaLead": "25/05/19 02:09PM",
"idCanal": "1",
"ip": "127.0.0.1",
"nombres": "Jose",
"recibirNovedades": "S",
"ruc": "10123456781",
"tipoDocPersona": "DNI",
"tipoPersona": "N",
"tipoProducto": "2",
"variante": "Vendemás GIF TARJETAS"
"nroCuenta": "2233423422",
"nombreBanco": "Interbank",
"nombreEjecutivo": "Miguel Salazar",
"nroTransaccion": "3242345231"
}Responses
Ejecución completa.
Body
Estructura de respuesta de registro
Examples
Lead registrado satisfactoriamente
{
"id": "32378",
"message": "Registrado en BD"
}No permitido.
Body
Credenciales no válias
Registra la conversión del lead a [S] en caso se haya realizado y además registra los intentos de conversión (llamadas), la ruta del api es :
Request body
Estructura de petición de conversión
Examples
Llamada no contestada
{
"idLead": "122341",
"fechaHoraLlamada": "05/02/2021 14:06",
"flagContestado": "N",
"flagConversion": "N",
"idDescripcion": "29"
}Llamada contestada con flagConversion de “NO CONVIRTIÓ”
{
"idLead": "122341",
"fechaHoraLlamada": "05/02/2021 14:06",
"flagContestado": "S",
"flagConversion": "N",
"idDescripcion": "13"
}Llamada contestado con flagConversion de “POSPUSO”
{
"idLead": "122341",
"fechaHoraLlamada": "05/02/2021 14:06",
"flagContestado": "N",
"flagConversion": "p",
"idDescripcion": "30"
}Llamada contestada con flagConversion de “SI”
{
"idLead": "122341",
"fechaHoraLlamada": "05/02/2021 14:06",
"flagContestado": "S",
"flagConversion": "S",
"idDescripcion": "2"
}Llamada de lead que no corresponde
{
"idLead": "122341",
"fechaHoraLlamada": "05/02/2021 14:06",
"flagContestado": "S",
"flagConversion": "Y",
"idDescripcion": "33"
}Responses
Ejecución completa.
Body
Estructura de respuesta de conversión
Examples
Llamada no contestada
{
"id": "619",
"message": "Llamada no contestada"
}Llamada contestada con flagConversion de “NO CONVIRTIÓ”
{
"id": "619",
"message": "Llamada Contestada - Lead rechazó la conversión"
}Llamada contestado con flagConversion de “POSPUSO”
{
"id": "619",
"message": "Llamada Contestada - Lead pospuso la conversión"
}Llamada contestada con flagConversion de “SI”
{
"id": "619",
"message": "Llamada Contestada - Lead se convirtió en Cliente"
}Llamada con flag de conversión “No corresponde”
{
"id": "130",
"message": "Llamada Contestada - Lead no corresponde"
}No permitido.
Body
Credenciales incorrectas
Estructura principal de un Lead
Decide aceptar politicas
SI
NO
Campaña
Contenido del Lead
Fuente del Lead
Terminos del Lead
Apellidos del Lead
Celular del Lead
Ciudad del Lead
DataSource del Lead
Descripción del Lead
Número de Documento de Identidad del Lead
Email del Lead
Fecha del Lead
Identificador del medio por donde viene el lead, si no se especifica al registrar tomara el valor del medio principal indicado por Vendemas, para el desarrollo usar “idCanal” : 1
Manya-Masivo
Attach-Masivo
Attach-Corporativo
Attach-Genérico
Attach-Banco
Cleverclick
Facebook Lead Ad
CPGoogle
LeadGenLinkedin
Dirección IP del Lead
Nombres del Lead
Decide recibir novedades
SI
NO
RUC del lead
Tipo de documento de la persona :DNI,CE
Documento Nacional de Identidad de Perú
Carnet de Extranjeria
Tipo persona
Natural
Empresa
Productos vendidos por Vendemás
Poket
Poket Pro
Vendemás Full
Variante del Lead
Nro de cuenta bancaria
Nombre del banco
Nombre del ejecutivo
Numero de transaccion
Estructura principal de la Conversión
Código del Lead en la base de datos de VendeMás
Fecha y hora de la llamada realizada al lead, debe ser enviada con el siguiente formato: dd/MM/yyyy HH:mm, las horas en formato 24 horas, en caso sea nulo o vacio se registra la fecha y hora del sistema.
Indicador si el lead contesto la llamada telefónica, puede tomar los valores:
SI
NO
Indicador si se realizó la conversión del lead, puede tomar los valores
Si el lead se convirtió en cliente
Cuando el lead no acepto la conversión
Cuando el lead acepta la llamada pero pospone la conversión
No Corresponde
Descripcion de la tipificacion
Poket
Poket Pro
Vendemas Full
Pago Link
Pago Web
Pago App
Pos
Pago Programado
QR Niubiz
Otros Productos
Productos Digitales
Cliente volver a llamar / evalua costo
Cliente solo desea informacion/beneficios
Afiliado por otro canal
Desconfianza en el producto
Desconfianza en el medio de pago
Solicita prestamo vendemas
Equipo a menor precio en redes
Condiciones tecnicas
Sin cobertura delivery
RUC Inactivo / Sin ruc / sin dni / sin negocio
Consulta con tercero
Cliente lo comprará en tienda fisica
Contratará con otra empresa
Se afiliará por web
Desea poket en dolares
Tiene producto Izipay
No responde
No contactó sistema
Teléfono no existe
Cliente no quiere que lo llamen
Cliente no ingresó a pagina web
Prueba/otros
Estructura de la respuesta de registro de conversion
Código de la respuesta, sera el id de lead en la base de datos de VendeMas en caso de que el registro se haga correctamente, o -1 si no se pudo actualizar el lead
Descripcion del resultado de la operacion