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.
Conecte o Salesforce ao Klaviyo
- Faça login no Klaviyo. Em seguida, selecione a aba 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 sandbox e, em seguida, clique em Instalar o app Klaviyo Client.
- 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.
Escolha um objeto do Salesforce para sincronizar
Depois de se conectar, você será solicitado a selecionar quais objetos do Salesforce deseja sincronizar na Klaviyo. Clique em Próximo para continuar.
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
- Outro (a disponibilidade depende da sua configuração do Salesforce)
Os objetos sincronizados do Salesforce serão criados ou atualizados como perfis da Klaviyo. Ao sincronizar vários objetos:
- Os registros 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 endereço de e-mail de um registro não existir 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.)
Mapeie os campos do Salesforce para as propriedades da Klaviyo
Em seguida, você vai mapear os campos do Salesforce para as propriedades do perfil do Klaviyo. Observe que alguns mapeamentos principais, como e-mail, número de telefone, nome e sobrenome, já vêm pré-mapeados. O mapeamento do endereço de e-mail do Salesforce é obrigatório.
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, o Klaviyo vai sincronizar no perfil o valor atualizado mais recentemente no Salesforce.
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 em Adicionar mapeamento → Importar mapeamentos.
- Baixe o modelo de CSV.
- Adicione o mapeamento de campo do Salesforce → Klaviyo ao modelo de CSV.
- Faça upload do CSV preenchido para aplicar os mapeamentos em massa.
Tratamento de cancelamento de inscrição (opcional)
Você pode ativar a opção de sincronizar o objeto do Salesforce como com a inscrição cancelada quando Email Opt Out estiver definido como true no objeto do Salesforce. Isso vai marcar o perfil como cancelar inscrição para e-mail no Klaviyo.
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.
Para verificar sua integração:
- Clique no menu suspenso Análises na Klaviyo e selecione Métricas. Filtre por Salesforce, depois encontre a métrica Tornou-se lead e clique no ícone do 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.
- O Klaviyo importa todos os seus leads do Salesforce. Para verificar isso, compare o número de leads adicionados ao Klaviyo em um determinado dia com o número de leads adicionados ao Salesforce e confirme se eles correspondem.
- Passe o mouse sobre o ponto de dados de ontem (no feed de atividades de Tornou-se lead, que você encontra ao clicar na métrica) ou consulte a tabela de dados abaixo do gráfico para ver quantos pagamentos ocorreram ontem e comparar com os dados armazenados no Salesforce.
- Se os dados não corresponderem, o problema provavelmente é que o fuso horário da sua conta do Klaviyo não corresponde ao fuso horário da sua conta do Salesforce. Para verificar sua configuração de fuso horário no Klaviyo:
- Clique no nome da sua conta no canto inferior esquerdo.
- Selecione e clique em Configurações > Organização.
- Role até Fuso horário.
Métricas do Salesforce na Klaviyo
Atualmente, a Klaviyo sincroniza uma métrica com o Salesforce CRM: Tornou-se um lead.
Essa métrica é rastreada quando um novo lead é criado no Salesforce. O evento em si não inclui nenhum dado do Salesforce, mas, quando esse evento é registrado, a Klaviyo vai sincronizar as seguintes propriedades personalizadas de cada lead e anexá-las ao perfil da Klaviyo do lead:
- ID
- Nome
- Sobrenome
- Cargo
- Empresa
- Rua
- Cidade
- Estado
- CEP
- País
- Latitude
- Longitude
- Telefone
- Site
- Origem do lead
- Status
- Setor
- Número de funcionários
- HasOptedOutOfEmail
- E-mail do Proprietário
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.
As conexões existentes com autenticação básica continuarão funcionando até que as credenciais expirem. No entanto, quando essas credenciais expirarem, elas não poderão ser redefinidas nem renovadas. Para manter sua integração do Salesforce conectada à Klaviyo, você precisará migrar para OAuth.
- Faça login na organização do Salesforce conectada à Klaviyo.
- No portal do Klaviyo, acesse a sua página de configurações de integrações do Salesforce. Deve haver um banner na parte superior da página dizendo "A autenticação OAuth agora é obrigatória". Na descrição do banner, clique no hyperlink que diz "app externo do Klaviyo" para instalar o pacote "Klaviyo Salesforce OAuth Connector" na sua organização do Salesforce.
- Quando a instalação terminar, volte para a página de configurações de integrações do Salesforce e clique em Atualizar. Depois, conclua o fluxo do OAuth.
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, pesquise seus pacotes instalados no Salesforce para verificar se o pacote "Klaviyo Salesforce OAuth Connector" está instalado. Se ele 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ê tiver uma integração existente e estiver migrando para OAuth, clique no texto com hiperlink "App externa da Klaviyo" para instalar o pacote (consulte 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 a sua empresa tiver várias organizações do Salesforce, ao reautenticar a integração, verifique se você está conectado à organização do Salesforce que está vinculada ao Klaviyo no momento.
Se você estiver conectado a uma organização diferente do Salesforce, 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: Desinstale a integração do Salesforce na Klaviyo, reinstale-a e conclua o fluxo de configuração da integração do Salesforce 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,
- Acesse sua integração do Salesforce na Klaviyo.
- Abra o objeto afetado.
- Atualize ou remova o mapeamento de campo inválido.
- Salve suas alterações.
Depois de atualizada, a sincronização continuará conforme esperado.
Quando um campo obrigatório (e-mail) fica indisponível
Se o campo Email do Salesforce não estiver mais disponível para um objeto (por exemplo, devido a alterações no esquema ou permissões), a Klaviyo vai:
- Exibir um erro indicando que o campo Email 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,
- Acesse sua integração do Salesforce na Klaviyo.
- Abra o objeto afetado.
- Garanta que um campo válido de e-mail do Salesforce esteja mapeado para a propriedade E-mail da Klaviyo.
- Salve suas alterações.
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 que um campo de e-mail válido for mapeado e os registros incluírem endereços de e-mail, a Klaviyo vai criar ou atualizar esses perfis na próxima sincronização.
Resultado
Agora você integrou sua conta da Klaviyo ao Salesforce CRM e revisou seus dados sincronizados.