Os atributos que você mapeia entre Intercom e Salesforce são sincronizados quando mudam em qualquer um dos sistemas. Quando a mudança ocorre no Intercom, a sincronização para Salesforce é acionada imediatamente, enquanto o Salesforce é verificado a cada 5 minutos para determinar se há mudanças para sincronizar com o Intercom. Veja as tabelas abaixo para detalhes sobre como os dados são atualizados em diferentes situações.

Os seguintes gatilhos no Intercom farão com que os dados sejam atualizados no Salesforce. O comportamento em cada um desses casos é diferente dependendo se já existe uma correspondência entre uma pessoa (lead/user) no Intercom e uma pessoa (lead/contact) no Salesforce. Essa correspondência é chamada de “mapeamento de identidade”.

O Intercom verifica o Salesforce para quaisquer mudanças (leads & contacts novos ou atualizados) a cada 5 minutos e, quando encontrados, atualiza as informações no Intercom.

Como o app Salesforce depende da configuração padrão que o Salesforce oferece, pode haver momentos em que a integração falhe ao instalar ou funcionar como esperado. Se você encontrar um erro, este guia de solução de problemas deve ajudar a identificar e corrigir o problema.

As seguintes ações ocorrem:

Não retemos dados históricos ou registros sobre configurações passadas ou atributos mapeados que foram configurados anteriormente dentro do app Salesforce.

Se for necessário desinstalar e reinstalar o app, recomendamos fortemente que você tire capturas de tela ou registre claramente suas configurações antes de executar qualquer processo de 'uninstall' para que possam ser facilmente replicadas após a reinstalação. As configurações não serão mantidas ou recuperadas após reinstalar o app.

A aba “Sync Errors” nas configurações do app Salesforce mostrará quaisquer erros que ocorram ao sincronizar dados entre Intercom e Salesforce. Exibimos quando o erro ocorreu e o que o causou. Passe o mouse sobre uma linha e clique no botão “Details” para saber mais sobre esses problemas.

Sync Errors mostrará apenas erros da sincronização de dados do Intercom para o Salesforce.

Você também pode tentar sincronizar novamente. Se o Intercom conseguir sincronizar, o erro será removido da lista:

Para saber mais sobre quando os atributos são sincronizados, leia este artigo.

O erro "FIELD_FILTER_VALIDATION_EXCEPTION: este campo deve conter um valor" é comumente exibido se o Salesforce exigir um campo específico para casos que não está aparecendo na barra lateral do criador de casos no Intercom.

Para resolver isso, siga os passos abaixo:

1. Acesse o Salesforce e verifique suas configurações para Casos. Todos os campos no objeto Caso que são obrigatórios precisam ser adicionados ao criador de casos no Intercom.

2. Depois de encontrar os campos ausentes, vá para a App Store do Intercom.

3. Navegue até a configuração de Casos indo em Intercom App Store > Salesforce > Configurações > Configurar Casos, depois clique no botão "Add Fields".

4. Você receberá um menu com diferentes campos para escolher.

5. Clique no campo obrigatório para adicioná-lo à barra lateral e repita esse processo até adicionar todos os campos necessários.

Se o Intercom não conseguir conectar à sua conta Salesforce, você verá este banner nas configurações do app:

Isso pode acontecer por alguns motivos:

Você deve verificar se está enfrentando esses problemas. Uma vez resolvidos, você deverá conseguir reautenticar o app com sucesso.

Se você desinstalar o app Salesforce, seus mapeamentos serão apagados, então é uma boa ideia tirar uma captura de tela dos mapeamentos para seus leads e contatos antes de desinstalar.

Nenhum dado será afetado nem no Intercom nem no Salesforce ao desinstalar o app. Quando o app for reinstalado, outra sincronização será acionada.

Se algo falhar ao criar um lead ou uma tarefa, você pode diagnosticar o problema sozinho. Basta visitar a app store e clicar no app Salesforce. Você verá uma lista de erros lá, junto com os problemas que os estão causando.

A integração envia dados do Intercom para campos específicos no Salesforce. Estes são campos padrão no Salesforce, mas se foram modificados, ocultados ou removidos, a integração pode não funcionar. Você precisará editar suas configurações do Salesforce para garantir que esses campos estejam disponíveis.

Campos do Salesforce exigidos:

Objeto Lead

Objeto Contact

Objeto Account

Objeto Task

Cada conta Salesforce tem um limite de taxa definido, que depende do plano que você possui. O Intercom usará parte desse limite. Se você atingiu o limite da API do Salesforce, todas as suas integrações Salesforce pararão de funcionar, incluindo o Intercom.

Se você associou um lead do Intercom a um no Salesforce - mas depois atualizou o email no Intercom para que corresponda a outro lead do Salesforce - pode levar até 10 minutos para que os atributos personalizados exibindo dados do Salesforce sejam atualizados.

