E-mail Interativo Alimentado por Dados do Salesforce ao Vivo

O Salesforce autentica integrações servidor a servidor com um JWT assinado, não uma senha — e a fonte de dados via API do MailInApp fala esse fluxo nativamente. Conecte uma vez, e um scorecard de KPI ou bloco de gráfico podem se vincular diretamente a linhas ao vivo de Opportunity, Account ou Contact, sem refresh token para vigiar e sem CSV para reexportar antes de cada envio.

A maioria dos e-mails de "pipeline semanal" é uma captura de tela de um relatório, desatualizada no momento em que alguém a cola. Vincular um bloco de gráfico diretamente a uma fonte de dados apoiada no Salesforce faz com que o próprio número do bloco venha de uma consulta SOQL real — e um envio recorrente executa essa consulta de novo a cada envio, então o resumo de segunda-feira realmente reflete o pipeline de segunda-feira.

Como a conexão funciona

Este é o mesmo fluxo JWT Bearer que o Salesforce documenta para suas próprias integrações servidor a servidor, conectado aos modos de autenticação OAuth2 já existentes do MailInApp para fontes de dados via API, em vez de uma integração feita sob medida só para o Salesforce.

Configure um Connected App uma única vez

No Salesforce Setup, crie um Connected App, ative as configurações OAuth, e envie um certificado autoassinado em Use digital signatures — o certificado vai para o Salesforce, a chave privada RSA pareada vai para o MailInApp. Defina Permitted Users como Admin approved users are pre-authorized, que é o que torna a troca não interativa: não há tela de consentimento para um script passar. Anote o Consumer Key do Connected App e a URL My Domain da sua organização — ambos entram na conexão no MailInApp.

Aponte para uma consulta SOQL

O Endpoint da fonte de dados é uma URL de consulta REST, e a string de consulta é o próprio dado que você recebe de volta:

SELECT Name, Amount, StageName, CloseDate FROM Opportunity WHERE IsClosed = false

Defina o Data path como records — o Salesforce envolve os resultados da consulta em um array records. Campos de relacionamento como Owner.Email voltam aninhados e são descartados pelo interpretador de linhas do MailInApp, então mantenha a consulta simples; selecione OwnerId em vez disso se precisar de um identificador de proprietário para filtrar ou combinar depois.

Vincule blocos diretamente, não tags de personalização

Adicione a conexão a um projeto pelo painel de Dados do estúdio com uma função collection — a mesma vinculação que um bloco de repetição usa. A partir daí, os blocos de scorecard de KPI, barras, linha e pizza podem se vincular diretamente a ela no próprio Inspetor:

• Um scorecard de KPI definido como Amount com um agregado Soma se torna um número ao vivo de "pipeline total em aberto".
• Um gráfico de barras agrupado por StageName, com Amount como sua série (agregado Soma de novo), se torna uma distribuição de pipeline por estágio.

Nenhum dos dois blocos precisa de uma única tag de personalização digitada à mão — a vinculação faz o trabalho, e ambos continuam corretos conforme os negócios mudam de estágio ou fecham.

Envie em um agendamento

Um envio recorrente semanal executa a consulta SOQL de novo e renderiza os dois blocos de novo contra as linhas atuais do Salesforce toda vez que dispara — a mesma estrutura de resumo, números novos toda segunda-feira, sem ninguém reconstruir isso à mão. Um bloco Botão apontado para a URL do Salesforce de cada Opportunity dá a quem lê o resumo uma forma de abrir com um clique o registro por trás de um número que chama a atenção.

Começando

Crie um Connected App do Salesforce com um certificado para o fluxo JWT Bearer, conecte-o na aba Fontes de Dados do MailInApp com seu Consumer Key, nome de usuário de integração e chave privada, aponte o endpoint para uma consulta SOQL com records como data path, depois vincule um scorecard de KPI e um gráfico de barras a ela pelo painel de Dados do estúdio. Veja o guia de integração do Salesforce para a configuração completa campo a campo.