Fazer upload dos seus e-mails para o Pardot

O Emailify tem uma integração nativa com o Pardot, que faz o upload de e-mails HTML direto do plugin para Figma para os seus templates do Pardot.

O Pardot agora se chama Account Engagement no Salesforce Marketing Cloud.

Vídeo tutorial: fazer upload dos seus e-mails para o Pardot

Este vídeo mostra como fazer upload de e-mails HTML do plugin Emailify para Figma para o Pardot.

Se você precisar de links com AMPscript (por exemplo, %%=v(@url)=%%) nos seus parágrafos de texto, o campo de link nativo do Figma vai bloqueá-los como URLs inválidas. Para contornar isso, use o formato especial de link AMPscript do Emailify, https://ampscript.invalid/?%%=v(@url)=%%, e o Emailify vai gerar a tag AMPscript bruta no HTML exportado.

1. Criar um Connected App no Pardot ​

Se você ainda não tiver um configurado, precisa criar um novo Connected App no Pardot. É ele que fornece a Consumer Key e o Consumer Secret que você vai colar no plugin no Passo 3 (Autenticar no Pardot).

  1. No canto superior direito do admin do Pardot, clique no Settings Icon e depois em Setup.
  2. Na barra de pesquisa das configurações, procure “App Manager” e clique no resultado App Manager.
  3. Clique no botão New Connected App.
  4. Dê um nome ao seu Connected App (por exemplo, Emailify Integration).
  5. Adicione os dados de contato do responsável pelo Connected App.
  6. Marque a caixa de seleção Enable OAuth Flows.
  7. Adicione https://figma.com/ como Callback URL.
  8. Em Selected OAuth Scopes, adicione os escopos abaixo, que permitem ao app acessar o Pardot e se autenticar nele:
  • 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. Marque a caixa de seleção Require Secret for Web Server Flow.
  2. Se aparecer, confirme que a opção Require Proof Key for Code Exchange (PKCE) Extension for Supported Authorization Flows não está marcada.
  3. Clique em Save.

2. Encontrar o Business Unit ID do Pardot ​

O Business Unit ID é um ID de 18 caracteres que começa com “0Uv”. Para encontrar o Business Unit ID do seu Pardot, siga os passos abaixo:

  1. Entre no Salesforce com a mesma conta que você usa para entrar no Pardot.
  2. Clique na aba Setup.
  3. Encontre o menu suspenso Pardot e clique em Pardot Account Setup.
  4. Você pode ter várias unidades de negócio (business units) no Pardot; escolha o Business Unit ID da que você quer usar com o Emailify.

3. Autenticar no Pardot ​

No painel de exportação do Emailify, selecione a opção Pardot (API) ou uma opção de conta de teste do Pardot na lista suspensa e copie e cole as seguintes credenciais e dados do Pardot nos campos das configurações de exportação do Emailify:

  • Pardot Business Unit ID (por exemplo, 0UvXXXXXXXXXXXXXXX)
  • Pardot Username que você usa para entrar (por exemplo, [email protected])
  • Pardot Password que você usa para entrar (por exemplo, *********)
  • Consumer Key do seu Connected App (por exemplo, y0Zd2jVHJ5Cc1wQg0l5yMJsXpPs...)
  • Consumer Secret do seu Connected App (por exemplo, 8C8F8D11A3B7B026A90C5C3...)

Depois que você colar todos esses dados, o Emailify vai se autenticar na sua instância do Pardot.

Opções de endpoint da API do Pardot no Emailify ​

Se você usa uma instância de teste ou sandbox, pode selecionar outras opções de exportação pela API do Pardot nas opções de exportação do Emailify. Veja abaixo quais endpoints cada uma chama:

Opção do EmailifyDomínio de autorizaçãoDomínio de conteúdo
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

Solução de problemas de autenticação no Pardot ​

Se você estiver com dificuldade para se autenticar com o nome de usuário e a senha do Pardot, o problema mais comum é que a autenticação multifator (MFA) do Salesforce foi ativada para o usuário do Salesforce do qual a sua integração depende.

