Documentación
¿Cómo habilito el complemento?
Después de comprar Hello Bonsai Integration for Gravity Forms, deberá instalar el complemento en su sitio web de WordPress. Veamos ese proceso.
Paso 1: Instalación
Inicia sesión en tu sitio web de WordPress y ve a Plugins → Añadir plugin → Subir plugin → Instala el archivo zip y actívalo.
Paso 2: Registrar el complemento
Navegue a Formularios → Configuración → Hello Bonsai y haga clic Activar licencia en la sección Licencia. Ingrese su clave de licencia y actívela.
Paso 3: Conecta tu cuenta de Hello Bonsai
En su cuenta de Hello Bonsai, vaya a Configuración → Mi cuenta → Integraciones → API de Bonsai (nueva) y crea una clave API (comienza con bonsai_at_De vuelta en WordPress, péguelo en la sección Conexión de Hello Bonsai y haga clic en Guardar configuración: la clave se verifica con Hello Bonsai y la cuenta se agrega en un solo paso.
Paso 4: Crear un feed
Abre el formulario del que quieres capturar clientes potenciales, ve a Configuración → pestaña Hello Bonsai y añade una fuente de datos. Asigna los campos Nombre y Correo electrónico, y activa las secciones Empresa y Oportunidad si lo deseas. ¡Listo! El siguiente envío llegará a Hello Bonsai.
Detalles de la característica
¿Qué se crea en Hello Bonsai?
Cada feed ejecuta una cadena de hasta cuatro pasos en cada envío:
- Empresa (opcional) – coincide por dominio y/o nombre, o se crea cuando no hay ninguna coincidencia.
- Contacto (siempre) – encontrado por correo electrónico exacto y actualizado, o creado y vinculado a la empresa.
- Trato (opcional) – se abre en la etapa del embudo de ventas que haya elegido, se le asigna un valor y se adjunta al contacto y a la empresa.
- Comentario (opcional) – la presentación publicada en el nuevo acuerdo como constancia escrita.
Si un paso posterior no se puede completar, los pasos anteriores aún cuentan; la entrada se marca parcialmente sincronizado Con una explicación sencilla y clara de qué paso requiere atención, Re-send retoma la tarea donde la dejó.
Los campos de contacto que mapea
- Nombre (obligatorio) – Los campos de nombre de Gravity Forms se unen automáticamente (Nombre + Apellido).
- Correo electrónico (obligatorio) – la clave única Hello Bonsai hace coincidir los contactos por.
- Título profesional
- Número de teléfono
Estos son los campos que la API de Hello Bonsai acepta actualmente para un contacto. A medida que Hello Bonsai amplíe su API (los campos personalizados están entre sus planes), este complemento crecerá con ella.
Si el contacto ya existe, Puedes elegir el comportamiento para cada feed: actualizar el contacto existente con los valores enviados (opción predeterminada) o dejarlo sin cambios. En cualquier caso, el envío se vincula al contacto existente; nunca se crea un duplicado y un campo opcional en blanco nunca sobrescribe los datos reales en Hello Bonsai.
Emparejamiento de empresas
Hello Bonsai trata los dominios web como únicos en tu cuenta (un dominio solo puede pertenecer a una empresa), lo que hace que la coincidencia de dominios sea extremadamente fiable. La sección Empresa de cada feed te ofrece tres modos de coincidencia:
- Dominio, luego nombre de la empresa (predeterminado) – primero intenta con el dominio, y si no funciona, recurre a una coincidencia exacta del nombre (sin distinción entre mayúsculas y minúsculas).
- Solo dominio
- Solo el nombre de la empresa
Mapea un campo de sitio web/dominio y el complemento normaliza lo que escriban los visitantes. https://www.acme.com/contact se convierte acme.com antes de la coincidencia. Si no se asigna ningún campo de dominio, el dominio del contacto dirección de correo electrónico Se utiliza automáticamente y se ignoran los proveedores de correo electrónico gratuitos (gmail.com, outlook.com, yahoo.com, icloud.com y muchos más) para que nunca termines con una empresa llamada “Gmail”. Los desarrolladores pueden ajustar la lista de proveedores gratuitos con un filtro.
Cuando nada coincide, Puedes elegir por cada feed: crear la empresa (opción predeterminada) u omitirla. Las empresas creadas se nombran a partir del campo Nombre de la empresa asignado, o a partir de su dominio cuando no se ha introducido ningún nombre; esta es la misma convención que utiliza Hello Bonsai.
Al seleccionar una empresa existente, esta nunca se modifica. Y cuando un contacto existente envía información a una empresa con la que aún no está vinculado, el complemento crea el vínculo sin cambiar el contacto principal de la empresa, algo que la API de Hello Bonsai hace sorprendentemente complicado, y que ahora se gestiona automáticamente.
Ofertas
Activa la sección de Oportunidades y cada cliente potencial capturado podrá abrir una oportunidad en tu tablero de Hello Bonsai. Hello Bonsai requiere que cada oportunidad pertenezca a una empresa, por lo que la sección de Empresas debe estar habilitada y configurada. Tanto el editor de feeds como los resultados de las entradas lo indican claramente si no lo está.
- Título del trato – admite etiquetas de combinación de Gravity Forms, por ejemplo.
Website lead – {Name:1}. Por defecto, se utiliza el título del formulario. - Valor de la transacción – Asigne cualquier campo de formulario que contenga una cantidad en dólares. Los campos de producto reconocen la moneda (el precio, no la etiqueta), y los campos numéricos también funcionan perfectamente.
- Etapa de la canalización – Un selector en tiempo real de las etapas de tu tablero de ofertas, extraído de tu cuenta de Hello Bonsai. Por defecto, se selecciona la primera etapa.
- Asignar a – no asignado, el miembro de la cuenta conectada o cualquier miembro activo del equipo (también se obtiene en tiempo real).
- Crear un trato – en cada envío, o solo cuando el contacto es nuevo. La segunda opción evita que los clientes recurrentes acumulen acuerdos duplicados.
Comentarios sobre el acuerdo
Habilite la opción de comentarios y el complemento publicará la solicitud en el trato recién creado; la plantilla predeterminada es {form_title} seguido de {all_fields}, Además, puedes personalizarlo con cualquier etiqueta de combinación. Quien acepte el trato en Hello Bonsai verá la consulta completa sin salir del tablero de tratos. (Los comentarios de Hello Bonsai son texto plano; Hello Bonsai elimina el formato).
Resultados de la inscripción y reenvío
Cada participante recibe un Hola Bonsai En el recuadro de su página de detalles se muestra exactamente lo que sucedió:
- Sincronizado – Todos los pasos solicitados se han completado.
- Parcialmente sincronizado – El contacto es seguro en Hello Bonsai, pero un paso posterior (empresa, acuerdo o comentario) requiere atención. El mensaje explica exactamente cuál y por qué.
- Falló la sincronización – No se pudo escribir nada; el mensaje incluye el propio error de Hello Bonsai.
Los ID de contacto, empresa y trato creados son: Enlaces clicables directamente a tu cuenta de Hello Bonsai, y el ID de solicitud de Hello Bonsai se muestra para cualquier conversación de soporte.
El Reenviar a Hello Bonsai El botón reintenta de forma segura una sincronización fallida o parcial: las empresas y los contactos vuelven a coincidir en lugar de duplicarse, un acuerdo ya creado nunca se vuelve a crear y un comentario ya publicado nunca se publica dos veces. También funciona con entradas anteriores al complemento: abra cualquier entrada antigua y haga clic. Enviar a Hello Bonsai para rellenarlo.
Etiquetas de combinación
{bonsai_contact_id} – el ID de contacto de Hello Bonsai vinculado a esta entrada.
{bonsai_company_id} – el ID de la empresa Hello Bonsai vinculado a esta entrada.
{bonsai_deal_id} – El ID de la oferta de Hello Bonsai se abrió para esta entrada.
Úselas en notificaciones, confirmaciones y cargas útiles de webhook. Los feeds se procesan de forma síncrona durante el envío, por lo que los ID ya están resueltos cuando Gravity Forms envía las notificaciones del mismo envío; no hay condiciones de carrera. Las etiquetas para los registros que no se crearon (por ejemplo, si no se llegó a un acuerdo con un remitente recurrente) simplemente aparecen vacías.
Varias cuentas
Las agencias y los equipos multimarca pueden conectar más de una cuenta de Hello Bonsai. Cada cuenta se verifica al añadirla, aparece en una tabla de Cuentas conectadas con opciones para probarla y eliminarla, y cada feed elige a qué cuenta enviar los datos; se utiliza una cuenta predeterminada si el feed no especifica ninguna. Las credenciales se almacenan en el servidor, en la base de datos de WordPress, y no se vuelven a mostrar en la página después de guardarlas.
Notificaciones de error y resincronización
Notificaciones de error Añade una dirección de correo electrónico en Formularios → Configuración → Hello Bonsai → Informes de errores y recibirás un correo electrónico cada vez que la sincronización falle o se complete parcialmente. El correo incluirá el feed, el mensaje de resultado exacto, el ID de solicitud de Hello Bonsai y un enlace directo a la entrada para que puedas investigar y reenviarla con solo dos clics.
Resincronización de edición de entradas – Opcionalmente, se pueden volver a ejecutar las fuentes de datos de un formulario cuando se edita una entrada en el panel de administración de WordPress, para que el contacto y la empresa de Hello Bonsai vinculados reflejen los valores corregidos. Nunca se crean dos oportunidades de venta para la misma entrada, independientemente de cuántas veces se sincronice.
Preguntas frecuentes
¿Dónde puedo obtener una clave API de Hello Bonsai?
En tu cuenta de Hello Bonsai, en Configuración → API, crea una clave API – comienza con bonsai_at_. Pégalo en la página de configuración del plugin y se verificará y guardará en un solo paso. Cualquier cuenta de Hello Bonsai que pueda crear una clave API allí funciona con este plugin.
¿Por qué no se creó un acuerdo para mi propuesta?
Hello Bonsai requiere que cada transacción pertenezca a una empresa, por lo que la sección de Empresas del feed debe estar habilitada y debe coincidir con una o crearse una. El recuadro de Hello Bonsai de la entrada indica con precisión qué sucedió en cada paso: si se omitió la empresa o no se pudo resolver la transacción, el mensaje de la transacción lo indica claramente.
¿Qué ocurre cuando la misma persona realiza la solicitud dos veces?
El plugin encuentra el contacto existente por correo electrónico; nunca se crea ningún duplicado. Para cada feed, usted elige si el envío actualiza los datos del contacto o los deja sin cambios, y si abre otra oportunidad de negocio o solo abre oportunidades en el primer contacto. Las empresas vuelven a emparejar de la misma manera.
¿Puedo publicar entradas que se enviaron antes de instalar el complemento?
Sí. Abra cualquier entrada y haga clic. Enviar a Hello Bonsai en el cuadro Hello Bonsai. Compara las fuentes del formulario con esa entrada con protección total contra duplicados, por lo que rellenar datos antiguos es seguro incluso si algunas de esas personas ya están en tu Hello Bonsai.
¿Puedo asignar campos personalizados o enviar cargas de archivos?
Todavía no: la API pública de Hello Bonsai no admite campos personalizados, archivos adjuntos ni webhooks. El plugin mapea todo lo que la API acepta actualmente, y a medida que Hello Bonsai amplíe la API, también lo hará este plugin. Mientras tanto, la opción deal-comment es una excelente manera de que la persona encargada de gestionar el cliente potencial vea la solicitud completa (con todos los campos).
¿Solo puedo enviar ciertas propuestas a Hello Bonsai?
Sí, todas las fuentes de datos admiten la lógica condicional de Gravity Forms ("Enviar a Hello Bonsai si..."), por lo que puedes restringir la sincronización a cualquier campo: solo presupuestos que cumplan los requisitos, solo ciertas selecciones de servicio, solo correos que no sean spam, lo que mejor se adapte a tu formulario.
¿Qué datos salen de mi sitio web?
Solo se envían los valores que especifiques en el feed (además de la plantilla de comentarios, si está habilitada) directamente a la API oficial de Hello Bonsai mediante HTTPS. No se envía nada a terceros, y no se envía nada en absoluto a menos que se cumplan las condiciones del feed.
¿Es compatible con el almacenamiento en caché/CDN y la optimización de scripts?
Sí, sin necesidad de configuración. Toda la sincronización se realiza en el servidor al enviar el formulario; no hay scripts en el front-end, por lo que no hay nada que excluir de los complementos de almacenamiento en caché, minificación o aplazamiento.
¿Funciona con Gravity Forms habilitado para AJAX?
Sí. Funciona con Formularios AJAX y envíos estándar (no AJAX) de Gravity Forms.
¿Qué ocurre si Hello Bonsai funciona lento o no está disponible durante el envío de un formulario?
Tu visitante está protegido: el plugin reintenta brevemente los fallos transitorios, pero limita el tiempo total que tardará en completarse un envío (40 segundos por defecto, ajustable mediante un filtro) para que una API lenta nunca bloquee tu formulario. Cualquier intento fallido se registra como fallido o incompleto en la entrada; si has configurado un correo electrónico de notificación de errores, recibirás una notificación. Un solo clic en «Reenviar» finaliza el proceso una vez que Hello Bonsai vuelva a estar operativo.
¿Es compatible con una red WordPress Multisite?
Sí. Cada subdominio conecta su propia cuenta (o cuentas) de Hello Bonsai y configura sus propios feeds; al desinstalarlo, se eliminan todos los datos de la red. Con una licencia ilimitada, el modo de red permite distribuir una única clave de licencia a todos los subdominios en un solo lote.
¿Está listo para la traducción?
Sí, cada cadena es traducible. Puedes usar la versión gratuita. Plugin Loco Translate para crear una traducción para el idioma/localización de tu sitio. Si nunca has usado Loco Translate antes, aquí tienes un tutorial apto para principiantes.
Manos
Filtros
pb_gfhellobonsai_contact_payload
Filtra el cuerpo del mensaje antes de enviarlo a Hello Bonsai: ajusta el nombre, el correo electrónico, el cargo o el número de teléfono antes de enviarlo.
Parámetros:
$contact_body(formación) – Los campos de contacto con formato (nombre, correo electrónico, cargo, número de teléfono).$feed(formación) – El feed de Gravity Forms.$entry(formación) – La entrada actual.$form(formación) – La forma actual.
// 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
Filtre la información de la empresa antes de crearla: ajuste el nombre o los dominios.
Parámetros:
$body(formación) – Los campos de la empresa (nombre, dominios).$feed(formación) – El feed de Gravity Forms.$entry(formación) – La entrada actual.$form(formación) – La forma actual.
// 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
Filtre el cuerpo del acuerdo antes de enviarlo: ajuste el título, el valor, la etapa o el responsable mediante programación.
Parámetros:
$deal(formación) – Los campos del acuerdo (título, ID de la empresa, ID del contacto, ID del grupo de la junta, ID del miembro asignado, valor del acuerdo).$feed(formación) – El feed de Gravity Forms.$entry(formación) – La entrada actual.$form(formación) – La forma actual.
// 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 la lista de dominios de correo gratuito excluidos de la coincidencia de empresas basada en correo electrónico (gmail.com, outlook.com, yahoo.com, icloud.com y docenas más por defecto).
Parámetros:
$free_domains(formación) – Dominios en minúsculas que se deben excluir.
// 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 la URL de la aplicación Hello Bonsai utilizada para el enlace de un registro sincronizado en el cuadro de entrada. Devuelve una cadena vacía para mostrar un ID simple sin enlace.
Parámetros:
$url(cadena) – La URL predeterminada de la aplicación para el registro.$type(cadena) – Uno de contacto, empresa, trato.$id(int) – El ID del registro de Hello Bonsai.
pb_gfhellobonsai_run_time_budget
Ajusta el tiempo de espera (en segundos) que comparte cada solicitud de Hello Bonsai en una misma ejecución del feed. Los feeds se procesan de forma síncrona durante el envío, por lo que este es el límite máximo de tiempo que una API degradada puede retener a tu visitante. El valor predeterminado es 40.
Parámetros:
$seconds(flotar) – El presupuesto en segundos. Valor predeterminado: 40.
// Tighten the budget on high-traffic sites.
add_filter( 'pb_gfhellobonsai_run_time_budget', function( $seconds ) {
return 20.0;
} );pb_gfhellobonsai_runtime_allowed
Anula la restricción de licencia para el procesamiento de feeds. Útil principalmente en entornos de desarrollo y pruebas.
Parámetros:
$allowed(booleano) – Si la licencia permite actualmente el procesamiento de piensos.
pb_gfhellobonsai_api_base_url
Sobrescribe la URL base de la API de Hello Bonsai. Solo es útil para el desarrollo y las pruebas con una API simulada; nunca la necesitarás en producción.
Parámetros:
$url(cadena) – La URL base de la API. Predeterminadohttps://app.hellobonsai.com/public-api/v1.
English
العربية
বাংলা
Deutsch
Español
Español de México
Français
हिन्दी
Bahasa Indonesia
Italiano
Português
Русский
اردو
简体中文