Configurazione ricezione LEAD tramite API REST

Configurazione ricezione LEAD tramite API REST

La procedura per ricevere le leads tramite API REST è la seguente:

​Mandare il file SWAGGER, in allegato(in fondo alla pagina), al tecnico sviluppatore delle API REST, colui che si occupa di creare il client di integrazione, indicandogli il dominio della vostra macchina: https://dominiodellaweb.web3.easycallcloud.com
Lato EASYCALL, l' autenticazione si realizza attraverso un "token". Il token si genera su Easy Call dalla sezione: 
1) Utenti
2) Nuovo Utente

3) Modifica utenti 
4) Aggiungi credenziali avanzate

5) Tipo: TOKEN
6) Genera Token Casuale

Il token generato è da comunicare ai vostri tecnici per le relative configurazioni API.


Per importare leads con le API REST si realizza una configurazione nella sezione ANAGRAFICHE -> Import API.

Si seleziona l'utenza con il token, il codice campagna esterno(deve essere il codice da comunicare ai vostri tecnici durante la configurazione per l'atterraggio leads e, se composto da più parole, separarle con uderscore _ e non con lo spazio, come da esempio) e la campagna EasyCall di destinazione dei leads.
Cliccare su AGGIUNGI

Per l'importazione delle leads possono essere utilizzati campi predefiniti e campi custom.
Il separatore tra campo e valore può essere il carattere ":" o "="
I campi predefiniti sono:
Nome  "Nome"
Cognome  "Cognome"
partita_iva  "partita_iva"
codice_fiscale  "codice_fiscale"
telefono  "telefono_fisso"
telefono_mobile  "telefono_mobile"
altro_telefono  "altro_telefono"
Email  "email"
altro  "altro"
personalizzato1  "Personalizzato1"
personalizzato2  "Personalizzato2"
Nazione  "Nazione"
regione  "Regione"
provincia  "provincia"
cap  "cap"
strada  "Strada"
comune  "comune"
Provincia  "provincia"
civico  "civico"
data_scadenza  "2030-06-30T20:00:00+02:00"
fax  "numero_fax"

I campi custom sono riconosciuti con la chiave configurata in EasyCall:
• note
• metratura
• tipo_immobile
• servizio_richiesto
• codice_promo

Per creare i campi custom è necessario realizzare il seguente procedimento:
Vai alla sezione:
1) Campagne Telefoniche
2) Lista Domande
3) NUOVA DOMANDA e riempi i dati richiesti come da screen.

La chiave va creata in minuscolo e senza caratteri speciali nè spazi:   !"£$/, etc. 

Esempio: chiave_nuova (con uderscore per unire), flagga "visibile in P.O." se hai bisogno che gli operatori la visualizzino nel pannello operatore, se non vuoi che la vedano, puoi anche non flaggarlo

La cosa più importante della creazione di queste chiave nella lista domande è che se crei una chiave per esempio:  chiave_nuova, quando la vai a creare nelle API per portare l'informazione, la chiave creata in EasyCall deve essere "replicata" nelle API ESATTAMENTE uguale a come è stata creata in EasyCall, per farla funzionare correttamente.
ESEMPIO: curl -v -X POST --header 'Content-Type: application/json' --header 'Authorization: Bearer <TOKEN>' https://dominiodellaweb.web3.easycallcloud.com/easycall/spring/lead --data-binary @lead.json

ALLEGATO FILE PER TECNICO SVILUPPATORE

    • Related Articles

    • Configurazione ricezione LEAD tramite E-MAIL

      La procedura per ricevere le leads tramite E-MAIL è la seguente: 1)Accertarsi che la email mittente sia censita in Utenti -> Modifica utente -> Email 2)Andare in Anagrafica -> Import API. 3)Configurare l'utenza Email, il codice campagna (UGUALE all' ...
    • COME INVIARE LEADS IN MODO AUTOMATICO AD EASYCALL

      Per inviare le Leads in modo automatico su EasyCall ci sono 2 strade: Tramite EMAIL: per la procedura più dettagliata clicca qui accertarsi che la email mittente sia censita in Utenti -> Modifica utente -> Email Andare in Anagrafica -> Import API. ...
    • COME EFFETTUARE ASCOLTO ATTIVO/PASSIVO LATO INBOUND TRAMITE MICROSIP

      Utilizzando un microsip correttamente configurato con un interno(1001,1002,1003...eccecc), digitare questi codici + interno dell'operatore(1001,1002,1003...eccecc) per effettuare l'ascolto: **31*INTERNO         digitando questo codice dal tastierino ...
    • Come creare una Campagna Inbound

      Per creare una campagna INBOUND è necessario utilizzare il dominio cloud (.ecc1) ed entrare nel pannello dall'amministratore. L'username del pannello dell'amministrazione .ecc1 è sempre la mail utilizzata durante la registrazione alla pagina web ...
    • Come INSTALLARE il MICROSIP ed impostare l'interno per l'INBOUND

      Per il download: https://www.microsip.org/downloads Per la configurazione dell'interno: 1) Clicca su IN LINEA in basso a sinistra con il tasto destro del mouse e, al menu a tendina, cliccare su AGGIUNGI ACCOUNT: 3) Andare su EasyCall --> PANNELLO ...