Integra los leads que ingresan a tu web o landing rápidamente. Puedes elegir dos métodos: Webhook Recomendado por su rapidez y efectividad - Email: Elegilo si no tienes experiencia en programación.
Integra contactos para crear encuentas con la posibilidad de usar datos dinámicos de otras operaciones Pilot a través de un webhook.
Nombre | Se obtiene de la cuenta que envía el mail si es posible. | |
---|---|---|
Apellido | Apellido del Lead. | |
Segundo Apellido | Aplicable para segundos apellidos o apellidos maternos. | |
Teléfono | Teléfono del Lead. | |
Móvil | Móvil del Lead. | |
Tipo de Contacto | Medio por el cual se contacta la persona y puede ser por ejemplo: 1- Electrónico | 2- Telefónico | 3- Entrevista. (Varían de acuerdo a la configuración de la instancia). | |
Tipo de negocio | Código para identificar cuál es el tipo de negocio del que proviene el Lead. Por ejemplo: (1) Convencional / 0km | (2) Usados | (3) Plan de Ahorro. (Varían de acuerdo a la configuración de la instancia). | |
Notas | Comentarios u observaciones que deja el Lead en las páginas donde se registra. En el caso de los eCommerce como De Motores, De Autos, Autofoco, Autocosmos, etc., envían en este parámetro el interés de la persona (vehículo/financiación/etc). | |
Origen | Agrupador que identifica de dónde se obtiene el Lead. Solo se usa en la interfaz gráfica de Pilot Solution®, y su uso está deprecado en las interfaces automáticas. | |
Suborigen | Identifica el origen primario del Lead. Se obtiene de la lista de los suborígenes de la instancia de cada cliente. Se puede consultar en el informe de las tablas del sistema llamado “Origen de los datos”. | |
Vendedor Asignado | Indica el vendedor al cual asignar el Lead directamente. Por el momento este parámetro solo se usa en la interfaz gráfica de Pilot Solution®. | |
Marca | Marca del vehículo. | |
Modelo | Modelo del vehículo. | |
Proveedor de servicios | Nombre del servicio que provee el dato. Es un descriptivo del origen. Permite identificar al proveedor del servicio o al patrón de ruteo en caso de necesitar asignaciones dinámicas a diferentes grupos de captura. | |
Producto de interés | Vehículo o producto por el que el Lead inició la consulta. En el caso de ingresar vacío este campo se completa con la marca y el modelo del vehículo indicado. | |
Opt In Notificaciones | Indica si el Lead acepta recibir notificaciones a través de cualquier medio de contacto. | |
Opt In Publicitario | Indica si el Lead acepta recibir material publicitario a través de cualquier medio de contacto. | |
Calle: | Nombre de la calle de la dirección del Lead. | |
Número: | Numeración en la calle del Lead. | |
Piso: | Piso del departamento del Lead. | |
Departamento: | Departamento del Lead. | |
Código Postal: | Código postal del Lead. | |
Fecha de Nacimiento: | Fecha de nacimiento del Lead. | |
Género: | Código del género del Lead. | |
parámetros obligatorios |
Nuestra documentación explica las nociones básicas del uso de llamadas Web/HTTP y Pilot Solution® en particular. Si Ud. no está familiarizado con estas técnicas o no ha trabajado antes con llamadas Web/HTTP, por favor tome un momento para hacerlo antes de comenzar con el trabajo.
https://api.pilotsolution.net/webhooks/welcome.php
IMPORTANTE: cualquier respuesta que no sea status 200 HTTP es un error.
action |
Valor fijo "create". | |
---|---|---|
appkey |
Valor alfanumérico ej: 9715fc4b-17a8-4e56-ac7a-6deb5fd46u71 que se puede solicitar a la cuenta de soporte de Pilot u obtenerlo de la configuración de Pilot. | |
debug |
Código numérico, flag, que permite testear el servicio sin ingresar el Lead en Pilot Solution®. Sus valores posibles son: 0 = no debug, se ejecuta el servicio en modo normal. 1 = en modo debug, no se ingresa el Lead en Pilot Solution®. Ej: 0 (no debug). | |
notification_email |
Cuenta de mail para recibir una copia del dato ingresado. | |
pilot_firstname |
Nombre del Lead. | |
pilot_lastname |
Apellido del Lead. | |
pilot_second_lastname |
Segundo Apellido del Lead. | |
pilot_phone |
Teléfono fijo del Lead. | |
pilot_cellphone |
Teléfono móvil del Lead. | |
pilot_email |
E-mail del Lead. | |
pilot_contact_type_id |
Medio por el cual se contacta a la persona y puede ser y puede ser por ejemplo: 1- Electrónico | 2- Telefónico | 3- Entrevista. |
|
pilot_business_type_id |
Canal de venta: (1) Convencional / 0km | (2) Usados | (3) Plan de Ahorro. |
|
pilot_notes |
Comentarios, observaciones de interés que el ‘actor’ agrega al momento de ingresar el Lead. En el caso de un eCommerce como De Motores, De Autos, Autofoco, Autocosmos, otros se sugiere completarlo con el interés de la persona (ej: vehículo/financiación/ ... ). | |
pilot_origin_id |
Agrupador que identifica de dónde se obtiene el Lead. Sólo se usa en la interfaz gráfica de Pilot Solution®, y su uso esta deprecado en las interfaces automáticas. | |
pilot_suborigin_id |
Código que identifica el origen primario del Lead. Se obtiene de la lista de los suborígenes de la instancia de cada cliente y se puede consultar en el informe de las tablas del sistema llamado "Origen de los datos" en el módulo de administración. Ej.: 1 (Landing). | |
pilot_assigned_user |
Cuenta de usuario de Pilot a la que se le quiere asignar el dato. En este caso la asignación manual del dato tiene prelación por sobre los grupos de captura de datos Ej: cuentausuario@dominio.com. | |
pilot_car_brand |
Marca del vehículo de interés Ej: Ford. | |
pilot_car_modelo |
Modelo del vehículo de interés Ej: Fiesta. | |
pilot_city |
Ciudad de ubicación del dato Ej: Capital Federal. | |
pilot_province |
Provincia de ubicación del dato Ej: Buenos Aires. | |
pilot_country |
País de ubicación del dato Ej: Argentina. | |
pilot_vendor_name |
Nombre del proveedor del dato. | |
pilot_vendor_email |
E-mail del proveedor del dato. | |
pilot_vendor_phone |
Teléfono del proveedor del dato. | |
pilot_provider_service |
Nombre del servicio que provee el dato. Es un descriptivo del origen. Permite identificar el proveedor del servicio o el patrón de ruteo en caso de necesitar asignaciones dinámicas a diferentes grupos de captura. | |
pilot_provider_url |
URL del servicio que recolectó el dato. | |
pilot_client_company |
Nombre de la empresa. | |
pilot_client_identity_document |
Documento de Identidad del Lead. | |
pilot_tracking_id |
Código de seguimiento: GUID o ID único que identifica al Lead en el origen. | |
pilot_client_ip |
IP del Lead al momento de la captura. | |
pilot_best_contact_time |
Horario de contacto preferido por el Lead. | |
pilot_product_code |
Código de Producto según la lista de precios de Pilot. Esto hace que el sistema genere automáticamente una oferta de interés para el Lead. La lista de productos se puede obtener del endpoint masters/read.php Los productos y códigos pueden variar de mes a mes según el alta o baja de las marcas y la agencia. |
|
pilot_product_of_interest |
Marca y Modelo del vehículo de interés del Lead. | |
pilot_notificacions_opt_in_consent_flag |
Indica si el Lead acepta recibir notificaciones a través de cualquier medio de contacto. Sus valores posibles son: 0 = no; 1 = si Valor por defecto: 0 (no). | |
pilot_publicity_opt_in_consent_flag |
Indica si el Lead acepta recibir material publicitario a través de cualquier medio de contacto. Sus valores posibles son: 0 = no; 1 = si Valor por defecto: 0 (no). | |
N | pilot_address_street |
Nombre de la calle de la dirección del Lead. |
N | pilot_addresss_number |
Numeración en la calle del Lead. |
N | pilot_address_floor |
Piso del departamento del Lead. Ej: PB; 4. |
N | pilot_address_department |
Departamento del Lead. Ej: C. |
N | pilot_address_postal_code |
Código postal del Lead. |
N | pilot_birth_date |
Fecha de nacimiento del Lead. Se expresa de la siguiente forma: DD/MM/AA. |
N | pilot_gender_code |
Código del género del Lead. Valor ingresado en el Maestro de Género. |
|
||
OBLIGATORIO |
||
N | Nuevo |
Cada invocación a la API retorna un mensaje en formato JSON con información de la ejecución de ésta.
Valores de Retorno:
{
"success":Indica si la integración fue exitosa o no. Sus valores posibles son: True - False ,
"message":Mensaje de texto que indica si el alta del Lead fue exitosa o no. Ej.: alta exitosa: 'El servicio de carga de datos se ejecuto correctamente' / alta errónea:'El parámetro requerido appkey no fue seteado' ,
"data":Integración Exitosa: Despliega cada uno de los datos integrados / Integración Erronea: Describe el error.
}
Respuesta para consulta errónea – Ejemplo
{
"success":false,
"message":"Error",
"data":"El parametro requerido appkey no fue seteado"
}
Respuesta para consulta errónea – Ejemplo
{
"success":valor boolean - true o false,
"message":mensaje del resultado,
"data":{
"message": resultado,
"assigned_user_id": id del usuario Pilot asignado. Si no se asigna el tag no es enviado,
"success":valor boolean - true o false que indica se insertó en la base correctamente,
"id": identificador del dato dado de alta. Es un valor numérico
}
}
Ejemplo:
{
"success":true,
"message":"Success",
"data":{
"message":"(3.2) El servicio de carga de datos se ejecuto correctamente.",
"assigned_user_id":80,
"success":true,
"id":8855
}
}
Copiar y pegar el siguiente código en un archivo con extensión .PHP
Luego modificar los parámetros de configuración y probar con un formulario que tenga como acción esta página.
También puedes bajar un ejemplo de código de formulario para agregar la creatividad aquí
<?php //VARIABLES DE CONFIGURACION $serviceURL = "https://api.pilotsolution.net/webhooks/welcome.php"; $appKey = "aqui la key de la instancia correspondiente"; $tipoNegocio = "1"; $origendeldato = "7A2E4184"; $landing_link = "Landing Promo Mes"; //CAPTURA DE PARÁMETROS que pueden venir de un formulario $encoded = ""; $encoded .= urlencode('action').'=create&'; $encoded .= urlencode('appkey').'='.urlencode($appKey).'&'; $encoded .= urlencode('pilot_firstname').'='.urlencode(request("nombre",false,"n/a")).'&'; $encoded .= urlencode('pilot_lastname').'='.urlencode(request("apellido",false,"")).'&';$encoded .= urlencode('pilot_phone').'='.urlencode(request("telefono",false,"n/a")).'&'; $encoded .= urlencode('pilot_cellphone').'='.urlencode(request("celular",false,"")).'&'; $encoded .= urlencode('pilot_email').'='.urlencode(request("email",false,"")).'&'; $encoded .= urlencode('pilot_contact_type_id').'='.urlencode('1').'&'; //electronico $encoded .= urlencode('pilot_business_type_id').'='.urlencode($tipoNegocio).'&'; $encoded .= urlencode('pilot_notes').'='.urlencode(request("comentarios",false,"Sin comentarios");).'&'; $encoded .= urlencode('pilot_suborigin_id').'='.urlencode($origendeldato).'&'; $encoded .= urlencode('pilot_provider_url').'='.urlencode($landing_link).'&'; $ch = curl_init($serviceURL); curl_setopt($ch, CURLOPT_FAILONERROR, true); curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true); curl_setopt($ch, CURLOPT_HEADER, 0); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, $encoded); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); $output = curl_exec($ch); curl_close($ch); echo $output; die() ; // Levanta los parámetros por post o get function request($param, $required=true, $default="") { $result = $default; //veo si esta seteado el parámetro POST if (isset($_POST[$param])) { if($_POST[$param]!="") { $result = $_POST[$param]; } else { if ($required) { throw new Exception("El parametro requerido ".$param." no fue seteado"); } } } else if(isset($_GET[$param])) { if($_GET[$param]!="") { $result = $_GET[$param]; } else { if ($required) { throw new Exception("El parametro requerido ".$param." no fue seteado"); } } } else { if ($required) { throw new Exception("El parametro requerido ".$param." no fue seteado"); } } return $result; } ?>
El formato del mail es un ADF (xml de información) que tiene el siguiente contenido. En este caso la información que se puede enviar en el mail es más amplia y con mayor información.
Formato del mail: preferentemente texto plano.
Los parámetros informados en azul son constantes y no deben cambiarse.
Los parámetros informados en verde son opcionales y sirven para ampliar la información para el vendedor
Los parámetros informados en rojo son los básicos del mensaje y son obligatorios
Si algún dato no se envía, el tag tiene que informarse en blanco. O sea, el mensaje debe ser completo
Ej:
<?php enviar_a_Pilot(); die(); function enviar_a_Pilot() { $REQUERIDO = true; $NO_REQUERIDO = false; $nombre = request("nombre",$REQUERIDO); $apellido = request("apellido", $NO_REQUERIDO); $telefono = request("telefono", $NO_REQUERIDO); $celular = request("celular", $NO_REQUERIDO); $email = request("email",$REQUERIDO); $modeloAuto = request("modelo",$NO_REQUERIDO); $comentarios = "Comentario:".request("comentarios", $NO_REQUERIDO); $provider = "Nombre del proveedor de datos"; $landing = "Formulario de Contacto Tipo"; $linkLanding = "www.misitio.com/landing.php"; $provincia = request("region",$NO_REQUERIDO); $to = "..."; //esta cuenta se configura en PILOT CRM $subject = "Nuevo conctacto de ".$nombre; $cuerpoDelMail = armarCuerpoDelMail($nombre, $apellido, $telefono, $celular, $email, $modeloAuto, $comentarios, $landing, $linkLanding, $provincia, $provider); //aqui se puede usar if (enviarElMail("mi_cuenta@mail.com", $to, $subject, $cuerpoDelMail)){ echo "Su consulta fue enviada satisfactoriamente."; }else{ echo "No hemos podido enviar su consulta. Intente más tarde por favor."; } return true; } // Levanta los parámetros por post o get function request($param, $required=true, $default="") { $result = $default; //veo si esta seteado el parametro POST if (isset($_POST[$param])) { if($_POST[$param]!="") { $result = $_POST[$param]; } else { if ($required) { throw new Exception("El parametro requerido ".$param." no fue seteado"); } } } else if(isset($_GET[$param])) { if($_GET[$param]!="") { $result = $_GET[$param]; } else { if ($required) { throw new Exception("El parametro requerido ".$param." no fue seteado"); } } } else { if ($required) { throw new Exception("El parametro requerido ".$param." no fue seteado"); } } return $result; } //Funcion para el envio de mails function enviarElMail($de, $para, $asunto, $cuerpodelmail) { //aqui implementar la funcion de envio de mail que se disponga en el servidor. } //Esta funcion retorna el contenido del cuerpo del mail con los valores ya reemplazados function armarCuerpoDelMail($nombre, $apellido, $telefono, $celular, $email, $modeloAuto, $comentarios, $landing, $linkLanding, $provincia, $provider) { $result = ' <?xml version="1.0" encoding="UTF-8"?> <?adf version="1.0"?> <adf> <prospect> <requestdate>'.date("Y-d-m H:i:s").'</requestdate> <vehicle> <id></id> <year></year> <make>RENAULT</make> <model>'.$modeloAuto.'</model> <vin></vin> <stock></stock> <trim></trim> <price type="asking"></price> </vehicle> <customer> <contact> <name part="full"></name> <name part="first">'.$nombre.'</name> <name part="last">'.$apellido.'</name> <email>'.$email.'</email> <phone>'.$telefono.'</phone> <cellphone>'.$celular.'</cellphone> <international_phone></international_phone> <address> <street></street> <city>'.$provincia.'</city> <regioncode></regioncode> <postalcode></postalcode> <country>Argentina</country> </address> </contact> <comments> <![CDATA["'.$comentarios.'"]]> </comments> </customer> <vendor> <vendorname></vendorname> <contact> <name part="full"></name> <email></email> <phone></phone> </contact> </vendor> <provider> <name>'.$provider.'</name> <service>'.$landing.'</service> <notification_email></notification_email > <debug>0</debug > <url><![CDATA["'.$linkLanding.']]></url> </provider> </prospect> <format> <formtype>pilot</formtype> <formversion>1</formversion> <key></key> </format> </adf>'; return $result; } ?>
Tipo de Encuesta | Código de Tipo de Encuesta. La define el Cliente. | Nombre del contacto | Es el nombre del cliente al que se realizará la encuesta. |
---|---|---|
Apellido del contacto | Apellido del cliente al que se realizará la encuesta. | |
Teléfono de contacto | Teléfono fijo del cliente a encuestar. Al menos debe tener un teléfono de contacto. | |
Sucursal | Sucursal de venta, locación de entrega o taller a la que se asociará la encuesta. | |
Vehículo | Marca, modelo y versión del vehículo del cliente a encuestar. | |
Dominio | Dominio o chapa patente del vehículo del cliente a encuestar. | |
Celular del contacto | Teléfono móvil del cliente a encuestar. Al menos debe tener un telefono de contacto. | |
Email del contacto | Email de la persona a encuestar. | |
Fecha del evento | En Ventas, puede ser la fecha de entrega del auto, en postventa la fecha de salida del taller. | |
Comprobante Interno | Código Interno. Referencia interna de la operación. Ej: Número de boleto, orden de reparación, etc. | |
Vendedor | Nombre del vendedor. | |
Tipo de Venta | Tipo de operación que genera la encuesta: Ej:Usados/Convencionales/etc. | |
Administrativo 1 | Nombre del administrativo que atendió al cliente. | |
Asesor | Nombre del asesor que atendió al cliente. | |
Mecánico del taller | Mecánico asignado a la reparación principal de post venta. | |
Posición del Vehículo | Identificador del Vehículo en el sistema origen. | |
Genérico 1 | Espacio para información adicional sobre la encuesta. | |
Genérico 2 | Espacio para información adicional sobre la encuesta. | |
Genérico 3 | Espacio para información adicional sobre la encuesta. | |
Genérico 4 | Espacio para información adicional sobre la encuesta. | |
Genérico 5 | Espacio para información adicional sobre la encuesta. | |
Fecha de inicio de gestión | Fecha del Primer Llamado, fecha en la que se quiere comenzar a gestionar la encuesta. | |
Vin del vehículo | Número de Identificación del Vehículo. Consta de 17 carácteres alfanuméricos. | |
Usuario encuestador | Email del usuario de Pilot al que se le asignará la encuesta. | |
parámetros obligatorios |
Nuestra documentación explica las nociones básicas del uso de llamadas Web/HTTP y Pilot Solution® en particular. Si Ud. no está familiarizado con estas técnicas o no ha trabajado antes con llamadas Web/HTTP, por favor tome un momento para hacerlo antes de comenzar con el trabajo.
https://api.pilotsolution.net/webhooks/survey.php
IMPORTANTE: cualquier respuesta que no sea status 200 HTTP es un error.
action |
Valor fijo "create". | |
---|---|---|
appkey |
Valor alfanumérico ej: 9715fc4b-17a8-4e56-ac7a-6deb5fd46u71. Identificador de la instancia, que se puede solicitar a la cuenta de soporte de Pilot u obtenerlo de la configuración de Pilot, en la que se desea crear la encuesta. | |
surveytype |
Código de Tipo de Encuesta. La define el Cliente. | |
checkrepited |
Código numérico, flag para indicar comportamiento con encuestas repetidas. Sus valores posibles son=0 no analiza si ingresan encuestas repetidas y crea a todas; 1 = analiza si hay encuestas repetidas y crea solo una de ellas. Ej: 0 (no analizar repetidas). | |
identificador_lote_carga |
ID Único que se usa para identificar la carga por lotes de las encuestas desde sistemas externos. Normalmente se codifica aplicando el siguiente criterio: YYYYMMDDHHMMSS. Los sistemas externos integran por lotes. Ej: Los pases de taller para encuestar a los clientes que fueron al taller. Se obtienen diariamente (los del día anterior) y se cargan masivamente. | |
nombre_contacto |
Nombre del cliente al que se realizará la encuesta. | apellido_contacto | Apellido del cliente al que se realizará la encuesta. |
telefono_contacto | Teléfono fijo del cliente a encuestar. Al menos debe tener un teléfono de contacto. | |
sucursal | Locación de entrega/Sucursal de venta/Taller. Se obtiene de la lista de sucursales de la instancia. Se puede consultar en el informe de las tablas del sistema llamado “Origen de los datos”. | |
vehiculo | Marca, modelo y versión del vehículo del cliente a encuestar. | |
dominio | Dominio o chapa patente del vehículo del cliente a encuestar. | |
celular_contacto | Teléfono móvil del cliente a encuestar. Al menos debe tener un telefono de contacto. | |
email_contacto | Email de la persona a encuestar. | |
fecha_evento | En Ventas, puede ser la fecha de entrega del auto, en postventa la fecha de salida del taller. | |
comprobante_interno | Código Interno. Referencia interna de la operacion. Ej: Numero de boleto, orden de reparacion, etc. | |
vendedor | Nombre del vendedor. | |
tipo_venta | Tipo de operación que genera la encuesta: Ej:Usados/Convencionales/etc. | |
Administrativo1 | Nombre del administrativo que atendió al cliente. | |
asesor | Nombre del asesor que atendió al cliente. | |
mecanico_taller | Mecánico asignado a la reparación principal de postventa. | |
posicion_vehiculo | Identificador del Vehículo en el sistema origen. | |
generico_1 | Espacio para información adicional sobre la encuesta. | |
generico_2 | Espacio para información adicional sobre la encuesta. | |
generico_3 | Espacio para información adicional sobre la encuesta. | |
generico_4 | Espacio para información adicional sobre la encuesta. | |
generico_5 | Espacio para información adicional sobre la encuesta. | |
fecha_inicio_gestion | Fecha en la que se quiere comenzar a gestionar la encuesta. | |
vin_vehiculo | Número de Identificación del Vehículo. Consta de 17 carácteres alfanuméricos. | |
id_venta_pilot | ID numérico. Uso INTERNO PILOT. | |
user_name_encuestador | Email del usuario de Pilot al que se le asignará la encuesta. | |
parámetros obligatorios |
Cada invocación a la API retorna un mensaje en formato JSON con información de la ejecución de ésta.
Valores de Retorno:
{
"success":Indica si la integración fue exitosa o no. Sus valores posibles son: True - False ,
"message":Mensaje de texto que indica si la creación de la encuesta fue exitosa o no. Ej.: alta exitosa: 'La encuesta se creo correctamente' / alta errónea:'Parameter sucursal not set' ,
"data":Integración Exitosa: Despliega cada uno de los datos integrados / Integración Erronea: Describe el error.
}