Subir tus emails a Pardot

Emailify incluye una integración con Pardot que sube emails HTML directamente desde el plugin de Figma a tus plantillas de Pardot.

Pardot ahora se llama Account Engagement en Salesforce Marketing Cloud.

Vídeo tutorial: subir tus emails a Pardot

Este vídeo explica cómo subir a Pardot los emails HTML del plugin Emailify de Figma.

Si necesitas enlaces con AMPscript (por ejemplo, %%=v(@url)=%%) en tus párrafos de texto, el campo de enlace nativo de Figma los bloqueará por no ser URL válidas. Para evitarlo, puedes usar el formato especial de enlace AMPscript de Emailify, https://ampscript.invalid/?%%=v(@url)=%%, y Emailify incluirá la etiqueta AMPscript sin modificar en el HTML exportado.

1. Crea una Connected App en Pardot ​

Si todavía no tienes una configurada, tienes que crear una Connected App nueva en Pardot, que te dará la Consumer Key y el Consumer Secret que pegarás en el plugin en el paso 3 (Autenticarte con Pardot).

  1. En la esquina superior derecha de la administración de Pardot, haz clic en el Settings Icon y, después, en Setup.
  2. En la barra de búsqueda de los ajustes, busca "App Manager" y haz clic en el resultado App Manager.
  3. Haz clic en el botón New Connected App.
  4. Ponle un nombre a tu Connected App (por ejemplo, Emailify Integration).
  5. Añade los datos de contacto del propietario de la Connected App.
  6. Marca la casilla Enable OAuth Flows.
  7. Añade https://figma.com/ como Callback URL.
  8. En Selected OAuth Scopes, añade los siguientes ámbitos, que permiten a la app acceder a Pardot y autenticarse:
  • Access content resources (content)
  • Access the identity URL service (id, profile, email, address, phone)
  • Manage Pardot services (pardot_api)
  • Perform requests at any time (refresh _token, offline_access)
  1. Marca la casilla Require Secret for Web Server Flow.
  2. Si aparece, asegúrate de que Require Proof Key for Code Exchange (PKCE) Extension for Supported Authorization Flows no está marcada.
  3. Haz clic en Save.

2. Busca el Business Unit ID de Pardot ​

El Business Unit ID es un ID de 18 caracteres que empieza por "0Uv"; puedes encontrar el Business Unit ID de Pardot siguiendo estos pasos:

  1. Inicia sesión en Salesforce con la misma cuenta que usas para iniciar sesión en Pardot.
  2. Haz clic en la pestaña Setup.
  3. Busca el desplegable Pardot y haz clic en Pardot Account Setup.
  4. Puede que tengas varias unidades de negocio de Pardot; elige el Business Unit ID de la que quieras usar con Emailify.

3. Autentícate con Pardot ​

En el panel de exportación de Emailify, selecciona en la lista desplegable la opción Pardot (API) o una opción de cuenta de prueba de Pardot y, después, copia y pega las siguientes credenciales y datos de Pardot en los campos de los ajustes de exportación de Emailify:

  • Pardot Business Unit ID (por ejemplo, 0UvXXXXXXXXXXXXXXX)
  • Pardot Username con el que inicias sesión (por ejemplo, [email protected])
  • Pardot Password con la que inicias sesión (por ejemplo, *********)
  • Consumer Key de tu Connected App (por ejemplo, y0Zd2jVHJ5Cc1wQg0l5yMJsXpPs...)
  • Consumer Secret de tu Connected App (por ejemplo, 8C8F8D11A3B7B026A90C5C3...)

Cuando hayas pegado todos estos datos, Emailify se autenticará con tu instancia de Pardot.

Opciones de endpoint de la API de Pardot en Emailify ​

Si usas una instancia de prueba o sandbox, puedes seleccionar distintas opciones de exportación por API de Pardot en las opciones de exportación de Emailify. Aquí tienes los endpoints a los que llama cada una:

Opción de EmailifyDominio de autorizaciónDominio de contenido
Pardot APIlogin.salesforce.com/services/oauth2/token?grant_type=passwordpi.pardot.com
Pardot Test APItest.salesforce.com/services/oauth2/token?grant_type=passwordpi.demo.pardot.com
Pardot Dev APIlogin.salesforce.com/services/oauth2/token?grant_type=passwordpi.demo.pardot.com

Solución de problemas de autenticación con Pardot ​

Si tienes problemas para autenticarte con tu nombre de usuario y contraseña de Pardot, lo más habitual es que se haya activado la autenticación multifactor (MFA) de Salesforce para el usuario de Salesforce del que depende tu integración.

