Integración de Salesforce para Gravity Forms

¿Cómo habilito el complemento?

Tras la compra, deberás instalar el plugin en tu sitio web de WordPress. Aquí te explicamos cómo.

Paso 1: Instalación

Inicia sesión en tu sitio de WordPress y navega a Plugins → Agregar plugin → Subir plugin. Sube el archivo zip y actívalo.

Paso 2: Registrar el plugin

En el menú de navegación de la izquierda, navegue hasta Formularios → Configuración → Salesforce. En el Licencia clic en la sección Gestionar licencia, Introduzca su clave de licencia y haga clic. Activar licencia.

Paso 3: Conectar Salesforce

Una vez que tenga la licencia, desplácese hasta el Conexión con Salesforce sección en la misma página de configuración (se titula Agregar cuenta de Salesforce una vez que exista una cuenta) y conecta tu primera cuenta de Salesforce (instrucciones completas a continuación)

¡Eso es todo! Ya puedes empezar a asignar formularios a Salesforce.

¿Cómo conecto una cuenta de Salesforce con OAuth?

Paso 1: Entienda los tipos de aplicaciones

En Salesforce, deberá crear una aplicación cliente externa (la opción moderna y la única disponible para las organizaciones nuevas creadas desde la versión Spring '26 de Salesforce) o una aplicación conectada (la opción anterior, que aún es compatible con las organizaciones existentes que lo permiten). El complemento funciona de forma idéntica con ambas.

En la configuración de Salesforce, navegue a una de las siguientes opciones:

• Configuración → Administrador de aplicaciones de cliente externo → Nueva aplicación para clientes externos (recomendado)

o aplicación conectada heredada (deshabilitada por defecto en organizaciones más recientes)

• Configuración → Administrador de aplicaciones → Nueva aplicación conectada

Antes de conectar: el usuario de Salesforce que autoriza la conexión necesita permisos de creación (y edición, para las fuentes que se actualizan) en cada objeto con el que se sincronizará. El complemento solo muestra los objetos que el usuario puede crear.

Paso 2: Crear una nueva aplicación cliente externa

NOTA: En las capturas de pantalla que aparecen a continuación, las opciones que no estén marcadas o estén vacías deben dejarse como están.

Después de iniciar sesión en Salesforce, en la parte superior derecha de la pantalla, haga clic en el icono de la rueda dentada:

En el lado izquierdo de la pantalla, en el cuadro de búsqueda que dice "Búsqueda rápida", busque "aplicación cliente externa" y luego seleccione "Administrador de aplicaciones cliente externas":

En el lado derecho de la pantalla, haga clic en el botón que dice "Nueva aplicación cliente externa":

En el apartado “Información básica”, introduzca lo siguiente:

• Nombre de la aplicación cliente externa (el nombre de la API se generará automáticamente, no lo modifique).
• Correo electrónico de contacto
• Deje el estado de distribución como “Local”.”

En “API (Habilitar configuración de OAuth)” haga lo siguiente:

• Habilitar OAuth
• Introduzca su URL de devolución de llamada (esta se encuentra en la configuración del plugin en Formularios > Configuración > Salesforce > URL de devolución de llamada de OAuth).
• En Ámbitos de OAuth, seleccione lo siguiente:
  • “Gestionar los datos de usuario mediante API (api)”
  • “Realizar solicitudes en cualquier momento (refresh_token, offline_access)”

No modifique la siguiente configuración:

Deje también sin modificar el resto de las configuraciones que aparecen a continuación:

Haz clic en crear aplicación y estarás listo para pasar al paso 3:

Paso 3: Editar las políticas de autorización de la aplicación

Una vez creada la aplicación, debemos editar las políticas de la aplicación. Haga clic de nuevo en "Administrador de aplicaciones de cliente externo".“

A continuación, selecciona la aplicación que acabas de crear y haz clic en el botón "Editar", como se muestra a continuación:

Luego, abre el menú desplegable "Políticas de OAuth" y configura la política de token de actualización para que caduque "después de un tiempo específico" y luego configúrala en 365 días o más. El complemento actualiza automáticamente el token de acceso temporal, pero una vez que el token de actualización caduca, Salesforce rechaza la conexión y debes volver a conectar la cuenta en Formularios → Configuración → Salesforce. Una política más larga implica que tendrás que hacerlo como máximo una vez al año en lugar de cada 30 días.

Recomendamos configurar un recordatorio para comprobar la conexión por si acaso.

Paso 4: Conectar la nueva aplicación cliente externa a Gravity Forms.

La configuración de Salesforce ya está completa; ahora necesitamos conectar Gravity Forms a la aplicación. En Salesforce, vuelve a "Administrador de aplicaciones de cliente externo" y selecciona tu aplicación.

Haz clic en “Configuración” y desplázate hacia abajo hasta “Configuración de OAuth” y ábrela. Verás un botón que dice “Clave y secreto del consumidor”; haz clic en ese botón.

Lo más probable es que aparezca una pantalla de verificación de identidad y que se te haya enviado un código. Introduce el código y haz clic en “Verificar”.”

Tras la verificación, verás la clave de consumidor y el secreto de consumidor. Mantén esa pestaña abierta y, en una nueva pestaña, ve a la configuración del plugin en Formularios > Configuración > Salesforce y añade esas claves como se muestra en la captura de pantalla a continuación. El botón aparecerá una vez que ambos campos estén completos: haz clic en Conectar cuenta (si ya tienes una cuenta conectada, aparecerá "Añadir cuenta").

Verás que Gravity Forms ya está conectado a Salesforce y podemos pasar al paso 5 (paso final):

Paso 5: Agregue un feed de Salesforce a su formulario.

Ve a la configuración del formulario de Gravity Forms que deseas conectar a Salesforce y agrega una nueva fuente de datos:

Y por último, configura los ajustes de tu feed como desees:

¡Listo! Si deseas conectar cuentas adicionales de Salesforce y crear feeds para otros formularios, repite los 5 pasos anteriores.

¿Cómo me conecto con Org ID? (Web-to-Lead / Web-to-Case)

Si su organización de Salesforce no tiene acceso a la API (algunas ediciones Essentials/Professional), puede recurrir al punto final Web-to-Lead/Web-to-Case anterior.

Paso 1: En Salesforce, encuentra tu ID de la organización bajo Configuración → Información de la empresa.

Paso 2: En WordPress, en la página de configuración de Salesforce, cambie el Método de conexión Seleccione "ID de organización (Web-to-Lead/Caso)" en el menú desplegable.

Paso 3: Pegue su ID de organización y haga clic. Guardar cuenta de ID de organización. A partir de la versión 1.5.0, lee los valores introducidos en el formulario, por lo que no es necesario guardar la configuración previamente.

Aviso: El modo ID de organización solo admite clientes potenciales y casos. Las actualizaciones, eliminaciones, cargas de archivos, el autocompletado y la asignación de listas desplegables requieren una cuenta OAuth.

¿Cómo configuro un feed?

Paso 1: Editar un formulario → Configuración del formulario → Salesforce → Agregar nuevo.

Paso 2: Elige el Cuenta de Salesforce, Objeto de Salesforce (Cliente potencial, Contacto, Cuenta, objeto personalizado…) y Modo de sincronización (el valor predeterminado, Crear o actualizar si existe un registro., (es correcto en la mayoría de los casos).

Paso 3: Asigna los campos de Gravity Forms a los campos de Salesforce. Los campos obligatorios de Salesforce están marcados con un asterisco para que no los pases por alto.

Paso 4 (opcional): Bajo Coincidencia de duplicados, garrapata Habilitar la coincidencia de duplicados de clave primaria para actualizar los registros existentes que coincidan con el correo electrónico, un ID externo o cualquier otro campo filtrable.

Paso 5 (opcional): Configure la lógica condicional, la comprobación de conflictos, la asignación de propietarios, la carga de archivos, las notas o la pertenencia a campañas.

Paso 6: Guarda la fuente y envía una entrada de prueba. Consulta la pantalla de detalles de la entrada en la barra lateral de Salesforce. Dado que la sincronización se ejecuta en segundo plano, es posible que veas brevemente el estado "Pendiente" en azul, seguido del ID del nuevo registro y un enlace directo al mismo en Salesforce.

¿Qué comportamientos de sincronización necesito activar?

La creación de registros funciona tan pronto como se guarda una fuente. Los comportamientos del ciclo de vida son opcionales, en Formularios → Configuración → Salesforce → Configuración de sincronización, y las cuatro están desactivadas hasta que las marques:

• Sincronizar las actualizaciones cuando se editan las entradas. Envía las ediciones de entrada al registro de Salesforce vinculado.
• Eliminar registros de Salesforce cuando las entradas se eliminen permanentemente. Elimina el registro cuando vacías la papelera. Mover una entrada a la papelera nunca afecta a Salesforce.
• Resincronizar los datos de entrada cuando se restauran entradas desde la papelera/spam. Guarda cualquier edición realizada mientras la entrada estaba en la papelera y crea un reemplazo si el registro se eliminó en Salesforce mientras tanto.
• Enviar notas de entrada de Gravity Forms a Salesforce como registros de notas. Refleja las notas que un administrador agrega a una entrada y elimina la copia de Salesforce cuando se elimina la nota.

Detalles de la característica

Métodos de conexión

El plugin admite dos formas de conectar Gravity Forms con Salesforce. Elija la que coincida con el nivel de acceso a la API de su organización.

• OAuth 2.0 con PKCE (recomendado). Autenticación moderna de Salesforce mediante una aplicación conectada o una aplicación cliente externa (el reemplazo de Spring '26+). No se almacenan claves API estáticas en el servidor; el complemento actualiza automáticamente los tokens de acceso y la conexión permanece activa indefinidamente siempre que la política de tokens de actualización de la aplicación no la haga expirar. Ámbitos requeridos: api y refresh_token / offline_access. Funciona con todas las ediciones de Salesforce que tienen acceso a la API (Enterprise, Unlimited, Performance, Developer o Professional con el complemento de acceso a la API).
• Conversión web a cliente potencial / Conversión web a caso (ID de organización). Punto final de envío heredado que utiliza únicamente el ID de tu organización de Salesforce. Útil para organizaciones sin acceso a la API (algunas ediciones Essentials y Professional). Limitaciones: Solo objetos Lead y Case; no se permiten actualizaciones, eliminaciones, cargas de archivos, precarga ni asignación de listas desplegables.

Ambos modos se pueden usar en el mismo sitio de WordPress. Puedes tener una cuenta OAuth para tu organización principal y una cuenta de ID de organización para una organización secundaria, y cada feed elige de forma independiente con cuál se sincroniza.

Soporte para múltiples cuentas

Conecta tantas cuentas de Salesforce como quieras a un sitio de WordPress. Configuraciones comunes:

• Entorno de pruebas y producción: prueba las fuentes de datos en el entorno de pruebas y, a continuación, cambia a producción con un simple cambio en un menú desplegable.
• AgenciaCada organización cliente obtiene su propia conexión; cada fuente elige con qué cliente se sincroniza.
• Matriz y subsidiarias: diferentes formularios se dirigen a diferentes organizaciones en su estructura corporativa.

Siempre hay una cuenta marcada como predeterminada, por lo que los sitios web sencillos no tienen que preocuparse por cuál usar. También funciona como respaldo: una fuente sin cuenta configurada, o cuya cuenta elimines posteriormente, se sincroniza con la cuenta predeterminada. Al eliminar una cuenta, se te avisará antes de que se aplique la acción, así que, si la organización predeterminada no es la correcta, redirige primero las fuentes afectadas a otra cuenta.

Cada cuenta también tiene su propio estado de conexión. El complemento registra cuándo se actualizó, se realizó correctamente y falló por última vez cada cuenta, y la lista de cuentas informa Conectada con una hora de última verificación, Necesita atención o Se requiere reconexión, por lo que una conexión rota es visible antes de que comiencen a fallar los envíos. Cada cuenta conserva la versión de la API de Salesforce con la que se conectó (las nuevas conexiones tienen por defecto v63.0Para actualizar una cuenta a una versión más reciente, elimine y vuelva a conectarla. Al eliminar una cuenta, se revocan sus tokens en Salesforce en lugar de simplemente eliminarlos localmente.

Objetos de Salesforce compatibles

Puedes sincronizar con cualquier objeto de Salesforce El usuario conectado puede acceder a objetos estándar o personalizados. El menú desplegable de objetos se genera dinámicamente a partir del esquema real de su organización, por lo que verá todos los objetos estándar que incluye Salesforce (Cuenta, Contacto, Cliente potencial, Oportunidad, Caso, Campaña, Tarea, Evento, Nota, Usuario y muchos más), además de todos los objetos personalizados que haya definido.

Para objetos personalizados, elija “Personalizado (escriba a continuación)” e ingrese el nombre de la API (por ejemplo, My_Object__cLos valores de las listas desplegables, las relaciones de búsqueda, los archivos adjuntos y el prellenado funcionan de la misma manera con los objetos personalizados que con los estándar.

Vinculación de registros entre diferentes fuentes de datos

Una sola presentación puede crear varios registros relacionados. Agregue una fuente por objeto y luego arrastre las filas de la lista de fuentes al orden que desee. Las fuentes se ejecutan en ese orden, una tras otra, en segundo plano. En una fuente posterior, asigne el campo de búsqueda (AccountId, ContactId o cualquier búsqueda personalizada) a Valor personalizado y entrar {salesforce_id:FEED_ID}, donde FEED_ID es el ID del feed anterior. La etiqueta se resuelve en el registro que el feed creó o actualizó para esta entrada, por lo que el nuevo registro está vinculado a él. El ID del feed es el fid= valor en la barra de direcciones mientras editas el feed.

Una cadena típica es primero una fuente de cuenta, luego una fuente de contacto con AccountId configurado en {salesforce_id:12} (siendo 12 el ID del feed de Cuenta), se crea un feed de Oportunidad con AccountId configurado de la misma manera. Utilice la misma cuenta de Salesforce en cada feed de la cadena, ya que un ID de registro solo existe en la organización que lo emitió. Si el feed anterior no creó ningún registro, porque su lógica condicional no coincidió o la comprobación de conflictos lo detuvo, la etiqueta queda vacía y la búsqueda permanece sin establecer en lugar de tomar el ID de otro feed.

Mapeo de listas desplegables a nivel de campo

Para los campos desplegables, de selección múltiple, de botón de opción y de casilla de verificación, puede obtener las opciones directamente de una lista desplegable de Salesforce en lugar de escribirlas manualmente. Dos modos por campo:

• Seleccionar opciones (editable) Copia los valores de la lista desplegable en el campo de Gravity Forms una sola vez. El administrador puede editar o eliminar opciones posteriormente. Ideal para quienes buscan un punto de partida, pero desean simplificar la lista.“
• Sincronización en tiempo real (siempre coincide con Salesforce) Actualiza las opciones en cada renderizado del formulario. Las opciones se bloquean en el editor de formularios para evitar desajustes. Utilice esta función cuando Salesforce sea la única fuente de información fiable (campos de estado, fuentes de clientes potenciales, listas desplegables de estado/país, etc.).

Las etiquetas de Salesforce se muestran a los usuarios del formulario; los valores de Salesforce se envían. Entonces el formulario muestra “California” pero la entrada se envía CA, exactamente lo que esperan las listas desplegables de estado/país de Salesforce, y no necesita una tabla de asignación.

El tipo de registro también es una lista desplegable aquí. Para cualquier objeto con tipos de registro seleccionables, el tipo de registro aparece junto a las listas desplegables reales en la misma interfaz de usuario de asignación de campos. El formulario muestra el nombre del tipo de registro a los usuarios (por ejemplo, "Donante"); el valor enviado es el ID del tipo de registro de Salesforce. Asigne ese campo a RecordTypeId en su feed y el tipo de registro elegido se establecerá en el registro creado o actualizado. Solo se muestran los tipos de registro que su usuario de Salesforce conectado puede asignar (se filtran el tipo maestro implícito y los tipos no disponibles), y se admiten los modos de Rellenar y Sincronización en vivo.

El menú desplegable de objetos de Salesforce en la barra lateral de asignación de campos fija los ocho objetos estándar más utilizados (Cuenta, Contacto, Cliente potencial, Oportunidad, Caso, Campaña, Tarea, Nota) en la parte superior de la lista, para que no tenga que desplazarse por todos los objetos personalizados de la organización para encontrarlos. En la pantalla de configuración de la fuente, cambie el objeto o la cuenta y la asignación de campos, los selectores de campos coincidentes y de objetos se recargan desde Salesforce de inmediato, sin necesidad de esperar a que se guarden.

Coincidencia de clave primaria (sin duplicados)

La mayoría de los administradores de Salesforce no quieren que cada envío de formulario cree un nuevo cliente potencial. Habilitar Coincidencia de clave primaria para actualizar los registros existentes cuando haya una coincidencia.

• Seleccione cualquier campo filtrable, idLookup o externalId como clave de coincidencia (Email es el más común).
• Si se encuentra un registro coincidente, se actualiza. De lo contrario, se crea un nuevo registro (cuando el Modo de sincronización está configurado en "Crear o actualizar si existe un registro").
• Utilice un ID externo personalizado (Customer_Reference__c) para la correspondencia entre sistemas.
• Protección integrada contra la condición de carrera "el registro coincidente se eliminó en Salesforce". Si Salesforce devuelve un error 404 para un ID almacenado, el complemento crea un nuevo registro de forma transparente.

Verificación de conflictos

La coincidencia de clave primaria actualiza un registro cuando encuentra uno. A veces, preferirías que se detuviera la fuente. verificación de conflictos Busca un registro existente en Salesforce antes de que la fuente de datos cree nada, y se detiene si encuentra alguno.

Mientras que la coincidencia de duplicados funciona con una sola clave, la comprobación de conflictos combina varios campos en una sola búsqueda. Si se asignan juntos el nombre y el apellido, se detectará a la misma persona enviando información con una dirección de correo electrónico diferente, algo que una coincidencia solo con el correo electrónico permitiría sin problemas. Cada fila asignada debe coincidir con el mismo registro para que la fuente de datos se detenga, por lo que una superposición parcial no la activa.

• Asigna tantos campos de Salesforce a campos de Gravity Forms como necesites, incluyendo valores personalizados.
• Configure su propio mensaje de error. Este se registra en la entrada y se envía en el correo electrónico de error, para que pueda saber por qué no se creó el registro.
• Solo se aplica cuando la fuente de datos crea un registro. Un registro encontrado por coincidencia de duplicados se actualiza normalmente.
• Por feed, y disponible en cuentas OAuth.

Carga de archivos

Los campos de carga de archivos de Gravity Forms se pueden adjuntar al registro de Salesforce como Versión del contenido / Enlace al documento del contenido, de modo que aparezcan en la lista relacionada Archivos del registro. Tamaño máximo de archivo configurable, de 1 a 25 MB por archivo, con un valor predeterminado de 10.

Para adjuntar archivos, asigne cada campo de Carga de archivos al Archivos: adjuntar al registro de Salesforce Fila en el mapa de campos de Salesforce del feed. Agregue la fila una vez por cada campo de carga. Cada campo mapeado se adjunta, y un campo de varios archivos envía todos los archivos que contiene. Los archivos se cargan la primera vez que un feed sincroniza una entrada, y la opción "Reenviar a Salesforce" los envía nuevamente después de un error.

Sincronización de notas

Enviar datos de formulario a Salesforce Nota adjunto al registro principal. Tanto el título de la nota como el cuerpo de la nota admiten etiquetas de combinación, por lo que puede formatearlos como desee. Deje el cuerpo en blanco y utilizará {all_fields}.

Opcionalmente, puedes sincronizar las notas de entrada de Gravity Forms añadidas por el administrador con Salesforce como Notas, lo que mantiene el historial de conversaciones en un solo lugar. Si eliminas la nota en Gravity Forms, la copia de Salesforce también se eliminará.

Membresía de campaña

Agregue el cliente potencial o contacto creado por el formulario a Salesforce. Campaña. Marque la casilla, asígnele un ID de campaña (una etiqueta de combinación funciona, por lo que un campo oculto puede seleccionar la campaña) y el complemento crea un registro de CampaignMember que vincula el nuevo cliente potencial o contacto con la campaña. Establezca su propio estado de miembro o déjelo como está y el complemento utilizará Responded.

Cesión de propiedad

Por ración:

• Establecer un personalizado ID del propietario (admite etiquetas de combinación, por lo que puede enrutar en función de los valores del formulario).
• Alternar el Sforce-Auto-Assign: FALSE encabezado para omitir las reglas de asignación estándar cuando sea necesario.

Rellenar previamente desde Salesforce

Envíe a los usuarios recurrentes un formulario personalizado, precargado con sus datos existentes de Salesforce. Formularios de renovación, formularios de actualización de cuenta, flujos de finalización de perfil.

• Asigna cualquier campo de Salesforce a cualquier campo de Gravity Forms para el autocompletado. El objeto de autocompletado predeterminado es aquel al que escribe la fuente de datos, pero puedes leer desde uno diferente; por ejemplo, precompletar desde el Contacto mientras la fuente crea un Caso.
• El autocompletado funciona para los administradores que han iniciado sesión tan pronto como se habilita. Para usarlo en un formulario público, marque Permitir solicitudes de precarga pública en formularios de interfaz de usuario también.
• URLs firmadas con HMAC con TTL impedir la enumeración de ID de registro en formularios públicos, y la firma está activada por defecto con una caducidad de 15 minutos. Sin firmas, cualquiera podría iterar ?sfid=001000... y extraer datos a los que no deberían haber tenido acceso.
• El Generador de enlaces prellenados firmados Está integrado en la configuración del feed. Pega el ID de un registro y obtén una URL firmada con fecha de caducidad. Úsalo en correos electrónicos de marketing, portales de clientes o flujos de autoservicio.
• Los administradores que hayan iniciado sesión pueden usar identificadores de registro sin formato, sin firmas, para realizar pruebas.
• Parámetro de consulta por feed (predeterminado) ?sfid=) mantiene las URL limpias.

Sincronización del ciclo de vida de entrada

La creación de registros es automática una vez que se guarda un feed. El resto del ciclo de vida lo configuras tú en Formularios → Configuración → Salesforce → Configuración de sincronización, de modo que la integración solo escribe la información que le has solicitado.

• Editar una entrada → el registro de Salesforce se actualiza una vez que se habilita “Sincronizar actualizaciones cuando se editan entradas” (gform_after_update_entry).
• Eliminar una entrada → el registro de Salesforce es quedó intacto, Siempre. La papelera es reversible en WordPress, por lo que el registro permanece.
• Restaurar desde la papelera → Con la opción "Sincronizar datos de entrada cuando se restauran entradas desde la papelera/spam" habilitada, cualquier edición realizada mientras la entrada estaba en la papelera se aplica al registro. Si el registro se eliminó manualmente en Salesforce mientras tanto y el modo de sincronización del feed es "Crear o actualizar si existe un registro" (el predeterminado), se crea un registro nuevo.
• Eliminar permanentemente una entrada (Vaciar papelera o “Eliminar permanentemente”) → el registro de Salesforce se elimina, si ha habilitado “Eliminar registros de Salesforce cuando las entradas se eliminan permanentemente”.

Sincronización en segundo plano

Las llamadas a la API de Salesforce no se ejecutan mientras el visitante espera. Los feeds se procesan en segundo plano una vez que se completa el envío, utilizando el procesamiento asíncrono de feeds propio de Gravity Forms, por lo que una respuesta lenta de Salesforce nunca se convierte en una página de agradecimiento lenta.

Una vez que el proceso en segundo plano procesa la señal, la entrada se pone azul. Pendiente estado, que se reemplaza por el resultado final de éxito o error tan pronto como Salesforce responde. Abra una entrada de prueba inmediatamente después de enviarla y es posible que lo primero que vea sea Pendiente. Si una fuente necesita terminar antes de la página de agradecimiento, por ejemplo para mostrar {salesforce_id} en ello, tic Procese esta fuente durante el envío. en esa transmisión.

Complemento de pago reconocido

Si tu formulario acepta pagos a través de un complemento de pago de Gravity Forms (Stripe, PayPal Standard, PayPal Commerce, Authorize.Net, Square, 2Checkout, Mollie y otros), habilita “Procesar la información de Salesforce solo cuando se reciba el pago.” bajo Acciones posteriores al pago En la configuración de la fuente del complemento de pago (la opción aparece una vez que el formulario tiene una fuente de Salesforce) se puede aplazar la sincronización con Salesforce hasta que el pago se confirme correctamente, de modo que los procesos de compra abandonados nunca dejen clientes potenciales incompletos.

Al enviar el formulario, la sincronización con Salesforce se detiene si la entrada tiene un pago pendiente. Cuando el complemento de pago confirma la transacción (a través del sistema estándar de sincronización diferida de Gravity Forms), la sincronización con Salesforce se ejecuta con normalidad. Si el pago falla o se abandona, la sincronización simplemente no se ejecuta.

Funciona con cualquier complemento de pago basado en la plataforma estándar de complementos de pago de Gravity Forms, es decir, con todos los complementos oficiales.

Exportación de registros y CSV

Cada sincronización de Salesforce, exitosa o fallida, se registra con el estado de sincronización y el mensaje exacto que devolvió Salesforce. Registros de Salesforce La página (Formularios → Registros de Salesforce) muestra:

• ID de entrada, formulario, estado, ID de registro, mensaje y hora de sincronización
• Filtro por formulario y paginación a 50 filas por página.
• Exportación CSV de la vista actual, por lo que filtrar por formulario exporta ese formulario.

Si activas el registro de Gravity Forms, también verás la carga útil de la solicitud saliente y el mensaje de error que devolvió Salesforce escritos en el registro de Gravity Forms, que suele ser la forma más rápida de ver exactamente a qué se opuso Salesforce.

Si prefiere no conservar el historial de sincronización en absoluto, “Deshabilitar el almacenamiento de registros de entradas de Salesforce (estado/mensajes/historial de sincronización)” impide que se grabe y mantiene wp_gf_entry_meta Es importante saber, antes de activarlo: la página de Registros de Salesforce lee ese historial, por lo que se silencia y la barra lateral de la entrada se reduce al enlace del registro y al botón Reenviar. El historial existente se borra al habilitar esta configuración. Los ID de registro permanecen en la entrada, por lo que las etiquetas de combinación y los enlaces de registro siguen funcionando.

Notificaciones por correo electrónico en caso de fallo de sincronización

Reciba una notificación en el momento en que Salesforce rechace una carga útil, con el ID de entrada y el mensaje de error exacto que devolvió Salesforce. Marcar “Enviar correos electrónicos de notificación de errores” En Informes de errores en la configuración de Salesforce del complemento, luego configure el destinatario una vez en Correo electrónico de notificación (Si se deja en blanco, se utilizará por defecto el correo electrónico de administrador de WordPress).

Útil para atrapar:

• Un campo obligatorio de Salesforce que de repente quedó sin asignar (alguien editó el formulario).
• Un valor de lista desplegable que ya no existe en Salesforce.
• límites de API, reglas de validación o reglas de flujo de trabajo que rechazan el registro
• Una aplicación conectada que necesita ser reautorizada.

Cuando se alcanza el límite de solicitudes de la API de Salesforce, se informa como una limitación de velocidad en lugar de un misterioso fallo de envío, por lo que sabrá que debe esperar en lugar de comenzar a depurar su mapa de campos.

Soluciona el problema, pulsa Reenviar a Salesforce En las entradas afectadas, los registros se incorporan. La alternativa es descubrir dos semanas después que 30 clientes potenciales nunca llegaron al CRM.

Barra lateral de Salesforce por entrada

Cada pantalla de detalles de entrada de Gravity Forms muestra una pantalla dedicada Salesforce Cuadro lateral con el estado en tiempo real de la sincronización:

• Estado, codificado por colores: verde Éxito, rojo Error, azul Pendiente, gris Omitido
• Objeto, ¿Qué objeto de Salesforce se creó (cliente potencial, contacto, objeto personalizado, etc.)?
• ID de registro, clicable, se abre directamente en Salesforce en una nueva pestaña
• Cuenta, que la cuenta de Salesforce conectada gestionó la sincronización (útil cuando tienes varias)
• Sincronizado, marca de tiempo del intento de sincronización más reciente
• Mensaje de error, el error exacto que devolvió Salesforce, cuando corresponda
• Resultados de la fuente, un desglose por fuente cuando varias fuentes se ejecutan en el mismo formulario

Es la forma más rápida de confirmar que un formulario está enviando datos a Salesforce y de identificar la entrada exacta que falló cuando algo sale mal.

Reenviar a Salesforce

Las inscripciones conllevan una Reenviar a Salesforce Botón en la pantalla de detalles de la entrada, para usuarios que pueden administrar la configuración del complemento. Hace más que simplemente resincronizar el registro principal: borra las marcas de deduplicación de efectos secundarios para que las notas, los archivos y las membresías de campaña también se reintenten. Úselo cuando:

• Salesforce no estaba disponible cuando se ejecutó la sincronización original.
• Corrigiste un problema de mapeo de feeds después de una tanda de envíos fallidos.
• Desea enviar datos de prueba a un entorno de pruebas sin volver a enviar el formulario.

Etiquetas de combinación

{salesforce_id} es el ID de registro de Salesforce creado o actualizado por la fuente más reciente para esta entrada. Las fuentes que usan el modo ID de organización (Web-to-Lead / Web-to-Case) envían datos a un punto final que no devuelve ningún ID de registro, por lo que nunca establecen esta etiqueta ni su variante por fuente.

{salesforce_id:FEED_ID} Es el ID del registro de Salesforce creado por una fuente de datos específica. Úselo cuando varias fuentes de datos se ejecuten en el mismo formulario.

Las etiquetas específicas del feed también funcionan dentro de la configuración del feed. Asigne un campo de búsqueda a Valor personalizado y entrar {salesforce_id:FEED_ID} para vincular el registro a una fuente creada anteriormente. Las fuentes se ejecutan en el orden de la lista de fuentes, y el ID de la fuente es el fid= valor en la URL de edición del feed. Una etiqueta para un feed que no creó ningún registro se resuelve como vacía.

{salesforce_link} es un enlace directo al registro de Salesforce, creado a partir de la URL de instancia de esa cuenta y el ID del registro, por ejemplo https://yourorg.my.salesforce.com/00Q5g00000ABCDE. Salesforce envía esa información a la página de registro de Lightning.

{salesforce_link:FEED_ID} Es un enlace directo al registro creado por una fuente específica. Resulta útil cuando un formulario tiene varias fuentes que escriben en diferentes organizaciones de Salesforce, por ejemplo, una para el entorno de pruebas y otra para el de producción, ya que cada variante utiliza la URL de instancia de cuenta de esa fuente.

Ambas etiquetas funcionan en cualquier lugar donde Gravity Forms evalúe las etiquetas de combinación, con una regla de tiempo. Las fuentes se ejecutan en segundo plano después de que se completa el envío, por lo que el mensaje de confirmación y cualquier notificación enviada al enviar el formulario se muestran antes de que exista el registro, y las etiquetas aparecen vacías allí. Se rellenan en cualquier lugar donde Gravity Forms evalúe las etiquetas de combinación después de que haya finalizado la sincronización. Para tenerlas en la página de confirmación y en las notificaciones de envío, marque Procese esta fuente durante el envío. en el feed; el visitante espera entonces a que Salesforce responda. Usos comunes:

• Vincular registros entre fuentes: en una fuente posterior, establezca una búsqueda como AccountId o ContactId en el valor personalizado. {salesforce_id:FEED_ID} del feed que creó el registro principal.
• Notificaciones enviadas posteriormente: "Nuevo cliente potencial en Salesforce → {salesforce_link}" se completa cuando se utiliza la función "Reenviar notificaciones" de Gravity Forms en la entrada después de que se haya ejecutado la sincronización.
• Cualquier complemento o código personalizado que evalúe las etiquetas de fusión después de la sincronización, por ejemplo, para pasar {salesforce_id} a un sistema aguas abajo.

Traducciones

Este plugin está listo para ser traducido. Puedes traducirlo a cualquier idioma usando el plugin gratuito. Loco Translate plugin o cualquier otra herramienta de traducción de WordPress.

Idioma predeterminado: inglés (en_US)

Preguntas frecuentes

¿Esto requiere Gravity Forms?

Sí. Debes tener instalada y activa la versión 2.7 o posterior de Gravity Forms. Este es un complemento para Gravity Forms, por lo que no funciona de forma independiente.

¿Qué versiones de WordPress y PHP son compatibles?

WordPress 6.5+ y PHP 8.0+. Probado hasta WordPress 7.0.

¿Puedo conectarme a un entorno de pruebas (Sandbox) de Salesforce?

Sí. Usar https://test.salesforce.com como tu URL de inicio de sesión al conectar la cuenta. Puedes tener una cuenta de prueba y una cuenta de producción conectadas al mismo sitio de WordPress al mismo tiempo.

¿Es compatible con varias cuentas de Salesforce en un mismo sitio?

Sí. Conecta tantas cuentas como quieras. Cada feed elige con qué cuenta se sincroniza. Casos de uso comunes: entornos de prueba y producción, organizaciones de clientes de agencias o estructuras corporativas de matriz y filiales.

¿Puedo sincronizar con objetos personalizados de Salesforce?

Sí. En el menú desplegable Objeto de Salesforce del feed, elija “Personalizado (escriba a continuación)” e ingrese el nombre de API de su objeto personalizado (por ejemplo, My_Object__cLas listas desplegables, las cargas de archivos, las búsquedas y el autocompletado funcionan de la misma manera con los objetos personalizados. Los objetos personalizados necesitan una cuenta OAuth; el modo ID de organización está limitado a Cliente potencial y Caso.

¿Es posible crear con un solo formulario una cuenta, un contacto y una oportunidad que estén vinculados entre sí?

Sí. Agregue una fuente por objeto y arrástrelas para ordenarlas en la lista de fuentes: primero Cuenta, luego Contacto, luego Oportunidad. Las fuentes se ejecutan en ese orden. En las fuentes de Contacto y Oportunidad, asigne ID de cuenta a Valor personalizado y entrar {salesforce_id:FEED_ID} con el ID del feed de la cuenta, que es el fid= valor en su URL de edición. Cada registro llega con su campo de búsqueda ya apuntando a la cuenta del mismo envío. Esto funciona igual para cualquier campo de búsqueda, estándar o personalizado, siempre que las fuentes de datos utilicen la misma cuenta de Salesforce.

¿Por qué no aparece mi objeto de Salesforce en el menú desplegable?

La lista de objetos proviene de Salesforce y solo incluye los objetos que el usuario conectado puede crear. Si falta un Cliente potencial, un Contacto o un objeto personalizado, significa que al usuario que autoriza no se le ha otorgado el permiso de creación, generalmente debido a una licencia de integración solo para API sin un conjunto de permisos asociado. Solucione el problema en Salesforce y espere a que se actualice la caché de objetos del complemento (que dura seis horas); volver a conectar la cuenta no la borra. La opción "Personalizado (tipo a continuación)" funciona como una solución temporal inmediata.

¿Esto funciona con Salesforce Pardot (Account Engagement)?

No directamente. El complemento escribe registros estándar de Salesforce, como Lead y Contact, a través de la API REST de Salesforce y no tiene código específico de Pardot. Si su organización utiliza el conector Salesforce-Pardot, Pardot recupera esos registros de la misma manera que cualquier otro registro de Salesforce. ¿Qué hace este complemento? no lo hace Qué hacer: escribir directamente en prospectos o listas de Pardot, omitir Salesforce o interactuar con objetos específicos de Pardot (redirecciones personalizadas, formularios de Pardot, etc.).

¿Cómo gestiona la asignación de listas desplegables los campos de Estado y País con códigos?

El complemento muestra Salesforce etiqueta al usuario del formulario (por ejemplo, "California") pero envía la lista desplegable valor (p.ej, CA), exactamente lo que requieren las listas desplegables de Estado/País de Salesforce, por lo que no necesita una tabla de traducción de su parte.

¿Cuál es la diferencia entre el modo Rellenar y el modo Sincronización en vivo para las listas desplegables?

• Poblar Copia los valores de la lista desplegable de Salesforce en el campo de tu formulario una sola vez. Después, puedes editar, eliminar o reorganizar las opciones. Es útil cuando necesitas un punto de partida, pero quizás quieras personalizar la lista.
• Sincronización en vivo Este plugin vuelve a aplicar las opciones de Salesforce en cada renderizado del formulario, de modo que los cambios en Salesforce se reflejan automáticamente en el formulario una vez que se actualiza la caché de campos del plugin (que dura seis horas). El editor de formularios bloquea las opciones para evitar desviaciones accidentales. Es útil cuando Salesforce es la única fuente de información fiable (campos de estado, fuentes de clientes potenciales, listas de países, etc.).

¿Puedo permitir que los usuarios del formulario elijan un tipo de registro de Salesforce?

Sí. Abra el campo de menú desplegable/selección múltiple/botón de opción/casilla de verificación, habilite la asignación de campos de Salesforce, seleccione el objeto y elija Tipo de registro de la lista de campos. El formulario muestra el nombre del tipo de registro (por ejemplo, "Donante") a los usuarios; el valor enviado es el ID del tipo de registro de Salesforce. A continuación, asigne ese campo de Gravity Forms a RecordTypeId en la asignación de su feed para que el tipo de registro seleccionado se establezca en el registro creado o actualizado. Solo se muestran los tipos de registro disponibles para su usuario de Salesforce conectado.

¿Puedo evitar crear registros duplicados?

Sí, de dos maneras. Habilitar Coincidencia de clave primaria En la configuración del feed, seleccione un campo único (el correo electrónico es el más común, o cualquier ID externo personalizado). El feed actualizará un registro existente cuando haya una coincidencia y creará uno nuevo cuando no la haya.

Si prefieres que la fuente se detenga antes de escribir algo, usa la verificación de conflictos En cambio, combina varios campos en una sola búsqueda, de modo que al vincular Nombre y Apellido se detecta a la misma persona que envía información con una dirección de correo electrónico diferente. Cuando todas las filas vinculadas coinciden con el mismo registro, la fuente se detiene y registra el mensaje de conflicto asociado a la entrada.

¿Cuál es la diferencia entre la coincidencia de clave primaria y la comprobación de conflictos?

La coincidencia de clave primaria encuentra un registro y actualizaciones La comprobación de conflictos encuentra un registro y paradas. Utilice la coincidencia cuando una repetición de envío deba mantener un registro actualizado; utilice la comprobación de conflictos cuando un segundo envío sea un problema que desee detectar en lugar de asumirlo. Ambas funciones trabajan conjuntamente: la comprobación de conflictos solo se activa cuando la fuente estaba a punto de crear un registro, por lo que un registro encontrado por coincidencia de duplicados se actualiza con normalidad.

¿Puedo rellenar previamente un formulario con datos existentes de Salesforce?

Sí. Habilitar Rellenar previamente desde Salesforce En una fuente de datos, mapee los campos de Salesforce que desea importar. Para un formulario público, marque también Permitir solicitudes de precarga pública en formularios de interfaz de usuario, de lo contrario, el prellenado solo se ejecuta para los administradores que han iniciado sesión. Luego, envíe a los usuarios una URL como ?sfid=001XXXXXXXXXXXX. Las solicitudes firmadas son obligatorias por defecto con una caducidad de 15 minutos; utilice la función integrada. Generador de enlaces prellenados firmados para crear esas URL para campañas de correo electrónico o flujos de autoservicio.

¿Al editar una entrada se actualiza el registro de Salesforce?

Una vez activado, sí. Las actualizaciones de entradas, las eliminaciones permanentes, las resincronizaciones de restauración desde la papelera y la sincronización de notas de entrada son casillas de verificación independientes en Formularios → Configuración → Salesforce → Configuración de sincronización, y todas están habilitadas de forma predeterminada. Crear registros no requiere ninguna configuración más allá de guardar un feed; cualquier acción que modifique un registro existente es opcional, por lo que el plugin nunca afecta a tu organización de forma no autorizada.

¿Qué sucede si borro una entrada y luego la restauro?

El registro de Salesforce se conserva durante el ciclo de eliminación/restauración. Solo eliminación permanente Elimina el registro de Salesforce, y solo si has habilitado esa opción en la configuración del plugin. Esto coincide con el comportamiento nativo de WordPress: la papelera es reversible, la eliminación permanente no lo es.

¿Por qué mi entrada aparece con el estado azul "Pendiente"?

Eso es normal, y generalmente desaparece cuando actualizas. Los feeds se procesan en segundo plano, por lo que las llamadas a la API de Salesforce nunca retrasan el envío del formulario. Justo antes de llamar a Salesforce, la tarea en segundo plano marca la entrada como Pendiente y luego la sobrescribe con éxito o un error tan pronto como Salesforce responde. Un estado atascado en Pendiente significa que la tarea comenzó pero nunca terminó, generalmente un tiempo de espera de PHP o un error fatal a mitad de la solicitud, así que habilita el registro de Gravity Forms y revisa el registro del complemento. Si un feed debería haberse ejecutado pero la entrada no muestra ningún estado de Salesforce, la cola nunca lo ejecutó, lo que generalmente significa que el sitio bloquea las solicitudes de bucle a admin-ajax.php y WP-Cron, la alternativa, está deshabilitado.

¿Puedo volver a intentar una sincronización fallida?

Sí. Abra la pantalla de detalles de la entrada y haga clic. Reenviar a Salesforce. También borra las marcas de deduplicación de efectos secundarios, por lo que las notas, los archivos y las membresías de campaña se vuelven a intentar junto con el registro principal.

¿Funciona esto con complementos de pago (Stripe, PayPal, etc.)?

Sí. El feed del complemento de pago (Stripe, PayPal, etc.) recibe un Acciones posteriores al pago sección con un “Procesar la información de Salesforce solo cuando se reciba el pago.” Casilla de verificación que aplaza la sincronización con Salesforce hasta que el complemento de pago confirme una transacción exitosa, para que los procesos de compra abandonados nunca dejen clientes potenciales incompletos.

¿Permite subir archivos desde Gravity Forms?

Sí. Los campos de carga de archivos de Gravity Forms se pueden adjuntar al registro de Salesforce como ContentVersion / ContentDocumentLink, de modo que aparezcan en la lista relacionada Archivos del registro. Tamaño máximo de archivo configurable, de 1 a 25 MB por archivo, con un valor predeterminado de 10 MB.

¿Puedo evitar que el plugin guarde el historial de sincronización?

Sí. Marcar “Deshabilitar el almacenamiento de registros de entradas de Salesforce (estado/mensajes/historial de sincronización)” en la configuración del complemento y no se escribe ningún estado, mensaje o marca de tiempo de sincronización wp_gf_entry_meta. Primero, dos cosas que debes saber: la página de registros de Salesforce se basa en ese historial, por lo que deja de mostrar resultados y la barra lateral de entrada se reduce al enlace del registro y al botón Reenviar. El historial existente se borra al habilitar esta configuración. Los ID de registro y los ID de cuenta se siguen almacenando, por lo que las etiquetas de combinación, los enlaces de registro y la función Reenviar siguen funcionando.

¿Cómo puedo personalizar la carga útil de Salesforce mediante programación?

Utilice el pb_gfsf_payload filtrar:

add_filter( 'pb_gfsf_payload', function ( $payload, $context ) {
    // $context['feed'], ['entry'], ['form'], ['object'], ['account_id'], ['method']
    return $payload;
}, 10, 2 );

El feed completo, la entrada, el formulario, el objeto de destino, el ID de la cuenta y el método de conexión (oauth o org_id) están disponibles en $context para que puedas tomar decisiones basándote en cualquiera de ellas.

¿Qué ocurre si mi organización de Salesforce no tiene acceso a la API?

Usar Modo de ID de organización. Utiliza el punto final Web-to-Lead/Web-to-Case heredado de Salesforce en lugar de la API REST. Limitaciones: solo admite objetos Lead y Case, y no permite actualizaciones, eliminaciones, carga de archivos, autocompletado ni asignación de listas desplegables. Para la mayoría de las configuraciones de producción, OAuth (la opción predeterminada) es la más adecuada.

¿Qué políticas de OAuth de Salesforce admite el complemento?

El complemento utiliza el flujo de código de autorización OAuth 2.0 con PKCE y admite la rotación de tokens de actualización, por lo que puede habilitar ambas opciones en su aplicación conectada o aplicación cliente externa sin interrumpir la conexión. La única política de token de actualización incompatible es "Expirar inmediatamente el token de actualización", que fuerza una reautorización completa cada vez que caduca un token de acceso y no es compatible con ninguna integración desatendida.

¿Cómo se mantiene la sesión iniciada en la conexión OAuth?

El complemento utiliza OAuth 2.0 con PKCE y actualiza automáticamente el token de acceso mediante el token de actualización. Mientras la política del token de actualización de la aplicación conectada o la aplicación cliente externa no lo haga expirar (‘válido hasta su revocación’ o con una expiración fija prolongada, como los 365 días que se indican en nuestra guía de configuración), la conexión se mantiene activa. Cuando el token de actualización expira, se vuelve a conectar la cuenta una vez. Si se interrumpe, consulte la siguiente pregunta. Casi siempre se debe a una política o configuración de ámbito de la aplicación conectada. Se admite la rotación del token de actualización, por lo que los administradores preocupados por la seguridad también pueden habilitar esta política.

La conexión con Salesforce se cae constantemente y tengo que volver a conectarme. ¿Por qué?

Casi siempre se debe a una de estas tres cosas en Salesforce. La política de token de actualización de la aplicación conectada está configurada para caducar en lugar de "válida hasta su revocación". La aplicación tenía un alcance de "Acceso completo (completo)", que nunca emite un token de actualización. O los rangos de IP de inicio de sesión están bloqueando su servidor, en cuyo caso Salesforce rechaza cada actualización y volver a conectarse desde el mismo servidor no ayudará. A partir de la versión 1.3.0, la pantalla de Cuentas nombra cuál es en lugar de mostrar un error de sesión genérico, y registra cuándo se actualizó, se realizó correctamente y falló por última vez cada cuenta.

¿Se borran los datos al desinstalar el plugin?

Solo si lo autorizas. Habilitar “Eliminar todos los datos del plugin al desinstalarlo” En la configuración del plugin antes de desinstalarlo. De forma predeterminada, se conservan los registros de sincronización y la configuración de conexión (para que no pierda el historial si lo reactiva más adelante).

¿Funciona con almacenamiento en caché/CDN?

Sí. El plugin se ejecuta completamente en el servidor al enviar el formulario, por lo que la configuración de caché y CDN no interfiere con la sincronización de Salesforce. El código JavaScript del editor de formularios solo se carga dentro del panel de administración de WordPress (donde, por lo general, la caché está desactivada).

¿Esto funciona con una red multisitio de WordPress?

TL;DR

• Licencia ilimitada: Active el modo de red una sola vez; una sola tecla permite gestionar la configuración y el soporte de todos los subsitios.
• Modo de red activado: Cada subsitio hereda la clave de red, por lo que todos pueden ejecutar feeds de Salesforce y recibir actualizaciones de inmediato. La activación de red del plugin por sí sola no otorga licencias a los subsitios.
• Plan limitado / sin licencia para subdominios: La configuración de Salesforce de ese subsitio está bloqueada y sus feeds registran el mensaje "La sincronización de Salesforce no está disponible hasta que la licencia del complemento esté activa" en lugar de sincronizarse.
• El soporte se aplica según la licencia: Los sitios cubiertos por la clave activa son elegibles.

Si dispone de una licencia ilimitada, puede habilitar el modo de red desde el sitio principal y distribuir esa clave única a todos los subsitios en un solo lote (con seguimiento en tiempo real). Estos subsitios heredarán automáticamente la configuración y el soporte gestionados por la licencia.

Manos

Filtros

pb_gfsf_payload

Filtra la carga útil que se enviará a Salesforce. Este proceso se ejecuta para cada creación y actualización en cada feed, con el contexto completo de la sincronización (configuración del feed, entrada, formulario, objeto de destino, cuenta y método de conexión). Se activa después de que se hayan aplicado el mapa de campos y el ID del propietario, pero antes de la llamada a la API, y si se devuelve una matriz vacía, se trata como un feed sin campos mapeados.

Parámetros:

• $payload (formación): la matriz asociativa del nombre del campo de Salesforce → valor que está a punto de ser enviado.
• $context (formación): contexto de sincronización. Claves: feed, entry, form, object, account_id, method (oauth para una conexión OAuth, org_id (para Web-to-Lead/Case).

Ejemplo: establecer una fuente de clientes potenciales predeterminada para cada cliente potencial.

add_filter( 'pb_gfsf_payload', function ( $payload, $context ) {
    if ( $context['object'] === 'Lead' && ! isset( $payload['LeadSource'] ) ) {
        $payload['LeadSource'] = 'WordPress Form';
    }
    return $payload;
}, 10, 2 );

Ejemplo: enrutar diferentes fuentes de datos a diferentes tipos de registros.

add_filter( 'pb_gfsf_payload', function ( $payload, $context ) {
    $feed_id = (int) ( $context['feed']['id'] ?? 0 );
    if ( $feed_id === 12 ) {
        $payload['RecordTypeId'] = '0125g000000XYZAAA';
    }
    return $payload;
}, 10, 2 );

Ejemplo: reescribir LeadSource en función del ID del formulario.

add_filter( 'pb_gfsf_payload', function ( $payload, $context ) {
    $form_id = (int) ( $context['form']['id'] ?? 0 );
    $payload['LeadSource'] = match ( $form_id ) {
        7  => 'Webinar Signup',
        12 => 'Demo Request',
        default => 'Website',
    };
    return $payload;
}, 10, 2 );

pb_gfsf_multi_value_delimiter

Cambia el separador que se usa para unir las selecciones de un campo de selección múltiple o casillas de verificación. Por defecto, se usa el punto y coma que requieren las listas desplegables de selección múltiple de Salesforce. Anula este valor cuando uno de esos campos esté asignado a un campo de texto sin formato que requiera otro separador.

Parámetros:

• $delimiter (cadena): separador, ; por defecto.
• $sf_field (cadena): Se está escribiendo el nombre de la API del campo de Salesforce.
• $raw_value (cadena): ID de campo o etiqueta de combinación de Gravity Forms mapeado.
• $feed (formación): Objeto de alimentación de Gravity Forms.

add_filter( 'pb_gfsf_multi_value_delimiter', function ( $delimiter, $sf_field ) {
    return 'Interests__c' === $sf_field ? ', ' : $delimiter;
}, 10, 2 );

pb_gfsf_allowed_salesforce_domains

El complemento verifica cada URL de inicio de sesión, URL de instancia y URL de Web-to-Lead con los dominios propios de Salesforce antes de enviarles credenciales o datos de entrada. La lista predeterminada es salesforce.com, force.com, cloudforce.com y salesforce.mil, coincidente en un límite de punto. Añádelo si se accede a tu organización en un dominio personalizado de Salesforce.

Parámetros:

• $domains (formación): sufijos registrables, que coinciden en un límite de punto.
• $url (cadena): la URL que se está comprobando.

add_filter( 'pb_gfsf_allowed_salesforce_domains', function ( $domains ) {
    $domains[] = 'example-crm.com';
    return $domains;
} );

pb_gfsf_http_timeout

Modifique el tiempo de espera, en segundos, que se aplica a cada solicitud a Salesforce. El valor predeterminado es 20. Los sitios con redes lentas o que envían cargas de archivos grandes pueden necesitar más; cualquier valor inferior a uno o dos segundos interrumpirá el funcionamiento normal.

add_filter( 'pb_gfsf_http_timeout', function () {
    return 45;
} );