Documentazione
Come faccio ad abilitare il plugin?
Dopo aver acquistato l'integrazione Hello Bonsai per Gravity Forms, dovrai installare il plugin sul tuo sito web WordPress. Vediamo insieme come fare.
Passaggio 1Installazione
Accedi al tuo sito web WordPress e vai su Plugin → Aggiungi plugin → Carica plugin → Installa il file zip e attivalo.
Fase 2: Registra il plugin
Vai su Moduli → Impostazioni → Hello Bonsai e fai clic Attiva licenza Nella sezione Licenza, inserisci il tuo codice di licenza e attivalo.
Passaggio 3: Collega il tuo account Hello Bonsai
Nel tuo account Hello Bonsai, vai a Impostazioni → Il mio account → Integrazioni → API per bonsai (nuova) e creare una chiave API (inizia con bonsai_at_Tornate su WordPress, incollate il codice nella sezione "Hello Bonsai Connection" e fate clic su "Salva impostazioni": la chiave verrà verificata con Hello Bonsai e l'account verrà aggiunto in un solo passaggio.
Passo 4: Crea un feed
Apri il modulo da cui desideri acquisire i contatti, vai alla scheda Impostazioni → Hello Bonsai e aggiungi un feed. Associa i campi Nome ed Email, quindi attiva le sezioni Azienda e Trattativa se le desideri. Ecco fatto: il prossimo invio arriverà in Hello Bonsai.
Dettagli della funzione
Cosa viene creato in Hello Bonsai
Ogni feed esegue una sequenza di fino a quattro passaggi per ogni invio:
- Azienda (facoltativo) – corrisponde per dominio e/o nome, oppure viene creato quando non si trova alcuna corrispondenza.
- Contatto (sempre) – trovato tramite e-mail esatta e aggiornato, oppure creato e collegato all'azienda.
- Affare (facoltativo) – aperto nella fase della pipeline selezionata, assegnato, valutato e collegato al contatto e all'azienda.
- Commento (facoltativo) – la presentazione è stata pubblicata sul nuovo accordo come documentazione.
Se una fase successiva non può essere completata, le fasi precedenti contano comunque: la voce viene contrassegnata parzialmente sincronizzato con una spiegazione chiara e semplice di quale passaggio richiede attenzione, e la funzione "Invia di nuovo" riprende da dove si era interrotta.
Campi di contatto mappa
- Nome (obbligatorio) – I campi Nome di Gravity Forms vengono uniti automaticamente (Nome + Cognome).
- Email (obbligatorio) – la chiave univoca Hello Bonsai abbina i contatti tramite.
- Titolo professionale
- Numero di telefono
Questi sono i campi che l'API di Hello Bonsai accetta attualmente per un contatto. Man mano che Hello Bonsai amplierà la sua API (i campi personalizzati sono tra i loro obiettivi), questo plugin crescerà di conseguenza.
Se il contatto esiste già, Puoi scegliere il comportamento per ogni feed: aggiornare il contatto esistente con i valori inviati (impostazione predefinita) oppure lasciarlo invariato. In entrambi i casi, l'invio è collegato al contatto esistente: non viene mai creato alcun duplicato e un campo facoltativo vuoto non sovrascrive mai i dati reali in Hello Bonsai.
Abbinamento aziendale
Hello Bonsai considera i domini web univoci all'interno del tuo account (un dominio può appartenere a una sola azienda), il che rende l'abbinamento dei domini estremamente affidabile. La sezione Azienda di ogni feed offre tre modalità di abbinamento:
- Dominio, quindi nome dell'azienda (predefinito) – prova prima il dominio, altrimenti utilizza una corrispondenza esatta del nome (senza distinzione tra maiuscole e minuscole).
- Solo dominio
- Solo il nome dell'azienda
Mappa un campo Sito Web/Dominio e il plugin normalizza qualsiasi cosa digitino i visitatori – https://www.acme.com/contact diventa acme.com prima della corrispondenza. Se non viene mappato alcun campo dominio, viene utilizzato il dominio del contatto. indirizzo e-mail Viene utilizzato automaticamente e i provider di posta elettronica gratuiti (gmail.com, outlook.com, yahoo.com, icloud.com e molti altri) vengono ignorati, in modo da non ritrovarsi mai con un account "Gmail". Gli sviluppatori possono personalizzare l'elenco dei provider gratuiti tramite un filtro.
Quando non c'è corrispondenza, Per ogni feed, puoi scegliere se creare l'azienda (impostazione predefinita) o saltare questo passaggio. Le aziende create vengono denominate in base al campo "Nome azienda" mappato, oppure in base al loro dominio se non è stato specificato alcun nome, secondo la stessa convenzione utilizzata da Hello Bonsai.
L'abbinamento a un'azienda esistente non comporta mai modifiche. E quando un contatto esistente invia un modulo con un'azienda a cui non è ancora collegato, il plugin crea il collegamento senza modificare il contatto principale dell'azienda: un'operazione che l'API di Hello Bonsai rende sorprendentemente complessa, ma che viene gestita automaticamente per te.
Offerte
Attiva la sezione "Offerte" e ogni lead acquisito potrà aprire un'offerta sulla tua bacheca delle offerte di Hello Bonsai. Hello Bonsai richiede che ogni offerta appartenga a un'azienda, quindi la sezione "Azienda" deve essere abilitata e risolta: sia l'editor del feed che i risultati dell'inserimento lo specificano chiaramente se non lo è.
- Titolo di guida – supporta i tag di unione di Gravity Forms, ad esempio.
Website lead – {Name:1}. Il valore predefinito è il titolo del modulo. - Valore della transazione – mappa qualsiasi campo del modulo che contenga un importo in dollari. I campi prodotto vengono letti tenendo conto della valuta (il prezzo, non l'etichetta) e anche i campi numerici funzionano benissimo.
- Fase di pipeline – uno strumento di selezione in tempo reale delle fasi attuali della tua trattativa, prelevate dal tuo account Hello Bonsai. Il metodo predefinito è la prima fase.
- Assegna a – non assegnato, membro dell'account connesso o qualsiasi membro attivo del team (anche prelevato in tempo reale).
- Creare un accordo – ad ogni invio, oppure solo quando il contatto è nuovo. La seconda opzione impedisce ai clienti abituali di accumulare contratti duplicati.
commenti sull'accordo
Abilita l'opzione di commento e il plugin pubblica l'invio sull'accordo appena creato: il modello predefinito è {form_title} seguito da {all_fields}, e puoi personalizzarlo con qualsiasi tag di unione. Chiunque prenda in carico l'offerta in Hello Bonsai visualizza la richiesta completa senza uscire dalla bacheca delle offerte. (I commenti di Hello Bonsai sono in testo semplice; la formattazione viene rimossa da Hello Bonsai.)
Risultati dell'iscrizione e nuovo invio
Ogni voce riceve un Ciao Bonsai riquadro nella pagina dei dettagli che mostra esattamente cosa è successo:
- Sincronizzato – ogni passaggio richiesto è stato completato.
- Sincronizzato parzialmente – Il contatto è al sicuro su Hello Bonsai, ma un passaggio successivo (azienda, trattativa o commento) richiede attenzione. Il messaggio specifica esattamente di cosa si tratta e perché.
- Sincronizzazione non riuscita – non è stato possibile scrivere nulla; il messaggio include l'errore di Hello Bonsai.
Gli ID di contatto, azienda e trattativa creati sono link cliccabili che accedono direttamente al tuo account Hello Bonsai, e l'ID della richiesta di Hello Bonsai viene visualizzato per qualsiasi conversazione di supporto.
Il Reinvia a Hello Bonsai Il pulsante riprova una sincronizzazione non riuscita o parziale in modo sicuro: aziende e contatti vengono riassociati invece di essere duplicati, un affare già creato non viene mai ricreato e un commento già pubblicato non viene mai pubblicato due volte. Funziona anche sulle voci precedenti al plugin: apri una voce precedente e fai clic Invia a Hello Bonsai per riempirlo.
Tag di unione
{bonsai_contact_id} – l'ID di contatto di Hello Bonsai collegato a questa voce.
{bonsai_company_id} – l'ID aziendale di Hello Bonsai collegato a questa voce.
{bonsai_deal_id} – L'ID dell'offerta Hello Bonsai è stato aperto per questa voce.
Utilizzali nelle notifiche, nelle conferme e nei payload dei webhook. I feed vengono elaborati in modo sincrono durante l'invio, quindi gli ID sono già risolti quando Gravity Forms invia le notifiche relative allo stesso invio, evitando così condizioni di competizione. I tag per i record non creati (ad esempio, nessun accordo per un invio ripetuto) vengono semplicemente inviati vuoti.
Account multipli
Agenzie e team multimarca possono collegare più di un account Hello Bonsai. Ogni account viene verificato al momento dell'aggiunta, elencato in una tabella "Account collegati" con opzioni di test e rimozione, e ogni feed sceglie a quale account inviare i dati, con un account predefinito utilizzato quando il feed non ne specifica uno. Le credenziali vengono memorizzate lato server nel database di WordPress e non vengono mai visualizzate nuovamente nella pagina dopo il salvataggio.
Notifiche di errore e risincronizzazione
Notifiche di errore – Aggiungi un indirizzo email in Moduli → Impostazioni → Hello Bonsai → Segnalazione errori e riceverai un'email ogni volta che una sincronizzazione fallisce o riesce solo parzialmente. L'email include il feed, il messaggio di risultato esatto, l'ID della richiesta di Hello Bonsai e un link diretto alla voce in modo da poter indagare e inviare nuovamente in due clic.
Risincronizzazione della modifica delle voci – Facoltativamente, riavvia i feed di un modulo quando una voce viene modificata nell'area di amministrazione di WordPress, in modo che il contatto e l'azienda di Hello Bonsai collegati acquisiscano i valori corretti. Non vengono mai create due volte delle trattative per la stessa voce, indipendentemente da quante volte venga eseguita la risincronizzazione.
Domande frequenti
Dove posso ottenere una chiave API di Hello Bonsai?
Nel tuo account Hello Bonsai sotto Impostazioni → API, crea una chiave API – inizia con bonsai_at_. Incollalo nella pagina delle impostazioni del plugin e verrà verificato e memorizzato in un solo passaggio. Qualsiasi account Hello Bonsai che possa creare una chiave API lì funziona con questo plugin.
Perché non è stato creato un accordo per la mia proposta?
Hello Bonsai richiede che ogni trattativa appartenga a un'azienda, quindi la sezione "Azienda" del feed deve essere abilitata e deve corrispondere a un'azienda esistente o crearne una. Il riquadro di Hello Bonsai nella voce indica esattamente cosa è successo in ogni fase: se l'azienda è stata saltata o non è stato possibile risolvere la trattativa, il messaggio lo specifica chiaramente.
Cosa succede quando la stessa persona invia due richieste?
Il plugin individua i contatti esistenti tramite e-mail, evitando la creazione di duplicati. Per ogni feed, è possibile scegliere se l'invio aggiorna i dettagli del contatto o li lascia invariati, e se genera una nuova opportunità di vendita o si limita al primo contatto. Le aziende gestiscono le corrispondenze successive allo stesso modo.
Posso inviare i dati che sono stati inseriti prima dell'installazione del plugin?
Sì. Apri una voce qualsiasi e fai clic Invia a Hello Bonsai nella casella Hello Bonsai. Esegue i feed del modulo su quella voce con protezione completa dai duplicati, quindi il riempimento è sicuro anche se alcune di quelle persone sono già nel tuo Hello Bonsai.
Posso mappare campi personalizzati o inviare file caricati?
Non ancora: l'API pubblica di Hello Bonsai al momento non supporta campi personalizzati, allegati o webhook. Il plugin mappa tutto ciò che l'API accetta attualmente e, man mano che Hello Bonsai amplierà l'API, anche questo plugin si aggiornerà. Nel frattempo, l'opzione di commento sull'offerta è un ottimo modo per mostrare la richiesta completa (con tutti i campi) a chi si occupa del potenziale cliente.
Posso inviare solo determinati tipi di materiale a Hello Bonsai?
Sì, ogni feed supporta la logica condizionale di Gravity Forms ("Invia a Hello Bonsai se..."), quindi puoi impostare la sincronizzazione in base a qualsiasi campo: solo budget qualificati, solo determinate selezioni di servizi, solo contenuti non spam, o qualsiasi altra condizione adatta al tuo modulo.
Quali dati lasciano il mio sito?
Vengono inviati solo i valori che inserisci nel feed (più il modello di commento, se abilitato) direttamente all'API ufficiale di Hello Bonsai tramite HTTPS. Nulla viene inviato a terze parti e nulla viene inviato a meno che non vengano soddisfatte le condizioni del feed.
Funziona con la cache/CDN e l'ottimizzazione degli script?
Sì, senza bisogno di alcuna configurazione. Tutta la sincronizzazione avviene lato server al momento dell'invio del modulo: non ci sono script lato client, quindi non c'è nulla da escludere da plugin di caching, minificazione o differimento.
Funziona con Gravity Forms che supporta AJAX?
Sì. Funziona con moduli AJAX e gli invii standard (non AJAX) tramite Gravity Forms.
Cosa succede se Hello Bonsai è lento o irraggiungibile durante l'invio di una richiesta?
Il tuo visitatore è protetto: il plugin tenta brevemente di inviare nuovamente il modulo in caso di errori temporanei, ma limita il tempo totale impiegato per ogni invio (40 secondi per impostazione predefinita, regolabile tramite un filtro), in modo che un'API lenta non possa mai bloccare il modulo. Tutto ciò che non è stato possibile completare viene correttamente registrato nell'inserimento come fallito o parziale e, se hai impostato una notifica via email, ne verrai informato. Un solo clic su "Invia di nuovo" completerà l'operazione non appena Hello Bonsai sarà di nuovo funzionante.
Funziona con una rete WordPress Multisite?
Sì. Ogni sottosito collega il proprio account (o i propri account) Hello Bonsai e configura i propri feed; la disinstallazione elimina i dati dall'intera rete. Con una licenza Unlimited, la modalità Rete consente di distribuire un'unica chiave di licenza a tutti i sottositi in un'unica operazione.
È pronto per la traduzione?
Sì, ogni stringa è traducibile. Puoi usare gratuitamente Plugin Loco Translate per creare una traduzione per la lingua/localizzazione del tuo sito. Se non hai mai usato Loco Translate prima, ecco un tutorial adatto ai principianti.
Ganci
Filtri
pb_gfhellobonsai_contact_payload
Filtra il corpo del messaggio prima di inviarlo a Hello Bonsai: modifica nome, email, qualifica o numero di telefono prima di inviarlo.
Parametri:
$contact_body(vettore) – I campi di contatto preformattati (nome, email, qualifica, numero di telefono).$feed(vettore) – Il feed di Gravity Forms.$entry(vettore) – La voce corrente.$form(vettore) – La forma attuale.
// Title-case every contact name on its way into Hello Bonsai.
add_filter( 'pb_gfhellobonsai_contact_payload', function( $contact_body, $feed, $entry, $form ) {
if ( isset( $contact_body['name'] ) ) {
$contact_body['name'] = ucwords( strtolower( $contact_body['name'] ) );
}
return $contact_body;
}, 10, 4 );pb_gfhellobonsai_company_payload
Filtra la struttura societaria prima della creazione dell'azienda: modifica il nome o i domini.
Parametri:
$body(vettore) – I campi relativi all'azienda (nome, domini).$feed(vettore) – Il feed di Gravity Forms.$entry(vettore) – La voce corrente.$form(vettore) – La forma attuale.
// Prefix companies created from forms so they're easy to spot in Hello Bonsai.
add_filter( 'pb_gfhellobonsai_company_payload', function( $body, $feed, $entry, $form ) {
$body['name'] = 'Lead: ' . $body['name'];
return $body;
}, 10, 4 );pb_gfhellobonsai_deal_payload
Filtra il corpo della transazione prima dell'invio: modifica programmaticamente il titolo, il valore, la fase o l'assegnatario.
Parametri:
$deal(vettore) – I campi dell'accordo (titolo, company_id, contact_id, board_group_id, assignee_member_id, deal_value).$feed(vettore) – Il feed di Gravity Forms.$entry(vettore) – La voce corrente.$form(vettore) – La forma attuale.
// Route big-budget leads into a different pipeline stage.
add_filter( 'pb_gfhellobonsai_deal_payload', function( $deal, $feed, $entry, $form ) {
if ( isset( $deal['deal_value'] ) && (float) $deal['deal_value'] >= 10000 ) {
$deal['board_group_id'] = 'your-priority-stage-uuid';
}
return $deal;
}, 10, 4 );pb_gfhellobonsai_free_email_domains
Filtra l'elenco dei domini di posta elettronica gratuiti esclusi dalla corrispondenza aziendale basata sull'email (gmail.com, outlook.com, yahoo.com, icloud.com e decine di altri per impostazione predefinita).
Parametri:
$free_domains(vettore) – Domini in minuscolo da escludere.
// Also treat a local ISP's addresses as personal email.
add_filter( 'pb_gfhellobonsai_free_email_domains', function( $free_domains ) {
$free_domains[] = 'myisp.example';
return $free_domains;
} );pb_gfhellobonsai_record_url
Filtra l'URL dell'app Hello Bonsai utilizzato come link per un record sincronizzato nel campo di immissione. Restituisci una stringa vuota per visualizzare un ID semplice senza link.
Parametri:
$url(corda) – L'URL predefinito dell'app per il record.$type(corda) – Uno tra contatto, azienda, affare.$id(int) – L'ID del record di Hello Bonsai.
pb_gfhellobonsai_run_time_budget
Regola il budget di tempo (in secondi) condiviso da ogni richiesta Hello Bonsai in una singola esecuzione del feed. I feed vengono elaborati in modo sincrono durante l'invio, quindi questo rappresenta il limite massimo per la durata della connessione del visitatore in caso di prestazioni ridotte. Il valore predefinito è 40.
Parametri:
$seconds(galleggiante) – Il budget in secondi. Valore predefinito: 40.
// Tighten the budget on high-traffic sites.
add_filter( 'pb_gfhellobonsai_run_time_budget', function( $seconds ) {
return 20.0;
} );pb_gfhellobonsai_runtime_allowed
Ignora il controllo delle licenze di elaborazione dei feed. Utile soprattutto negli ambienti di staging e sviluppo.
Parametri:
$allowed(bool) – Se la lavorazione dei mangimi è attualmente consentita dalla licenza.
pb_gfhellobonsai_api_base_url
Sovrascrivi l'URL di base dell'API Hello Bonsai. Utile solo per lo sviluppo e i test con un'API di prova: non ne avrai mai bisogno in produzione.
Parametri:
$url(corda) – L'URL di base dell'API. Predefinitohttps://app.hellobonsai.com/public-api/v1.
English
العربية
বাংলা
Deutsch
Español
Español de México
Français
हिन्दी
Bahasa Indonesia
Italiano
Português
Русский
اردو
简体中文