Menú de la documentación

Salesforce

MailInApp no tiene una app de Salesforce que instalar, y no la necesitas. La API REST de Salesforce responde con JSON simple por HTTPS. La fuente de datos por API de MailInApp, con la autenticación OAuth2 JWT Bearer, habla directamente el flujo de inicio de sesión de servidor a servidor de Salesforce: sin pantalla de consentimiento, sin token de actualización que vigilar, y tu contraseña de Salesforce nunca llega a MailInApp.

Vídeo en inglés

Esta guía configura una conexión de solo lectura. Trae filas de Opportunity, Account, Contact o productos a etiquetas de combinación, bloques de repetición y gráficos enlazados, y puede importar tus contactos de Salesforce como audiencia. No escribe nada en Salesforce.

Cómo funciona la conexión

  1. MailInApp firma una aserción JWT de corta duración con la clave privada de tu app.
  2. Envía esa aserción al endpoint de token de Salesforce, que comprueba la firma con el certificado que subiste y devuelve un token de acceso. No se envía ningún usuario ni contraseña.
  3. MailInApp guarda el token en caché y llama con él a la API REST de Salesforce (una consulta SOQL). Pide uno nuevo antes de que caduque, o si una llamada vuelve sin autorización.

Todo ocurre en el servidor, en cada lectura. Una vez configurado, no hay nada que mantener ni que volver a autorizar.

Crear un par de claves

El flujo JWT necesita un par de claves RSA: el certificado va a Salesforce y la clave privada a MailInApp. Si no tienes uno, genera un par autofirmado con OpenSSL:

openssl req -x509 -newkey rsa:2048 -nodes -keyout mailinapp.key -out mailinapp.crt -days 730 -subj "/CN=MailInApp"

Guarda mailinapp.key en un lugar seguro. La pegas una vez en MailInApp y desde entonces queda oculta.

Configurar Salesforce

Salesforce crea ahora las integraciones nuevas como External Client Apps (las Connected Apps nuevas están desactivadas por defecto en las orgs recientes).

  1. En Setup, abre External Client App Manager y haz clic en New External Client App.
  2. Escribe el nombre (por ejemplo MailInApp JWT), un correo de contacto, y deja Distribution State en Local.
  3. Abre API (Enable OAuth Settings) y marca Enable OAuth. El flujo JWT nunca usa la Callback URL, pero es obligatoria: https://login.salesforce.com/services/oauth2/success sirve.
  4. En OAuth Scopes, añade Manage user data via APIs (api) y Perform requests at any time (refresh_token, offline_access).
  5. En Flow Enablement, marca Enable JWT Bearer Flow y sube el certificado (mailinapp.crt). Haz clic en Create.
  6. En la pestaña Policies de la app, haz clic en Edit. En OAuth Policies, pon Permitted Users en Admin approved users are pre-authorized y elige el perfil o el permission set del usuario con el que MailInApp inicia sesión. Esto es lo que hace el flujo no interactivo: sin ello, Salesforce espera que alguien acepte una pantalla de consentimiento. Guarda.
  7. En la pestaña Settings, abre OAuth Settings y haz clic en Consumer Key and Secret. Salesforce te envía un código por correo para confirmar tu identidad y después muestra la Consumer Key: es el emisor que necesita MailInApp. No necesitas el secreto.

El usuario con el que MailInApp inicia sesión ve exactamente lo que ese usuario ve en Salesforce. Lo más limpio es un usuario de integración dedicado, con acceso de lectura a los objetos que usan tus correos. Un campo oculto para ese usuario (por la seguridad a nivel de campo) no aparece en los resultados.

Conectarla en MailInApp

Ve a Fuentes de datos → + Conexión por API y completa:

  • URL del endpoint: la URL de consulta de tu org con una consulta SOQL, por ejemplo https://yourorg.my.salesforce.com/services/data/v62.0/query?q=SELECT Name, Amount, StageName, CloseDate, Account.Name FROM Opportunity WHERE IsClosed = false. Puedes escribir la consulta con espacios normales: MailInApp la codifica.
  • Ruta de los datos: records. Salesforce entrega las filas en un array records, junto a totalSize y done.
  • Autenticación: OAuth2 JWT Bearer, con:
    • URL del token: https://login.salesforce.com/services/oauth2/token (o la de tu My Domain, https://yourorg.my.salesforce.com/services/oauth2/token); https://test.salesforce.com/services/oauth2/token para un sandbox.
    • Emisor: la Consumer Key de la app.
    • Sujeto: el nombre de usuario de Salesforce con el que MailInApp inicia sesión.
    • Audiencia: https://login.salesforce.com (https://test.salesforce.com para un sandbox).
    • Clave privada: el contenido de mailinapp.key.

