Integrate rapidamente i lead che entrano nel vostro sito web o nella vostra landing. Potete scegliere due metodi: Webhook Consigliato per la sua velocità ed efficacia - Email: Da scegliere se non si ha esperienza di programmazione.
Integrare i contatti per creare sondaggi con la possibilità di utilizzare dati dinamici da altre operazioni di Pilot attraverso un webhook.
Nome | Se possibile, si ottiene dall'account che invia l'e-mail. | |
---|---|---|
Cognome | Cognome del Lead. | |
Secondo Cognome | Applicabile al secondo cognome o al cognome della madre. | |
Telefono | Telefono del Lead. | |
Mobile | Mobile del Lead. | |
Tipo di contatto | Mezzo tramite il quale la persona viene contattata e che può essere ad esempio: 1- Elettronico | 2- Telefonico | 3- Intervista. (Variano a seconda della configurazione dell'istanza). | |
Tipo di attività | Codice per identificare il tipo di attività da cui proviene il Lead. Ad esempio: (1) Convenzionale / 0km | (2) Usato | (3) Postvendita. (Variano a seconda della configurazione dell'istanza). | |
Note | Commenti o osservazioni lasciati dal lead nelle pagine in cui si registra. Nel caso di eCommerce come De Motores, De Autos, Autofoco, Autocosmos, ecc. inviano in questo parametro l'interesse della persona (veicolo/finanziamento/ecc.). | |
Origine | Gruppo che identifica la provenienza del Lead. Viene utilizzato solo nell'interfaccia grafica di Pilot Solution® e il suo uso è deprecato nelle interfacce automatiche. | |
Sub-origine | Identifica l'origine primaria del Lead. Si ottiene dall'elenco delle sotto-origini di ogni istanza cliente. Può essere consultato nel report delle tabelle del sistema chiamato "Origine dei dati". | |
Venditore Assegnato | Indica il fornitore a cui assegnare direttamente il Lead. Al momento questo parametro è utilizzato solo nell'interfaccia grafica di Pilot Solution®. | |
Marca | Marca del veicolo. | |
Modello | Modello di veicolo. | |
Fornitore di servizi | Nome del servizio che fornisce i dati. È un descrittore dell'origine. Permette di identificare il fornitore di servizi o il modello di instradamento nel caso in cui sia necessaria un'assegnazione dinamica a diversi gruppi di acquisizione. | |
Prodotto di interesse | Veicolo o prodotto per il quale il Lead ha avviato la ricerca. In caso di campo vuoto, questo campo viene completato con la marca e il modello del veicolo indicato. | |
Notifiche Opt In | Indica se il Lead accetta di ricevere le notifiche attraverso qualsiasi mezzo di contatto. | |
Pubblicità Opt In | Indica se il Lead accetta di ricevere materiale pubblicitario attraverso qualsiasi mezzo di contatto. | |
Via: | Nome della via dell'indirizzo del Lead. | |
Numero: | Numero civico via del protagonista. | |
Piano: | Piano dell'appartamento del Lead. | |
Appartamento: | Appartamento del Lead. | |
Codice postale: | Codice postale del Lead. | |
Data di nascita: | Data di nascita del Lead. | |
Genere: | Codice di genere del Lead. | |
parametri obbligatori |
La nostra documentazione spiega le basi dell'utilizzo delle chiamate Web/HTTP e di Pilot Solution® in particolare. Se non conoscete queste tecniche o non avete mai lavorato con le chiamate Web/HTTP, prendetevi un momento per farlo prima di iniziare il lavoro.
https://api.pilotsolution.net/webhooks/welcome.php
IMPORTANTE: Qualsiasi risposta diversa dallo stato HTTP 200 è un errore.
action |
Valore fisso "create". | |
---|---|---|
appkey |
Valore alfanumerico, ad es: 9715fc4b-17a8-4e56-ac7a-6deb5fd46u71 che può essere richiesto all'account di supporto di Pilot o ottenuto dalla configurazione di Pilot. | |
debug |
Codice numerico, flag, che consente di testare il servizio senza inserire il lead in Pilot Solution®. I valori possibili sono: 0 = nessun debug, il servizio viene eseguito in modalità normale. 1 = in modalità debug, il Lead non viene inserito in Pilot Solution®. Es: 0 (nessun debug). | |
notification_email |
Account di Email per ricevere una copia dei dati inseriti. | |
pilot_firstname |
Nome del Lead. | |
pilot_lastname |
Cognome del Lead. | |
pilot_second_lastname |
Secondo Cognome del Lead. | |
pilot_phone |
Telefono del Lead. | |
pilot_cellphone |
Mobile del Lead. | |
pilot_email |
E-mail del Lead. | |
pilot_contact_type_id |
Mezzo tramite il quale cui la persona viene contattata e che può essere ad esempio: 1- Elettronico | 2- Telefonico | 3- Intervista. |
|
pilot_business_type_id |
Codice per identificare il tipo di attività da cui proviene il Lead. Ad esempio: (1) Convenzionale / 0km | (2) Usato | (3) Postvendita. |
|
pilot_notes |
Commenti, osservazioni di interesse che l'"attore" aggiunge quando entra nel Lead. Nel caso di un eCommerce come De Motores, De Autos, Autofoco, Autocosmos, altri, si suggerisce di completarlo con l'interesse della persona (ad esempio: veicolo/finanziamento/ ... ). | |
pilot_origin_id |
Gruppo che identifica la provenienza del Lead. È utilizzato solo nell'interfaccia grafica di Pilot Solution® e il suo uso è deprecato nelle interfacce automatiche. | |
pilot_suborigin_id |
Codice che identifica l'origine primaria del Lead. Si ottiene dall'elenco delle sotto-origini dell'istanza di ciascun cliente e può essere consultato nel report delle tabelle del sistema chiamato "Origine dei dati" nel modulo di amministrazione. Ad esempio: 1 (Landing). | |
pilot_assigned_user |
Account utente pilota a cui si desidera assegnare i dati. In questo caso l'assegnazione manuale dei dati ha la precedenza sui gruppi di acquisizione dei dati, ad es. cuentausuario@dominio.com. | |
pilot_car_brand |
Marca del veicolo di interesse, ad es. Ford. | |
pilot_car_modelo |
Modello del veicolo di interesse, ad es. Fiesta. | |
pilot_city |
Città in cui si trovano i dati, ad es. Capital Federal. | |
pilot_province |
Provincia di ubicazione dei dati, ad es. Buenos Aires. | |
pilot_country |
Paese di ubicazione dei dati, ad es. Argentina. | |
pilot_vendor_name |
Nome del fornitore di dati. | |
pilot_vendor_email |
E-mail del fornitore di dati. | |
pilot_vendor_phone |
Telefono del fornitore dei dati. | |
pilot_provider_service |
Nome del servizio che fornisce i dati. È una descrizione dell'origine. Permette di identificare il fornitore del servizio o il modello di instradamento nel caso in cui sia necessaria un'assegnazione dinamica a diversi gruppi di acquisizione. | |
pilot_provider_url |
URL del servizio che ha raccolto i dati. | |
pilot_client_company |
Nome della società. | |
pilot_client_identity_document |
Carta d'identità del Lead. | |
pilot_tracking_id |
Codice di tracciamento: GUID o ID univoco che identifica il Lead alla fonte. | |
pilot_client_ip |
IP del Lead al momento dell'acquisizione. | |
pilot_best_contact_time |
Ore di contatto preferite dal Lead. | |
pilot_product_code |
Codice prodotto secondo il listino prezzi di Pilot. Questo fa sì che il sistema generi automaticamente un'offerta di interesse per il Lead. L'elenco dei prodotti può essere ottenuto dall'endpoint masters/read.php I prodotti e i codici possono variare di mese in mese a seconda della registrazione o della cancellazione di marchi e agenzie. |
|
pilot_product_of_interest |
Marca e Modello del veicolo di interesse del Lead. | |
pilot_notificacions_opt_in_consent_flag |
Indica se il Lead accetta di ricevere notifiche attraverso qualsiasi mezzo di contatto. I valori possibili sono: 0 = no; 1 = sì Valore predefinito: 0 (no). | |
pilot_publicity_opt_in_consent_flag |
Indica se il Lead accetta di ricevere materiale pubblicitario attraverso qualsiasi mezzo di contatto. I valori possibili sono: 0 = no; 1 = sì Valore predefinito: 0 (no). | |
N | pilot_address_street |
Nome della via dell'indirizzo del Lead. |
N | pilot_addresss_number |
Numerazione nella via del Lead. |
N | pilot_address_floor |
Piano dell'appartamento del Lead. Es: PA; 4. |
N | pilot_address_department |
Appartamento del Lead. Es: C. |
N | pilot_address_postal_code |
Codice postale del Lead. |
N | pilot_birth_date |
Data di nascita del Responsabile. È espressa come segue: GG/MM/AAAA. |
N | pilot_gender_code |
Codice di genere del Lead. Valore inserito nel Genere Master. |
|
||
OBBLIGATORIO |
||
N | Nuovo |
Ogni invocazione dell'API restituisce un messaggio JSON con informazioni sull'esecuzione.
Valori di ritorno::
{
"success":Indica se l'integrazione è riuscita o meno. I valori possibili sono: True - False ,
"message":Messaggio di testo che indica se la registrazione del Lead è riuscita o meno. Ad esempio: registrazione riuscita: "Il servizio di caricamento dei dati è andato a buon fine" / registrazione non riuscita: "Il parametro richiesto appkey non è stato impostato",
"data":Integrazione riuscita: visualizza tutti i dati integrati / Integrazione errata: descrive l'errore.
}
Risposta a una richiesta sbagliata - Esempio
{
"success":false,
"message":"Errore",
"data":"Il parametro appkey richiesto non è stato impostato."
}
Risposta a una richiesta sbagliata - Esempio
{
"success":valore boolean - true o false,
"message":messaggio di risultato,
"data":{
"message": risultato,
"assigned_user_id": id dell'utente Pilot assegnato. Se non viene assegnato, il tag non viene inviato,
"success":valore boolean - true o false indica che è stato inserito correttamente nella base,
"id": identificativo della voce di dati. È un valore numerico
}
}
Esempio:
{
"success":true,
"message":"Success",
"data":{
"message":"(3.2) Il servizio di caricamento dei dati è stato eseguito con successo.",
"assigned_user_id":80,
"success":true,
"id":8855
}
}
Copiate e incollate il codice seguente in un file con estensione .PHP
Quindi modificare i parametri di configurazione e provare un modulo con questa pagina come azione.
È inoltre possibile scaricare il codice di un modulo di esempio per aggiungere la creatività qui
<?php //VARIABILI DI CONFIGURAZIONE $serviceURL = "https://api.pilotsolution.net/webhooks/welcome.php"; $appKey = "qui la key dell'istanza corrispondente"; $tipoNegocio = "1"; $origendeldato = "7A2E4184"; $landing_link = "Landing Promo Mes"; //CATTUURA DI PARAMETRI che possono provenire da un modulo $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() ; // Aumentare i parametri per post o get function request($param, $required=true, $default="") { $result = $default; //vedo se il parametro POST è impostato. 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; } ?>
Il formato della mail è un ADF (information xml) che ha il seguente contenuto. In questo caso le informazioni che possono essere inviate nella mail sono più ampie e con più informazioni.
Formato della posta: preferibilmente testo semplice.
I parametri riportati in blu sono costanti e non devono essere modificati.
I parametri riportati in verde sono opzionali e servono ad ampliare le informazioni per il venditore.
I parametri riportati in rossoo sono le basi del messaggio e sono obbligatorie.
Se non vengono inviati dati, il tag deve essere segnalato come vuoto. In altre parole, il messaggio deve essere completo
Es:
<?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 = "Commento:".request("comentarios", $NO_REQUERIDO); $provider = "Nome del fornitore di dati"; $landing = "Tipo di modulo di contatto"; $linkLanding = "www.misitio.com/landing.php"; $provincia = request("region",$NO_REQUERIDO); $to = "..."; //questo conto è impostato in PILOT CRM $subject = "Nuovo contatto da ".$nombre; $cuerpoDelMail = armarCuerpoDelMail($nombre, $apellido, $telefono, $celular, $email, $modeloAuto, $comentarios, $landing, $linkLanding, $provincia, $provider); //qui è possibile utilizzare if (enviarElMail("mi_cuenta@mail.com", $to, $subject, $cuerpoDelMail)){ echo "La vostra richiesta è stata inviata con successo."; }else{ echo "Non è stato possibile inviare la richiesta. Si prega di riprovare più tardi."; } return true; } // Aumentare i parametri per post o get function request($param, $required=true, $default="") { $result = $default; //vedo se il parametro POST è impostato. if (isset($_POST[$param])) { if($_POST[$param]!="") { $result = $_POST[$param]; } else { if ($required) { throw new Exception("Il parametro richiesto ".$param." non è stato impostato"); } } } else if(isset($_GET[$param])) { if($_GET[$param]!="") { $result = $_GET[$param]; } else { if ($required) { throw new Exception("Il parametro richiesto ".$param." non è stato impostato"); } } } else { if ($required) { throw new Exception("Il parametro richiesto ".$param." non è stato impostato"); } } return $result; } //Funzionalità per l'invio di e-mail function enviarElMail($de, $para, $asunto, $cuerpodelmail) { //qui implementa la funzione di invio della posta disponibile sul server. } //Questa funzione restituisce il contenuto del corpo della posta con i valori già sostituiti. 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 di Sondaggio | Codice del tipo di Sondaggio. Definito dal cliente | Nome del contatto | È il nome del cliente da censire |
---|---|---|
Cognome del contatto | Cognome del cliente da censire | |
Telefono del contatto | Telefono fisso del cliente da censire. È necessario disporre di almeno un numero di telefono di contatto. | |
Ramo | Filiale di vendita, luogo di consegna o officina a cui sarà associato il sondaggio. | |
Veicolo | Marca, modello e versione del veicolo del cliente da rilevare. | |
Dominio | Numero di targa del veicolo del cliente da ispezionare. | |
Mobile del contatto | Numero di cellulare del cliente da intervistare. È necessario disporre di almeno un numero di telefono di contatto | |
Contatto e-mail | E-mail della persona da intervistare. | |
Data dell'evento | Nella vendita, può essere la data di consegna dell'auto, nel post-vendita la data di uscita dall'officina. | |
Voucher interno | Codice interno. Riferimento interno dell'operazione, ad esempio numero di ticket, ordine di riparazione, ecc. | |
Venditore | Nome del venditore. | |
Tipo di vendita | Tipo di operazione che genera il sondaggio: ad es. usato/convenzionale/ecc. | |
Amministrativo 1 | Nome dell'impiegato che ha assistito il cliente. | |
Consulente | Nome del consulente che ha assistito il cliente. | |
Meccanico d'officina | Meccanico assegnato alla riparazione principale post-vendita. | |
Posizione del veicolo | Identificatore del veicolo nel sistema di origine | |
Generico 1 | Spazio per ulteriori informazioni sull'indagine. | |
Generico 2 | Spazio per ulteriori informazioni sull'indagine. | |
Generico 3 | Spazio per ulteriori informazioni sull'indagine. | |
Generico 4 | Spazio per ulteriori informazioni sull'indagine. | |
Generico 5 | Spazio per ulteriori informazioni sull'indagine. | |
Data di inizio della gestione | Data della Prima Chiamata, data in cui si desidera iniziare a gestire l'indagine | |
Codice fiscale del veicolo | Numero di identificazione del veicolo. È composto da 17 caratteri alfanumerici. NOTA: NON È PRESENTE NEL MODULO DI INDAGINE. Scoprite se è obbligatorio o meno. | |
Utente sondaggista | Email dell'utente Pilota a cui verrà assegnato il sondaggio. | |
parametri obbligatori |
La nostra documentazione spiega le basi dell'utilizzo delle chiamate Web/HTTP e di Pilot Solution® in particolare. Se non conoscete queste tecniche o non avete mai lavorato con le chiamate Web/HTTP, prendetevi un momento per farlo prima di iniziare il lavoro.
https://api.pilotsolution.net/webhooks/survey.php
IMPORTANTE: Qualsiasi risposta diversa dallo stato HTTP 200 è un errore.
action |
Valore fisso "create". | |
---|---|---|
appkey |
Valore alfanumerico, ad esempio 9715fc4b-17a8-4e56-ac7a-6deb5fd46u71. ID istanza, che può essere richiesto all'account di supporto del Pilota o ottenuto dalla configurazione del Pilota in cui si desidera creare l'indagine. | |
surveytype |
Codice del tipo di indagine. Definito dal cliente | |
checkrepited |
Codice numerico, flag per indicare il comportamento in caso di sondaggi ripetuti. I valori possibili sono=0 non analizza se vengono inseriti sondaggi ripetuti e li crea tutti; 1 = analizza se ci sono sondaggi ripetuti e ne crea solo uno. Es: 0 (non analizza i sondaggi ripetuti). | |
identificador_lote_carga |
ID univoco utilizzato per identificare il caricamento in batch delle indagini da sistemi esterni. Di norma, viene codificato secondo i seguenti criteri: AAAAMMGGHHMMSS. I sistemi esterni si integrano in lotti. Ad esempio, i pass per l'officina per censire i clienti che si sono recati in officina. Vengono ottenuti ogni giorno (quelli del giorno precedente) e caricati in massa. | |
nome_contatto |
Nome del cliente da intervistare | cognome_contatto | Cognome del cliente da censire |
telefono_contatto | Numero di telefono fisso del cliente da censire. È necessario disporre di almeno un numero di telefono di contatto. | |
ramo | Luogo di consegna/Sede di vendita/Negozio. Recuperato dall'elenco delle filiali dell'istanza. Può essere consultato nel report delle tabelle del sistema denominato "Origine dei dati". | |
veicolo | Marca, modello e versione del veicolo del cliente da rilevare. | |
dominio | Numero di targa del veicolo del cliente da ispezionare. | |
contatto_mobile | Numero di cellulare del cliente da intervistare. È necessario disporre di almeno un numero di telefono di contatto. | |
contatto_email | Email della persona da intervistare. | |
data_evento | Nella vendita, può essere la data di consegna dell'auto, nel post-vendita la data di uscita dall'officina. | |
prova_interna | Codice interno. Riferimento interno dell'operazione, ad esempio numero di ticket, ordine di riparazione, ecc. | |
venditore | Nome del venditore. | |
tipo_di_vendita | Tipo di operazione che genera il sondaggio: ad es. usato/convenzionale/ecc. | |
Amministrativo1 | Nome dell'impiegato che ha assistito il cliente. | |
consulente | Nome del consulente che ha assistito il cliente. | |
officina_meccanica | Meccanico assegnato alla riparazione principale post-vendita. | |
posizione_veicolo | Identificatore del veicolo nel sistema di origine. | |
generico_1 | Spazio per ulteriori informazioni sull'indagine. | |
generico_2 | Spazio per ulteriori informazioni sull'indagine. | |
generico_3 | Spazio per ulteriori informazioni sull'indagine. | |
generico_4 | Spazio per ulteriori informazioni sull'indagine. | |
generico_5 | Spazio per ulteriori informazioni sull'indagine. | |
data_inizio_gestione | Data in cui si vuole iniziare a gestire l'indagine. | |
vin_vehiculo | Numero di identificazione del veicolo. È composto da 17 caratteri alfanumerici. | |
id_sale_pilot | ID numerico. Utilizzare PILOT INTERNO | |
user_name_sondaggista | Email dell'utente Pilot a cui verrà assegnato il sondaggio. | |
parametri obbligatori |
Ogni invocazione dell'API restituisce un messaggio JSON con informazioni sull'esecuzione.
Valores de Retorno:
{
"success":Indica se l'integrazione è riuscita o meno. I valori possibili sono: True - False ,
"message":Messaggio di testo che indica se la creazione dell'indagine è riuscita o meno. Ad esempio: registrazione riuscita: "L'indagine è stata creata con successo" / registrazione non riuscita: 'Parameter sucursal not set',
"data":Integrazione riuscita: visualizza tutti i dati integrati / Integrazione errata: descrive l'errore.
}