El motivo más habitual por el que falla la autenticación con Pardot está relacionado con la 2FA, pero a menudo se puede resolver en Pardot así:

  • Cambiando el ajuste IP Relaxation a Relax IP Restrictions
  • Cambiando el ajuste Permitted Users a All users may self-authorize
  • Activando el interruptor Allow OAuth Username-Password Flows en OAuth and OpenID Connect Settings
  • Las contraseñas no pueden contener caracteres especiales (por ejemplo, # % &, etc.) y solo pueden tener letras y números (por ejemplo, mypa55word1234)

Asegurarte de que los usuarios de integración por API funcionan con la MFA de Salesforce ​

Salesforce aplica la MFA sobre todo a los inicios de sesión interactivos en la interfaz de usuario. Las integraciones por API normalmente pueden seguir funcionando sin solicitudes de MFA interactivas, pero el administrador de Salesforce tiene que configurar correctamente el usuario de integración.

Para el flujo de subida por API de Pardot de Emailify, lo recomendable es usar una cuenta de usuario de integración de Salesforce dedicada en lugar de un inicio de sesión personal compartido.

Si tu edición de Salesforce incluye licencias de usuario Salesforce Integration, asigna una de esas licencias al usuario de integración dedicado que usa Emailify.

Ventajas:

  • Estos usuarios están pensados para acceder solo por API.
  • No pueden iniciar sesión en la interfaz de Salesforce, así que de por sí están exentos de las solicitudes de MFA de la interfaz.
  • Ayudan a mantener tu integración separada de las cuentas de usuario normales.
  • Su perfil solo de API suele tener API Enabled activado de forma predeterminada.

Para comprobar si tienes estas licencias disponibles:

  1. En Salesforce, ve a Setup.
  2. Busca Company Information.
  3. Abre Company Information.
  4. Busca Salesforce Integration en la lista User Licenses.
Alternativa: eximir de la MFA de la interfaz a un usuario estándar de Salesforce ​

Si no puedes usar una licencia de usuario Salesforce Integration y tu integración usa un usuario estándar de Salesforce, el administrador de Salesforce puede eximir a ese usuario de integración dedicado de la MFA de la interfaz asignándole un Permission Set con el permiso de sistema Waive Multi-Factor Authentication for Exempt Users.

Para configurarlo:

  1. En Salesforce, ve a Setup.
  2. Busca Permission Sets.
  3. Crea un Permission Set nuevo para tu usuario de integración.
  4. Abre System Permissions y haz clic en Edit.
  5. Activa Waive Multi-Factor Authentication for Exempt Users.
  6. Guarda el Permission Set.
  7. Asigna ese Permission Set al usuario de integración dedicado.

Si usas una licencia de usuario estándar de Salesforce para la integración, asegúrate también de que el perfil del usuario sigue teniendo API Enabled activado en System Permissions.

Recomendaciones adicionales ​
  • Usa preferiblemente un usuario de integración dedicado en lugar de una cuenta de usuario personal.
  • Si usas autenticación con nombre de usuario y contraseña, guarda de forma segura esas credenciales y cualquier token de seguridad.
  • Prueba la conexión con Pardot en un sandbox antes de activar cambios relacionados con la MFA en producción.
  • Si la autenticación empieza a fallar después de implantar la MFA, consulta el Login History del usuario de Salesforce para ver el motivo exacto del fallo.
Referencias de Salesforce ​

4. Sube plantillas de email a Pardot ​

Una vez autenticada correctamente la conexión con la API de Pardot, podrás indicar los siguientes campos obligatorios con los campos y desplegables que aparecerán:

  • Sender Name

  • Sender Address

  • Campaign Name

  • Folder Name

  • Domain Tracking Name

Si quieres, puedes añadir etiquetas de regiones de contenido de Pardot a la plantilla exportada:

  • Editable Regions permite a los usuarios editar textos, imágenes y botones.
  • Repeatable Regions permite a los usuarios copiar o mover los bloques de contenido de nivel superior desbloqueados. Estos bloques comparten un mismo nombre de región repetible (body_content), así que los distintos bloques pueden moverse unos por delante de otros.
  • Removable Regions permite a los usuarios quitar los bloques de contenido de nivel superior desbloqueados.

Activa cualquier combinación de estas opciones antes de subir o exportar la plantilla. Cuando Repeatable Regions y Removable Regions están activadas a la vez, Emailify pone ambos atributos en el mismo contenedor de cada bloque desbloqueado. Los contenedores repetibles comparten el nombre body_content y están uno junto a otro, lo que permite mover los distintos bloques dentro del grupo. No hay un contenedor eliminable aparte alrededor de cada bloque repetible.

Mantener fijos la cabecera y el pie ​

En Figma, bloquea la cabecera, el pie u otra capa principal situada directamente dentro del frame de tu email de Emailify antes de exportar. Emailify exporta las capas de nivel superior bloqueadas sin etiquetas de regiones repetibles ni eliminables, incluidos todos los bloques generados a partir de un grupo principal bloqueado. Deja desbloqueadas las capas del cuerpo para que los usuarios puedan reordenarlas con Repeatable Regions activada.

Bloquea la propia capa de nivel superior; bloquear solo una capa de texto o de imagen anidada no bloquea su bloque principal. Esto controla si se pueden copiar, mover y quitar bloques completos. Editable Regions sigue controlando la edición de textos, imágenes y botones dentro de ellos. Desbloquea la capa principal y vuelve a exportar para que el bloque vuelva a ser repetible o eliminable.

Cuando hayas seleccionado las opciones que quieras, haz clic en el botón Upload To Pardot para empezar a exportar a HTML los emails que hayas seleccionado en Figma y subirlos automáticamente a tus plantillas de email de Pardot.