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:
richieste.tmse2@zapiermail.com
(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_tocon 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_forcon 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_tooprivate_forcompilato e quando BcOk la riceve deve occuparsi di spedirla per email alla Sede - Spedita: quando la richiesta ha un
direct_tooprivate_forcompilato 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:
testrichieste.tmse2@zapiermail.com
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.