Como integrar com o Salesforce CRM
O que você vai aprender
Saiba como integrar o Salesforce CRM com a Klaviyo. Essa integração facilita conectar sua conta do Salesforce, escolher quais objetos sincronizar e mapear campos — tudo por meio de um fluxo de configuração guiado no aplicativo.
Com essa integração, a Klaviyo pode sincronizar automaticamente dados do Salesforce (como leads ou contatos) com perfis da Klaviyo, permitindo que você personalize as mensagens e segmente clientes usando dados do CRM.
Antes de começar
Antes de começar, confirme se:
- Você está conectado à sua conta do Salesforce.
- Se a sua empresa tiver várias organizações do Salesforce, verifique se você está conectado(a) à organização correta.
- Você tem acesso de administrador à sua conta do Salesforce.
- Sua organização do Salesforce tem acesso à API, e seu usuário do Salesforce tem permissão para usar a API.
Conecte o Salesforce ao Klaviyo
- Faça login na Klaviyo. Em seguida, selecione a guia Integrações.
- Clique em Explorar apps para abrir o Klaviyo App Marketplace. Pesquise e abra a listagem do appSalesforce . Em seguida, clique em Instalar.
- Você será redirecionado para o fluxo de configuração da integração com o Salesforce. Na etapa 1, selecione se você está se conectando a uma organização do Salesforce de Produção ou de Sandbox e clique em Instalar o aplicativo cliente do Klaviyo.
- No Salesforce, siga o assistente de instalação para reconhecer e instalar o pacote "Klaviyo Salesforce OAuth Connector" na organização do Salesforce que você está conectando ao Klaviyo.
- Quando a instalação estiver concluída, volte para a página de configuração da integração com o Salesforce no Klaviyo. Em seguida, siga a etapa 2 e clique em Conectar ao Salesforce.
- Clique em Permitir para concluir o fluxo OAuth e terminar de conectar o Klaviyo ao Salesforce.
Selecione os objetos do Salesforce para sincronizar
Após se conectar, você será solicitado a selecionar quais objetos do Salesforce você quer sincronizar com a Klaviyo.
Agora você pode escolher até 3 objetos para sincronizar com a Klaviyo. As opções disponíveis incluem:
- Lead - Clientes em potencial que demonstraram interesse em seus produtos ou serviços do Salesforce
- Contato - Indivíduos associados a contas na sua organização do Salesforce
- Conta - Organizações ou indivíduos envolvidos com sua empresa (como clientes, concorrentes e parceiros)
- Oportunidade - Vendas ou negócios em potencial
- Outros - Insira uma lista separada por vírgulas de nomes de objetos adicionais do Salesforce, como Case ou Order. Os objetos precisam estar disponíveis na sua organização do Salesforce.
Os objetos sincronizados do Salesforce serão criados ou atualizados como perfis da Klaviyo. Ao sincronizar vários objetos:
- Registros com endereços de e-mail válidos de todos os objetos selecionados serão sincronizados com o Klaviyo.
- Se o endereço de e-mail de um registro corresponder a um perfil existente do Klaviyo, esse perfil será atualizado.
- Se o registro não corresponder a um perfil existente na Klaviyo, um novo perfil será criado.
- Se a mesma pessoa existir em vários objetos sincronizados com o mesmo endereço de e-mail, o Klaviyo vai consolidá-la em um único perfil com base no e-mail. (Os mapeamentos de campos são configurados por objeto na próxima etapa.)
Depois de selecionar seus objetos, clique em Próxima para configurar o mapeamento de campos deles.
Mapeie os campos do Salesforce para as propriedades da Klaviyo
Em seguida, você vai mapear os campos do Salesforce para as Propriedades do perfil da Klaviyo. Os mapeamentos principais, como e-mail, número de telefone, nome e sobrenome, já ficam pré-mapeados quando esses campos estão disponíveis no objeto selecionado. Cada objeto exige que um campo do Salesforce que contenha endereços de e-mail válidos seja mapeado para a propriedade E-mail da Klaviyo.
Quando você selecionar vários objetos do Salesforce para sincronizar, você vai configurar os mapeamentos de campo separadamente para cada objeto. Isso permite que você controle quais campos de cada objeto se tornam Propriedades do perfil do Klaviyo.
Adicionar ou editar mapeamentos
- Use Adicionar mapeamento para mapear outros campos do Salesforce para o objeto selecionado no momento.
- Selecione um campo do Salesforce à esquerda e a propriedade correspondente da Klaviyo à direita.
- Remova os mapeamentos usando o ícone de lixeira, se necessário.
- Repita esse processo para cada objeto sincronizado.
Se a mesma Propriedade do perfil do Klaviyo (por exemplo, número de telefone ou cidade) for mapeada a partir de vários objetos do Salesforce, a sincronização de um objeto pode sobrescrever o valor sincronizado a partir de outro. Mapeie os campos para propriedades personalizadas separadas se você precisar manter o valor de cada objeto.
Importe mapeamentos por CSV (opcional)
As importações de CSV substituem todos os mapeamentos de campo existentes para o objeto selecionado. Se um campo não estiver incluído no arquivo, ele será removido da sua configuração. Para evitar interrupções na sincronização, confirme se o seu CSV inclui todos os campos obrigatórios (como Email) e quaisquer campos adicionais que você queira continuar sincronizando.
Para importar seus mapeamentos via CSV:
- Clique no menu suspenso ao lado de Adicionar mapeamento e selecione Importar mapeamentos.
- Clique em Fazer download do modelo CSV.
- Adicione o mapeamento de campo do Salesforce → Klaviyo ao modelo de CSV.
- Faça upload do CSV concluído e, em seguida, clique em Importar para aplicar os mapeamentos em massa.
Tratamento de cancelamento de inscrição (opcional)
Selecione Sincronizar cancelar inscrição do Salesforce para marcar o perfil da Klaviyo como com inscrição cancelada para e-mail quando Email Opt Out estiver como true no Salesforce. Esta opção está disponível apenas quando o objeto selecionado tem o campo Email Opt Out. Alterar Email Opt Out de volta para false não faz com que o perfil seja inscrito novamente na Klaviyo.
Se você selecionou vários objetos, clique em Próximo depois de configurar cada objeto para passar para o próximo. No último objeto, conclua a configuração conforme descrito abaixo.
Concluir configuração
Quando seus mapeamentos estiverem concluídos, clique em Concluir configuração. A Klaviyo vai finalizar a integração (isso geralmente leva alguns segundos). Você verá uma mensagem de confirmação assim que sua conta do Salesforce estiver conectada e sincronizando com sucesso.
Monitore a sincronização do Salesforce e verifique os dados
A integração do Salesforce sincroniza com o Klaviyo a cada hora.
Verifique os dados do perfil
- Acesse Público > Perfis.
- Procure o endereço de e-mail de um registro do Salesforce e pressione Enter.
- Abra o perfil correspondente e compare as propriedades mapeadas dele com o Salesforce.
Se você sincronizar o objeto Lead, marque também os eventos Became Lead:
- Acesse Análises > Métricas, filtre por Salesforce e clique em Virou lead. Selecione Feed de atividades.
- Se a sua integração tiver começado a sincronizar dados, você verá eventos de Tornou-se lead, com o ícone do Salesforce, adicionados a este feed de atividades.
- Para comparar a atividade diária de leads, selecione Gráfico e use o mesmo intervalo de datas do Salesforce. Somente registros com endereços de e-mail válidos são sincronizados, e vários registros com o mesmo endereço de e-mail podem compartilhar um perfil da Klaviyo.
- Passe o mouse sobre o ponto de dados de ontem ou use a tabela abaixo do gráfico para verificar o número de eventos de Tornou-se lead e, em seguida, compare com seus dados de leads do Salesforce.
- Se as contagens estiverem diferentes, verifique se você está comparando o mesmo fuso horário e leve em conta a sincronização por hora. Verifique também se há endereços de e-mail ausentes ou inválidos. Para conferir o fuso horário do Klaviyo:
- Clique no nome da sua conta no canto inferior esquerdo.
- Selecione Configurações > Conta.
- Role até Fuso horário.
Métricas do Salesforce e propriedades do perfil no Klaviyo
A Klaviyo sincroniza a métrica Tornou-se lead quando você sincroniza o objeto Lead. O evento usa a data de criação do lead no Salesforce e não inclui campos do Salesforce nos dados do evento. Outros objetos do Salesforce atualizam Propriedades do perfil sem criar eventos Became Lead.
As Propriedades do perfil sincronizadas de cada objeto dependem dos mapeamentos de campos dele. Quando os campos correspondentes do Salesforce estão disponíveis, a Klaviyo preenche previamente estes mapeamentos:
- FirstName → Primeiro nome
- LastName → Sobrenome
- Título → Título
- Empresa → Organização
- Rua → Endereço 1
- Cidade → Cidade
- Estado → Região
- CódigoPostal → CEP
- País → País
- Latitude → Latitude
- Longitude → Longitude
- Telefone → Número de telefone
- E-mail → E-mail
Para sincronizar outros campos disponíveis, como Website, LeadSource, Status, Industry ou NumberOfEmployees, adicione mapeamentos para eles.
Em seguida, você pode usar essas propriedades em segmentos, em fluxos e para preencher dinamicamente as propriedades do cliente nos seus modelos de mensagem.
Solução de problemas
Problemas com instalação e autenticação
Migrar da autenticação básica para OAuth
Se você configurou a integração do Salesforce antes de o OAuth ser compatível, seu aplicativo do Salesforce pode estar conectado à Klaviyo usando autenticação básica.
Se a sua integração mostrar agora é necessário usar a autenticação OAuth, faça a migração seguindo as etapas abaixo. Enquanto este aviso de migração estiver sendo exibido, você não poderá atualizar as credenciais de autenticação básica no Klaviyo.
- Faça login na organização do Salesforce conectada ao Klaviyo.
- Na Klaviyo, abra a aba Configurações da suaintegração do Salesforce. No banner A autenticação OAuth agora é obrigatória, clique em app externo da Klaviyo para instalar o pacote “Klaviyo Salesforce OAuth Connector” na organização do Salesforce conectada.
- Quando a instalação terminar, volte à guia Configurações da sua integração com o Salesforce e clique em Atualizar. Quando solicitado no Salesforce, clique em Permitir para concluir a conexão.
Para mais informações, confira a seção "Conectar o Salesforce à Klaviyo" no topo deste guia.
Erro “O aplicativo externo da Klaviyo não está instalado. Instale e tente novamente.”
Esse erro indica que a org do Salesforce com a qual você está tentando fazer a autenticação (ou reautenticação) não tem o pacote “Klaviyo Salesforce OAuth Connector” instalado.
Verifique se:
- Você está conectado ao Salesforce.
- Você está conectado à organização do Salesforce integrada ao Klaviyo. Se sua empresa tiver várias organizações do Salesforce, talvez você esteja conectado à organização errada.
- Se você estiver conectado à organização correta do Salesforce e ainda estiver recebendo esse erro, procure seus pacotes instalados no Salesforce para verificar se o pacote “Klaviyo Salesforce OAuth Connector” está instalado. Se não estiver instalado, repita a etapa 1 no fluxo de configuração da integração para instalar o pacote (consulte a seção “Conectar o Salesforce ao Klaviyo” no início deste guia). Ou, se você já tinha uma integração e está migrando para o OAuth, clique no texto com hyperlink “aplicativo externo do Klaviyo” para instalar o pacote (veja a seção “Migrar para OAuth” acima).
Se o problema persistir, entre em contato com o suporte.
Mensagem de erro de incompatibilidade de conta
Se sua empresa tiver várias organizações do Salesforce, confirme se você está conectado à organização do Salesforce que está atualmente conectada ao Klaviyo ao reautenticar a integração.
Se a Klaviyo detectar que você está se reconectando a uma organização do Salesforce diferente, você verá um erro de incompatibilidade de conta:
Para resolver o erro, faça um dos seguintes procedimentos:
- Reconecte a organização do Salesforce existente: feche a janela, saia do Salesforce, depois faça login na organização do Salesforce atualmente conectada ao Klaviyo e tente novamente.
- Conectar uma organização diferente do Salesforce: remover a integração exclui os mapeamentos de objetos do Salesforce, que você precisará configurar novamente. Clique em Remover integração, reinstale a integração do Salesforce no Klaviyo e conclua a configuração usando a nova organização do Salesforce.
Avisos e erros de mapeamento de campos
O Klaviyo valida continuamente seus mapeamentos de campos do Salesforce para garantir que os dados possam ser sincronizados com confiança. Se um campo do Salesforce mapeado ficar indisponível (por exemplo, se ele for excluído, renomeado ou se as permissões mudarem), você poderá ver um aviso ou erro nas configurações da sua integração.
Quando um campo não obrigatório está indisponível
Se um campo mapeado do Salesforce não estiver mais disponível e não for obrigatório, a Klaviyo vai:
- Exiba um aviso indicando qual campo está faltando.
- Continue sincronizando todos os outros campos disponíveis.
- Exclua o campo indisponível de futuras sincronizações até que ele seja atualizado ou removido.
Para resolver isso:
- Abra sua integração do Salesforce no Klaviyo e selecione Configurações.
- Abra o menu de ações do objeto afetado e selecione Editar.
- Atualize ou remova o mapeamento de campo inválido.
- Clique em Save.
- Uma sincronização histórica pode substituir os valores atuais do perfil, mas não remove as Propriedades do perfil existentes. Selecione Executar sincronização histórica para aplicar os mapeamentos corrigidos aos registros existentes ou Pular sincronização para continuar com as atualizações regulares por hora.
Depois de atualizada, a sincronização continuará conforme esperado.
Quando o campo mapeado para E-mail não está disponível
Se o campo do Salesforce mapeado para a propriedade Email do Klaviyo não estiver mais disponível para um objeto (por exemplo, devido a alterações no esquema ou permissões), o Klaviyo:
- Exiba um erro indicando que o campo mapeado para E-mail está ausente.
- Interrompa a sincronização de dados do objeto afetado.
- Uma solicitação para você atualizar seus mapeamentos de campo para restaurar a sincronização.
Para resolver isso:
- Abra sua integração do Salesforce no Klaviyo e selecione Configurações.
- Abra o menu de ações do objeto afetado e selecione Editar.
- Mapeie um campo disponível do Salesforce que contenha endereços de e-mail válidos para a propriedade E-mail da Klaviyo.
- Clique em Save.
- Uma sincronização histórica pode substituir os valores atuais do perfil, mas não remove as Propriedades do perfil existentes. Selecione Executar sincronização histórica para tentar novamente os registros existentes com o mapeamento de e-mail corrigido ou Pular sincronização para continuar com as atualizações regulares por hora.
Quando o campo Email for mapeado novamente com sucesso, a sincronização de dados será retomada automaticamente.
Perfis ausentes no Klaviyo
Se os registros do Salesforce não estiverem aparecendo como perfis na Klaviyo, primeiro verifique se um campo de e-mail válido está mapeado para cada objeto que você está sincronizando. A Klaviyo usa o endereço de e-mail como o identificador obrigatório para criar ou atualizar perfis; registros sem um campo de e-mail mapeado ou sem valores de e-mail válidos não serão sincronizados como perfis. Garanta que:
- Um campo de e-mail do Salesforce é mapeado para a propriedade E-mail do Klaviyo para cada objeto selecionado.
- O campo de e-mail mapeado contém valores de e-mail reais no Salesforce — e-mails em branco ou inválidos podem impedir que os registros sejam sincronizados como perfis.
Depois de corrigir o mapeamento de e-mail, salve suas alterações e selecione Executar sincronização histórica para tentar novamente os registros existentes. Se você corrigiu os valores de e-mail no Salesforce, esses registros atualizados serão capturados na próxima sincronização por hora.
Resultado
Agora você integrou sua conta da Klaviyo ao Salesforce CRM e revisou seus dados sincronizados.
Recursos adicionais
- Getting started with flows
Learn how to use flows, also known as automations or drip campaigns, in Klaviyo for personalized and automated communications to your customers, and learn how to set your first flow live.
- Getting started with segments
Learn how to create and use segments in Klaviyo, which are a powerful tool for understanding your audience and sending targeted messages.
- Understanding the types of information exchanged between Klaviyo and apps
Learn about what types of data are exchanged between Klaviyo and external apps, and where that data is found in your Klaviyo account. When you integrate a third-party application with Klaviyo, the two platforms exchange information. Most data exchange with Klaviyo is one-way; data is pulled into your Klaviyo account so you can leverage a broad scope of your customers' data within Klaviyo.