Haz clic en Probar esta configuración: MailInApp obtiene un token real, ejecuta la consulta y muestra las primeras filas tal como las verán tus etiquetas de combinación. Una vez guardada, Probar la conexión guardada la comprueba cuando quieras sin volver a pegar la clave.

Una conexión es una consulta. Crea una por tarea: las oportunidades abiertas para un correo de pipeline, la lista de precios para un catálogo, los contactos para una audiencia.

Consultar con SOQL

La consulta es exactamente lo que recibes, así que selecciona solo las columnas que necesita tu correo.

  • Los campos relacionados funcionan. Salesforce devuelve un campo de relación como Account.Name como objeto anidado; MailInApp lo convierte en un campo llamado Account.Name. Escríbelo {{alias.Account.Name}} en una etiqueta de combinación, o {{Account.Name}} dentro de un bloque de repetición. Funciona hasta tres niveles (Account.Owner.Name), y los metadatos attributes que Salesforce añade a cada registro se omiten.
  • Ordena y limita en la consulta. ORDER BY CloseDate y LIMIT 10 deciden el orden y el número de filas que muestra un bloque de repetición.
  • Hasta 1000 filas por lectura, suficiente para un resumen o un catálogo.
  • Se lee de nuevo en cada renderizado. Cada envío, incluida cada ejecución de un envío recurrente, vuelve a ejecutar la consulta, así que el correo siempre muestra los datos actuales de Salesforce. Solo el token OAuth se guarda en caché.

Algunas consultas útiles:

SELECT Name, StageName, Amount, CloseDate, NextStep, Account.Name FROM Opportunity WHERE IsClosed = false ORDER BY CloseDate
SELECT Name, ProductCode, UnitPrice, Product2.Description, Product2.DisplayUrl FROM PricebookEntry WHERE Pricebook2.IsStandard = true AND IsActive = true
SELECT Id, FirstName, LastName, Title, Email, HasOptedOutOfEmail, Account.Name, Account.Industry FROM Contact WHERE AccountId != null

Usar los datos

Añade la conexión a un correo desde el panel Datos del estudio, con un alias (por ejemplo pipeline) y un rol:

  • Campos de combinación: {{pipeline.campo}} se resuelve con la primera fila. Útil para una cifra destacada.
  • Filas para repetir: alimentan un bloque de repetición, que repite su contenido por cada fila, por ejemplo una tarjeta por producto.
  • Las mismas filas alimentan los gráficos KPI, de barras, de líneas y circulares: un KPI que suma Amount es una cifra de pipeline abierto en vivo, y un gráfico de barras agrupado por StageName es el pipeline por etapa.

Una parte distinta para cada destinatario

Filtrar filas en un bloque de repetición y el filtro de un gráfico pueden comparar un campo de Salesforce con los datos del destinatario. Con una lista de audiencia que tenga una columna company, la regla Account.Name es igual a {{company}} muestra a cada minorista solo sus propias oportunidades, a partir de una sola consulta compartida. La copia de cada destinatario se genera con su propia fila en el momento del envío.

Importar tus contactos de Salesforce

Tu audiencia es una lista de contactos de MailInApp. Para llenarla desde Salesforce, crea una conexión por API con una consulta sobre Contact (la tercera de arriba) y luego ve a Contactos → Importar contactos y elige Conexión por API.

MailInApp lee las filas con las credenciales guardadas, reconoce los campos de Salesforce y ofrece Usar asignación de Salesforce: FirstName → first_name, Account.Name → company, Id → salesforce_id, etc. Un contacto con Email Opt Out (HasOptedOutOfEmail) marcado en Salesforce se señala en el paso de verificación, que ofrece dejarlo fuera. Un informe de Salesforce exportado en CSV se reconoce igual. Consulta Importar leads.

La importación es una copia: vuelve a ejecutarla para traer los contactos nuevos.

Consulta Correo interactivo con datos de Salesforce en vivo para un ejemplo completo: un resumen semanal del pipeline construido con esta conexión.