Salesforce autentica las integraciones servidor-a-servidor con un JWT firmado, no con una contraseña — y la fuente de datos por API de MailInApp habla ese flujo de forma nativa. Conéctate una vez, y una tarjeta de indicador clave o un bloque de gráfico pueden vincularse directamente a filas en vivo de Opportunity, Account o Contact, sin token de actualización que vigilar y sin CSV que volver a exportar antes de cada envío.
La mayoría de los correos de «pipeline semanal» son una captura de pantalla de un informe, desactualizada en el momento en que alguien la pega. Vincular un bloque de gráfico directamente a una fuente de datos respaldada por Salesforce hace que el propio número del bloque provenga de una consulta SOQL real — y un envío recurrente vuelve a ejecutar esa consulta en cada envío, así que el resumen del lunes realmente refleja el pipeline del lunes.
Cómo funciona la conexión
MailInApp
Firma un JWT con la clave privada de tu Connected App
Endpoint de token de Salesforce
Verifica la firma y devuelve un token de acceso
API REST de Salesforce
Ejecuta tu consulta SOQL, autenticada con token Bearer
Tu correo
Tarjeta de indicador clave y bloques de gráfico vinculados en vivo a las filas
Cada paso ocurre del lado del servidor en cada envío. Nunca se envía una contraseña, y no hay token de actualización — un token vencido se reemplaza firmando una nueva afirmación.
Este es el mismo flujo de JWT Bearer que Salesforce documenta para sus propias integraciones servidor-a-servidor, integrado en los modos de autenticación OAuth2 ya existentes de MailInApp para fuentes de datos por API, en lugar de una integración específica para Salesforce hecha a medida.
Configura un Connected App una sola vez
En Salesforce Setup, crea un Connected App, activa OAuth settings, y sube un certificado autofirmado bajo Use digital signatures — el certificado va a Salesforce, y la clave privada RSA emparejada va a MailInApp. Configura Permitted Users en Admin approved users are pre-authorized, que es lo que hace que el intercambio sea no interactivo: no hay pantalla de consentimiento que un script deba pasar. Anota la Consumer Key del Connected App y la URL de My Domain de tu org — ambas van a la conexión en MailInApp.
Apúntalo a una consulta SOQL
El Endpoint de la fuente de datos es una URL de consulta REST, y la cadena de consulta es el dato real que recibes de vuelta:
SELECT Name, Amount, StageName, CloseDate FROM Opportunity WHERE IsClosed = false
Configura la Ruta de datos como records — Salesforce envuelve los resultados de su consulta en un arreglo records. Los campos de relación como Owner.Email regresan anidados y el analizador de filas de MailInApp los descarta, así que mantén la consulta plana; selecciona OwnerId en su lugar si necesitas un identificador de propietario para filtrar o combinar más adelante.
Vincula bloques directamente, no etiquetas de combinación
Añade la conexión a un proyecto desde el panel de Datos del estudio con un rol de colección — el mismo enlace que usa un bloque de repetición. Desde ahí, los bloques de tarjeta de indicador clave, barras, líneas y circular pueden vincularse directamente a ella desde su propio Inspector:
- Una tarjeta de indicador clave configurada en
Amountcon un agregado Suma se convierte en una cifra en vivo de «pipeline abierto total». - Un gráfico de barras agrupado por
StageName, conAmountcomo su serie (agregado Suma de nuevo), se convierte en un desglose de pipeline por etapa.
Ninguno de los dos bloques necesita una sola etiqueta de combinación escrita a mano — el enlace hace el trabajo, y ambos se mantienen correctos a medida que los tratos cambian de etapa o se cierran.
Envíalo con una programación
Un envío recurrente semanal vuelve a ejecutar la consulta SOQL y vuelve a renderizar ambos bloques contra las filas actuales de Salesforce cada vez que se dispara — la misma estructura de resumen, cifras nuevas cada lunes, sin que nadie lo reconstruya a mano. Un bloque de Botón apuntado a la URL de Salesforce de cada Opportunity le da a cualquiera que lea el resumen una forma de abrir con un clic el registro detrás de un número que le llama la atención.
Primeros pasos
Crea un Connected App de Salesforce con un certificado para el flujo JWT Bearer, conéctalo en la pestaña de Fuentes de datos de MailInApp con tu Consumer Key, el nombre de usuario de integración y la clave privada, apunta el endpoint a una consulta SOQL con records como ruta de datos, y luego vincula una tarjeta de indicador clave y un gráfico de barras a ella desde el panel de Datos del estudio. Consulta la guía de integración con Salesforce para la configuración completa campo por campo.