O motivo mais comum para a autenticação no Pardot falhar está ligado a problemas de 2FA, mas muitas vezes isso pode ser resolvido no Pardot assim:

  • Alterando a configuração IP Relaxation para Relax IP Restrictions
  • Alterando a configuração Permitted Users para All users may self-authorize
  • Ativando a opção Allow OAuth Username-Password Flows em OAuth and OpenID Connect Settings
  • As senhas não podem conter caracteres especiais (por exemplo, # % & etc.) e só podem ter letras e números (por exemplo, mypa55word1234)

Garantir que os usuários de integração por API funcionem com o MFA do Salesforce ​

O MFA do Salesforce é exigido principalmente em logins interativos pela interface. Integrações baseadas em API normalmente continuam funcionando sem solicitações interativas de MFA, mas o admin do Salesforce precisa configurar corretamente o usuário de integração.

Para o fluxo de upload pela API do Pardot no Emailify, a boa prática é usar uma conta de usuário de integração dedicada no Salesforce em vez de um login pessoal compartilhado.

Se a sua edição do Salesforce inclui licenças de usuário Salesforce Integration, atribua uma delas ao usuário de integração dedicado que o Emailify usa.

Vantagens:

  • Esses usuários foram criados para acesso somente por API.
  • Eles não podem entrar na interface do Salesforce, então ficam naturalmente isentos das solicitações de MFA da interface.
  • Eles ajudam a manter a sua integração separada das contas de usuário normais.
  • O perfil somente de API deles normalmente já vem com API Enabled ativado.

Para verificar se essas licenças estão disponíveis:

  1. No Salesforce, acesse Setup.
  2. Procure Company Information.
  3. Abra Company Information.
  4. Procure Salesforce Integration na lista User Licenses.
Alternativa: dispensar o MFA da interface para um usuário padrão do Salesforce ​

Se você não puder usar uma licença de usuário Salesforce Integration e a sua integração usar um usuário padrão do Salesforce, o admin do Salesforce pode isentar esse usuário de integração dedicado do MFA da interface atribuindo a ele um Permission Set com a permissão de sistema Waive Multi-Factor Authentication for Exempt Users.

Para configurar isso:

  1. No Salesforce, acesse Setup.
  2. Procure Permission Sets.
  3. Crie um novo Permission Set para o seu usuário de integração.
  4. Abra System Permissions e clique em Edit.
  5. Ative Waive Multi-Factor Authentication for Exempt Users.
  6. Salve o Permission Set.
  7. Atribua esse Permission Set ao usuário de integração dedicado.

Se você usa uma licença de usuário padrão do Salesforce para a integração, confirme também que o Profile do usuário continua com API Enabled ativado em System Permissions.

Recomendações adicionais ​
  • Prefira um usuário de integração dedicado em vez de uma conta de usuário pessoal.
  • Se você usa autenticação por nome de usuário e senha, guarde essas credenciais e qualquer token de segurança em um local seguro.
  • Teste a conexão com o Pardot em um sandbox antes de ativar mudanças relacionadas ao MFA em produção.
  • Se a autenticação começar a falhar depois da implantação do MFA, confira o Login History do usuário do Salesforce para ver o motivo exato da falha.
Referências do Salesforce ​

4. Fazer upload de templates de e-mail para o Pardot ​

Depois que a conexão com a API do Pardot for autenticada, você vai poder informar os seguintes campos obrigatórios nos campos e listas suspensas que aparecerem:

  • Sender Name

  • Sender Address

  • Campaign Name

  • Folder Name

  • Domain Tracking Name

Se quiser, você pode adicionar tags de regiões de conteúdo do Pardot ao template exportado:

  • Editable Regions permite que os usuários editem textos, imagens e botões.
  • Repeatable Regions permite que os usuários copiem ou movam blocos de conteúdo de nível superior desbloqueados. Esses blocos compartilham um mesmo nome de região repetível (body_content), então blocos diferentes podem passar uns pelos outros.
  • Removable Regions permite que os usuários removam blocos de conteúdo de nível superior desbloqueados.

Ative qualquer combinação dessas opções antes de fazer o upload ou exportar o template. Quando Repeatable Regions e Removable Regions estão ativadas ao mesmo tempo, o Emailify coloca os dois atributos no mesmo wrapper de cada bloco desbloqueado. Os wrappers repetíveis compartilham o nome body_content e ficam lado a lado, o que permite mover blocos diferentes dentro do grupo. Não existe um wrapper removível separado em volta de cada bloco repetível.

Manter cabeçalhos e rodapés fixos ​

No Figma, bloqueie o cabeçalho, o rodapé ou outra camada pai diretamente dentro do frame de e-mail do Emailify antes de exportar. O Emailify exporta as camadas de nível superior bloqueadas sem tags de região repetível ou removível, incluindo todos os blocos gerados a partir de um grupo pai bloqueado. Deixe as camadas do corpo desbloqueadas para que os usuários possam reordená-las com Repeatable Regions ativada.

Bloqueie a própria camada de nível superior: bloquear apenas uma camada de texto ou de imagem aninhada não bloqueia o bloco pai. Isso controla a cópia, a movimentação e a remoção de blocos inteiros. A opção Editable Regions continua controlando a edição de textos, imagens e botões dentro deles. Desbloqueie a camada pai e exporte de novo para que o bloco volte a ser repetível ou removível.

Depois de selecionar as opções desejadas acima, quando estiver pronto, clique no botão Upload To Pardot para começar a exportar para HTML os e-mails que você selecionou no Figma e fazer o upload automático deles para os seus templates de e-mail no Pardot.