Você pode mapear atributos do Intercom com campos no Salesforce para que eles permaneçam sincronizados nas suas configurações de integração. Você verá os campos compatíveis (por exemplo, texto pode corresponder a texto, inteiros podem corresponder a inteiros, etc).

Para listas, correspondemos cada opção. Se houver uma opção no Salesforce que não esteja associada no Intercom, nós a adicionaremos para você na lista de opções. No entanto, só podemos adicionar opções se a lista suspensa do Salesforce NÃO estiver configurada como restrita.

Quando você tenta criar uma tarefa do Salesforce no Intercom, pode receber o erro: 'Intercom requer esses campos no objeto Task do Salesforce: Type':
​

O campo 'Type' para o objeto Task é um campo padrão no Salesforce para a maioria dos usuários, mas se você tem a edição Professional do Salesforce, ele estará configurado como 'oculto' por padrão.

Nossa integração precisa que ele esteja visível para criar tarefas. Você pode alterar isso no Salesforce indo para Object Manager > Task > Fields & Relationships > Type > Set Field-Level Security e configurando para 'visível'.

Implementamos uma nova verificação de integridade do Salesforce para todos os workspaces que têm o app Salesforce instalado. Essa verificação garante que:

Estamos executando essa verificação de saúde a cada hora. Espaços de trabalho afetados entrarão gradualmente no novo estado de não saudável nas primeiras 24 horas após a ativação dessa verificação.

Enviaremos um e-mail para o colega que instalou a integração ou, nos casos em que esse colega não for mais membro do espaço de trabalho, para o primeiro colega humano ativo que faz parte do espaço de trabalho há mais tempo. Essa verificação ocorrerá às 7h UTC.

Acesse suas configurações do app Salesforce e você verá alguns erros sinalizados na interface.

As mensagens potenciais mostradas aqui são:

Isso acontecerá se o colega que instalou o App Salesforce mais recentemente foi removido como colega do seu espaço de trabalho. A evidência disso pode ser vista se não houver nome de colega ao lado do botão "Instalado por ...":

Se isso ocorreu, você precisará desinstalar e reinstalar o app Salesforce enquanto estiver logado no Salesforce com uma conta com permissões administrativas completas. O Intercom pode sincronizar alterações com o Salesforce usando a conta Salesforce da pessoa que instalou o app, por isso requer permissões administrativas completas.

Atualmente, nosso App Salesforce não suporta sincronizar dados granulares de assinatura do Intercom para o Salesforce. Você só pode sincronizar o atributo "Cancelado o recebimento de e-mails", que se aplica a todos os e-mails, mas não a listas específicas de e-mails.

No entanto, como solução alternativa, você pode criar uma integração personalizada que use nossos tópicos de Subscription Webhook e uma requisição API para atualizar o Salesforce sempre que alguém cancelar a assinatura de uma lista de e-mails no Intercom, por exemplo. O tópico de webhook granular.unsubscribe pode ser usado para notificá-lo sempre que alguém cancelar a assinatura de um tipo de mensagem no Intercom. Após receber o webhook, você pode fazer uma requisição API para o Salesforce atualizar a pessoa relevante.

Os atributos que você mapeia entre Intercom e Salesforce são sincronizados quando mudam em qualquer dos sistemas (veja a explicação detalhada do gatilho nas seções acima). Quando a mudança ocorre no Intercom, a sincronização para o Salesforce é acionada imediatamente, enquanto o Salesforce é verificado a cada 5 minutos para determinar se há mudanças para sincronizar de volta para o Intercom.

Por enquanto, você pode sincronizar campos do Salesforce de Leads e Contatos para os objetos people do Intercom (você não precisa definir se é um objeto Lead ou User do Intercom).

Você pode sincronizar a maioria dos atributos. Algumas exceções são atributos somente leitura, atributos no Intercom que mudam muito frequentemente (ex.: last_seen) ou campos de fórmula (veja a próxima pergunta).

Campos de fórmula são mais complexos e o comportamento da sincronização pode depender da configuração do Salesforce. Em geral, campos de fórmula podem ser mapeados e sincronizados para o Intercom. Porém, como esse campo é calculado, mudanças nele não iniciam um gatilho, o que significa que ele só será sincronizado quando algo mais disparar a sincronização.

Claro! Você pode testar essa nova versão usando um espaço de trabalho de teste com uma conta sandbox do Salesforce.

A única forma de alterar os e-mails dos destinatários da notificação por e-mail do Salesforce é desinstalando e reinstalando o app pelo administrador cujo endereço de e-mail deve aparecer.

Se você ainda está tendo problemas com sua integração Salesforce, entre em contato com nossa equipe de Suporte via Messenger 😄