Home

Istruzioni per la configurazione del form per integrare le richieste in BcOk.it

per integrare le richieste dal sito del cliente in BcOk.it

Ver 1.5 – 07 / 07 / 2023

Crea un utente su BcOk:

Nella bacheca di WordPress di BcOk, crea un nuovo utente che riceva le richieste - Username: puoi mettere il nome del sito “miosito.com” - Email: puoi mettere una email reale o anche fittizia, non servirà. - Nome: metti sempre “sito” - Cognome: metti “miosito.com” - Password: copia la password suggerita e salvala da parte: ti servirà nei passi successivi!!! - Togli il check “Invia al nuovo utente un’email a proposito del suo account.”. Non vogliamo mandare nulla. - Ruolo: assegna il ruolo “API user”

Verifica di aver copiato da qualche parte la password suggerita, poi puoi cliccare su Salva

Aggiorna Zapier con il nuovo utente:

Entra in Zapier.com e aggiungi le credenziali dell’utente appena creato negli Zap “Riceve Richieste via email e le carica in BCOK” e “TEST Richieste via email e le carica in RequestBin” - Modifica lo step “Da username ricava password” aggiungendo una riga con - Campo 1: lo username che hai impostato in BcOk (“miosito.it”) - Campo 2: la password che hai impostato in BcOk - Salva e pubblica

Imposta il form sul sito

Il form del sito deve inviare una email all'indirizzo:

[email protected]

(anche in copia o copia nascosta).

Nel form deve essere inserito il codice che si trova di seguito. I testi in rosso devono essere sostituiti con i segnaposto dei campi "reali" del form che si vuole inviare. Nel caso che un campo non sia presente nel form (per esempio nel form non viene chiesta l'azienda di appartenenza) la riga relativa deve essere cancellata (proseguendo l'esempio: si cancella l'intera riga che contiene "company").

Anche se è preferibile che il form invii il messaggio contenente il codice di tracciamento con una email a sé stante, tuttavia questo non è obbligatorio. Il codice può essere anche inserito in calce all'email che già viene inviata dal sito. Resta indispensabile che almeno una copia dell'email sia spedita all'indirizzo sopra indicato

Codice da utilizzare

Copia e incolla questo codice nell'email del form e sostituisci i dati con i segnaposto del form:

<!-- bcok 
{ 
    "username":"username-bcok",
    "direct_to":"id della sede",
    "private_for":"id della sede",
    "title":"nominativo",
    "email":"email",
    "company":"azienda",
    "phone":"telefono",
    "services":"servizi richiesti", 
    "area":"zona-geografica", 
    "excerpt":"oggetto",
    "content":"messaggio", 
    "source":"fonte", 
    "extra":"Form: Chiedi preventivo",
    "status":"verificare"
} 
-->

Spiegazione del codice

Campo Spiegazione
"username":"username-bcok" Username in BcOk
"direct_to":"id della sede" Codice della sede (codice sede in BcOk o email sede in BcOk. Vedi sotto)
"private_for":"id della sede" Codice della sede (codice sede in BcOk. Vedi sotto)
"title":"nominativo" Il campo che contiene Nome e Cognome del richiedente
"email":"email" Il campo che contiene Email del richiedente
"company":"azienda" Azienda del richiedente
"phone":"telefono" Telefono del richiedente
"services":"servizi richiesti" Il campo che contiene i servizi richiesti.
"area":"zona-geografica" Il campo che contiene Zona richiesta (città, quartiere, ecc)
"excerpt":"oggetto" Il campo Oggetto del form
"content":"messaggio" Il campo Messaggio
"source":"fonte" Come ci ha conosciuto
"extra":"Form: Chiedi preventivo" Altre info non codificate (esempio il nome del form)
"status":"verificare" Se si tratta di sito privato indicare “spedita” o “da_spedire”. Se sito gestito da Ufficiarredati indicare “verificare”

Direct_to e Private_for

  • Usiamo direct_to con email o ID BcOk della sede per le richieste che partono da siti "generici" (come UA.it, Dom.com ecc) e devono andare direttamente alla sede senza intervento di operatorio sede centrale UA
  • Usiamo private_for con ID BcOk della sede (a differenza del precedente questo non funzona con l'email) per le richieste che partono da siti "privati", di proprietà esclusiva di una Sede e che devono andare solo a quella sede

Status

  • Verificare: quando la richiesta deve restare in attesa di un completamento/verifica da parte di un operatore sede centrale UA
  • Da_spedire: quando la richiesta ha un direct_to o private_for compilato e quando BcOk la riceve deve occuparsi di spedirla per email alla Sede
  • Spedita: quando la richiesta ha un direct_to o private_for compilato e quando BcOk la riceve deve limitarsi ad archiviarla ma non la spedisce per email (per esempio perché il sito di origine già si è occupato di mandare l'email)

Come testare il funzionamento

Per i TEST inviare a:

[email protected]

e verificare l’esito su:

https://requestbin.com/r/enfr80hbahaf/2F7XaU3T5Zb8gE7ZtHvIfF1oUE6

GDPR

(funzionalità non ancora implementata)

Per registrare i dati GDPR possiamo usare i campi aggiuntivi: https://contactform7.com/special-mail-tags/ e definire in BcOk nuovi custom fields per le Richieste in grado di accoglierli.