Integrations
      Volver al inicio
      1. Centro de Ayuda Rock Content
      2. Ion
      3. Integrations

      Servicio externo: Post to web form

      La integración de "post to web form" te permite publicar datos de contacto en tiempo real en un formulario web existente. Este documento proporciona instrucciones paso a paso para integrar los datos recopilados de tus experiencias de ion con formularios web externos.

      Antes de que comencemos

      Hay algunos elementos que deberás tener antes de configurar la integración. Estos elementos se pueden encontrar en el HTML de tu formulario web externo o se pueden encontrar en la documentación de soporte de tu proveedor.

      • URL de punto final o "Post-To"
      • Nombres de campo de Web form
      • Valores aceptables para campos que no son de texto

      Hay algunos pasos a seguir en la plataforma de ion antes de configurar la integración, que se enumeran a continuación:

      • Crear campos de recopilación de datos
      • Crear formulario(s) de ion
      • Configurar publicación de prueba

      ¡Empecemos!

      1. Crea el mapeo de campo

      Si sigues los pasos a continuación, se asignarán los campos de recolección de datos de ion a tus correspondientes nombres de campo externo. Para comenzar, agrega tu nueva asignación de campo:

      1. Haz clic en la pestaña Integrations en el navegador lateral de tu ion console
      2. Haz clic en el botón verde "New field mapping” para una nueva asignación de campo
      3. Etiqueta el mapeo del campo y, opcionalmente, agrega una descripción
      4. En el menú Integration type, selecciona "Post to Web Form”
      5. Guarda 

      2. Agrega campos salientes al mapeo de campos

      Los campos de salida definen los datos que extiendes desde ion a tu formulario web externo.

      1. Haz clic en el botón verde "New outbound field" para agregar un nuevo campo a su mapeo de campo
      2. Al agregar un nuevo campo, deberás seleccionar el menú desplegable Core Field en el menú desplegable de "Data Collection", implementar una plantilla Mashup o agregar un campo a través de JavaScript
          • Para agregar un campo de formulario, usa los menús desplegables de Data Collection para seleccionar la categoría del campo de datos y luego el campo de recopilación de datos
          • O, para agregar un Core Field de ion, selecciona en el menú desplegable de Core Field
          • O, para exportar varios campos de ion a un campo externo, usa el "Mashup Field" conectando {{DataName}} {{DataName2}} , etc. en el editor
          • O, para reformatear un valor antes de exportarlo, usa el campo JavaScript para agregar lógica alrededor del valor recolectado en ion. Para acceder a los campos de recopilación de datos a través de Javascript, usa respondent.dataname.
      • 3. Opcionalmente, haz que tu campo sea obligatorio para ejecutar la integración.
      • 4. Opcionalmente, agrega un valor predeterminado
      • 5. Ingresa el nombre del campo externo
      • 6. Guarda
      • 7. Repite estos pasos para cada campo que deba incluirse en la asignación de campos

      3. Opcionalmente, agrega campos entrantes

      Aprovecha los campos entrantes para guardar datos de una respuesta XML en la recopilación de datos de ion. Profundizaremos en cómo analizar y guardar respuestas JSON en un paso posterior.

      1. Haz clic en el botón verde "New inbound field” para generar un nuevo campo entrante
      2. Selecciona el campo de recopilación de datos de ion en el que deseas guardar el valor
      3. Ingresa una consulta de ruta para analizar el valor del XML
      4. Guarda
      5. Repite para cada campo que desees guardar en la recopilación de datos de ion

      4. Crea una integración

      1. Navega de regreso a la pantalla de integraciones
      2. Haz clic en la pestaña Integrations
      3. Haz clic en el botón verde "New integration” para una nueva integración
      4. Ingresa la etiqueta
      5. Opcionalmente, agrega una descripción
      6. Selecciona el mapeo de campo que acabas de crear
      7. Pega la URL de tu formulario en el editor
          • Esta es el "post to” o punto final URL de tu formulario web).

      8. Establece reintentos máximos

       

          • Si hay una interrupción del servicio con la plataforma externa, ion volverá a intentar publicar en la parte superior de la hora tantas veces como indiques aquí.

       

      9. Opcionalmente, marca los requisitos especiales

       

          • Marca " Send form as multipart/form-data” si corresponde
          • Marca "Disable URL Encoding of all form data” si los datos no deben estar codificados en URL o si estás aprovechando los campos de salida de Javscript para codificar los datos de forma personalizada
          • Marca "Empty Fields” para excluir los campos externos que no tienen valores de datos POST

       

      10. Selecciona "POST", "GET" o "PUT" como método

       

      11. Opcionalmente, agrega la dirección de correo electrónico de depuración

       

          • Las direcciones de correo electrónico especificadas aquí recibirán un correo electrónico cada vez que se ejecute la integración que muestra los datos publicados y la respuesta recibida. Esta es una característica que normalmente solo se usa para probar y solucionar problemas.

      12. Opcionalmente, guarda la respuesta  

          • Ingresa un nombre de datos aquí si deseas guardar la respuesta completa del servidor externo. Por lo general, esto se usa para guardar una respuesta que no es XML, de modo que se pueda usar un script de servidor para analizar los puntos de datos que buscas guardar en la recopilación de datos de ion.

      13. Agrega requisitos de autenticación

          • Si la integración requiere autenticación NTLM o básica, haz tu selección en el menú desplegable de autenticación remota y selecciona las credenciales de cuenta correspondientes.

      14. Agrega encabezados personalizados

          • Si la integración requiere encabezados http personalizados, ingresa él(los) nombre(s) y valor(es) aquí.

      15. Guarda

       

      5. Agrega la integración a páginas de ion

      La plataforma de ion ejecuta la integración según las reglas que crees. Se pueden agregar reglas a cualquier elemento procesable en su publicación de ion. Las reglas de integración se ejecutan normalmente a nivel de formulario, al enviarlo o en un paso de evaluación. Sigue los pasos a continuación para agregar la integración a tus páginas de ion.

      1. Navega hacia la publicación
      2. Haz clic en el formulario, botón o enlace que buscas para activar el disparador para ejecutar tu integración
      3. En Creative Studio, haz clic en +Rules
      4. Selecciona la condición que debe cumplirse para ejecutar la integración
          • Normalmente se usa "No conditions required” para especificar que no se requieren condiciones
      • 5. Selecciona "Run integration” para ejecutar la integración
      • 6. Guarda

      6. Prueba tu integración

      Para probar tu integración, utiliza la publicación de prueba que configuraste antes de comenzar los pasos de integración. Ten en cuenta que las integraciones no se ejecutan en Preview Mode, por lo que querrás abrir una URL para probar. La integración se ejecutará una vez se envíe el formulario de ion o complete la acción que ejecuta la regla de integración.

      Si está en la lista de distribución de correo electrónico de depuración, recibirás un correo electrónico que muestra los datos publicados y la respuesta del servidor externo. También querrá verificar que los datos que enviaste fueron recibidos por la plataforma externa.

       

      ¡Buen trabajo!

      Una vez hayas completado estos pasos, tu integración estará lista para usarse. Puedes agregar la regla para ejecutar la integración en todas las publicaciones aplicables.