¿Cómo integras tus Leads a Pilot?

Para ingresar los datos de contactos o prospectos (en adelante lo llamaremos Lead para simplificar la lectura) producto de formularios completados en sitios de eCommerce como Mercado Libre, De Motores, Autofoco, etc; o en landings o campanas de mailing, Pilot® cuenta con mecanismos automáticos además de permitir la carga manual de los datos vía la interfaz de la aplicación.

Cada "lead" ingresado en Pilot® tiene que cumplir con una determinada estructura de parámetros, los cuales no son todos requeridos:

Nuestra documentación explica las nociones básicas del uso de llamadas Web/HTTP y Pilot® 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.

IMPORTANTE: cualquier respuesta que no sea status 200 HTTP es un error.

Cada llamada exitosa a la API retorna un mensaje en formato JSON con información de la ejecución del servicio o los errores del mismo. Ejemplo devolución en caso de error:

                                    
                                    {
                                        "success":valor boolean - true o false,
                                        "message":mensaje del resultado,
                                        "data":detalle del error
                                    }

                                    Ejemplo: 

                                    {
                                        "success":false,
                                        "message":"Error",
                                        "data":"El parametro requerido appkey no fue seteado"
                                    }

                                    
                        

Ejemplo de devolución en caso de ejecución correcta:

                        
                        {
                            "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 indica que se inserto en la base correctamente,
                                "id": identificador del dato dado de alta. Es un valor numerico
                            }
                        }

                        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
                            }
                        }
                        
                        

Código de Ejemplo llamada PHP Curl

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.com.ar/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 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;
}
?>

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 datos consignados son a modo de ejemplo para que se entienda el contenido.

                <?xml version="1.0" encoding="UTF-8"?>
                <?adf version="1.0"?>
                <adf>
                <prospect>
                   <requestdate>2013-06-27 11:26:24</requestdate>
                   <vehicle>
                        <brand>PEUGEOT</brand>
                        <model>207</model>
                    </vehicle>
                    <customer>
                        <contact>
                            <name part="full">nombre complete del prospecto</name>
                            <name part="first">nombre</name>
                            <name part="last">apellido</name>
                            <email>mail@domionio.com</email>
                            <phone>1147899000</phone>
                            <cellphone>1160403456</cellphone>
                            <address>
                                <city>Cuidad Autónoma de Buenos Aires</city>
                                <province>Buenos Aires</province>
                                <country>Argentina</country>
                                
                            </address>
                        </contact>
                        
                        <comments>
                            <![CDATA["Estoy interesado en comprar un Ford Fiesta"]]>
                        </comments>
                        
                    </customer>
                    <vendor>
                        <contact>
                            <name part="full"></name>
                            <email></email>
                            <phone></phone>
                        </contact>
                    </vendor>
                    <provider>
                        <name>proveedor de datos</name>
                        <service>Landing Venta Ford Fiesta</service>
                        <notification_email></notification_email >
                        <debug>0</debug>
                    </provider>
                </prospect>
                <format>
                    <formtype>pilot</formtype>
                    <formversion>1</formversion>
                    <key></key>
                </format>
            </adf>

                

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: <make></make>

Descripción de los parámetros del proveedor del Lead.

                <?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&aacute;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;

                    }


                ?>