Ação Obter conta e oportunidade de endereços de email
Essa ação obtém um registro de conta associado a um contato ou endereço de email sem correspondência e também obtém um registro de oportunidade relacionado a um contato. Para ser usado nas Atividades: fluxo Combinar email a registros. Exige que Sincronizar email como atividade do Salesforce esteja habilitado na Captura de atividades do Einstein.
Edições obrigatórias
| Disponível em: Lightning Experience |
| Disponível com o Padrão de Captura de atividades do Einstein em Vendas nas edições Starter, Professional e Enterprise |
| Disponível com Unlimited Edition e Einstein 1 Sales Edition |
| Disponível com o Einstein para vendas, que está incluído na edição Einstein 1 Sales e disponível por um custo extra nas edições Enterprise e Unlimited. |
| Disponível com o Sales Engagement em vendas, que está incluído nas edições Performance e Unlimited e disponível por um custo extra nas edições Professional e Enterprise. |
| Disponível com a Revenue Intelligence, que está disponível por um custo extra nas edições Enterprise e Unlimited. |
No Flow Builder, adicione um elemento Ação ao fluxo. Na janela Nova ação, pesquise pela Correspondência de atividades e selecione Obter conta e oportunidade de endereços de email.
Definir valores de entrada
Use valores que ocorrem anteriormente no fluxo para definir as entradas para a ação.
| Campo | Descrição |
|---|---|
| Campo de conta | O nome do campo usado para identificar contas de parceiros. Opcional se Contas do parceiro for false. Essa entrada é capturada na seção Usos de contas de parceiros das propriedades de ação no Flow Builder. |
| Data da atividade | Obrigatório. A data e a hora da atividade. Para email, é a data em que o email foi enviado. |
| Operador de comparação | O operador de comparação para determinar uma conta de parceiro. Os valores válidos são Igual a, Não é igual a, Maior que, Menor que, Maior que ou igual a, Menor que ou igual a, É nulo e Está em branco. Opcional se Contas do parceiro for false. Essa entrada é capturada na seção Usos de contas de parceiros das propriedades de ação no Flow Builder. |
| Contatos | Obrigatório. Uma coleção de registros de contato para os quais obter registros de conta e oportunidade associados. |
| Contas de parceiros | Um valor booleano que indica se a empresa tem contas de parceiro. O valor-padrão é false. Essa entrada é capturada na seção Usos de contas de parceiros das propriedades de ação no Flow Builder. |
| Endereços de email sem correspondência | Opcional. Uma coleção de endereços de email que não têm um registro de usuário ativo ou contato ativo correspondente. |
| Usuários | Obrigatório. Uma coleção de registros de usuário para os quais obter registros de conta e oportunidade associados. |
| Valor | O valor do campo Conta para identificar uma conta de parceiro. Opcional se Contas do parceiro for false. Essa entrada é capturada na seção Usos de contas de parceiros das propriedades de ação no Flow Builder. |
Armazenar valores de saída
| Campo | Descrição |
|---|---|
| Conta | Um registro de conta associado a um dos contatos especificados ou endereços de email sem correspondência. |
| Oportunidade | Um registro de oportunidade associado a um dos contatos especificados ou ao registro de conta retornado. Se nenhuma oportunidade for encontrada, será um registro de oportunidade de propriedade de um usuário na coleção de usuários especificada. |
| Endereços de email sem correspondência | Uma coleção de endereços de email que não têm uma conta ou oportunidade correspondente. |
Condições de erro
| Condição de erro | Descrição |
|---|---|
| Sem campo de conta | Se Contas de parceiro for Código de erro: REQUIRED_FIELD_MISSING |
| Sem operador de comparação | Se Contas de parceiro for Código de erro: REQUIRED_FIELD_MISSING |
| Sem valor | Se Contas de parceiro for Código de erro: REQUIRED_FIELD_MISSING |
Uso
Para usar essa ação, habilite Sincronizar email como atividade do Salesforce. A ação é projetada principalmente para ser usada nas Atividades: fluxo Combinar email a registros.
Como funciona
Essa ação usa como entrada a data de envio da mensagem de email e os registros de usuário e contato que correspondem a um endereço de email nos campos De, Para ou CC na mensagem. Como opção, a entrada inclui endereços de email que não correspondem a um registro de usuário ou contato. Se você usar parceiros em seu processo de vendas, os campos Conta de parceiro, Campo de conta, Operador de comparação e Valor capturarão os critérios usados para indicar contas de parceiros.
A ação consulta o campo AccountId em registros de contato para localizar a conta que corresponde a contatos na entrada de ação.
Se nenhuma conta foi encontrada, a ação verifica o domínio do valor do campo Website de uma conta. Se esse domínio corresponder ao domínio de email de qualquer endereço em Endereços de email sem correspondência na entrada, a ação selecionará essa conta. Se várias contas foram encontradas, a ação seleciona a conta que tem o LastActivityDate mais recente.
Depois de localizar registros de conta, a ação consulta o campo ContactId nos registros OpportunityContactRole para corresponder contatos a uma oportunidade. Somente oportunidades abertas criadas no último ano são incluídas. Se nenhuma oportunidade for encontrada, a ação consultará o campo AccountId nos registros de oportunidade para encontrar uma oportunidade com uma conta que corresponda a Conta na saída da ação.
Endereços de email que não têm uma conta ou oportunidade correspondente são armazenados em Endereços de email sem correspondência na saída.
Quebradores de conta
Se várias contas corresponderem ao endereço de email de um contato, a ação seguirá esta lógica.
A ação verifica o campo RecordTypeId nas contas de cada um dos contatos. A ação consulta o campo Nome no objeto RecordType. Se o Nome não for um parceiro, a ação presume que seja uma conta não parceira. Da mesma forma, se o Nome for um parceiro, a ação presume que seja uma conta de parceiro. Para determinar a conta, a ação avalia essas regras na ordem.
- Se os registros de contato tiverem uma combinação de valores de parceiro e não parceiro para o campo Nome no objeto RecordType, a ação selecionará a conta não parceiro. A ação a adiciona à Conta na saída da ação.
- Se a maioria dos registros de contato tiver a mesma conta, a ação selecionará essa conta e a adicionará à Conta na saída da ação.
- Se as regras anteriores não tiverem resultado em uma conta adicionada à saída, a ação selecionará a conta que tem a LastActivityDate mais recente. A ação adiciona essa conta à Conta na saída da ação.
Desempates de oportunidade
Se várias oportunidades corresponderem a um endereço de email, a ação seguirá esta lógica. Oportunidades que foram fechadas por 60 dias ou mais após a ActivityDate não são consideradas para correspondência.
- Se o proprietário de uma oportunidade corresponder a um registro de usuário em Usuários na entrada de ação, a ação selecionará essa oportunidade e a adicionará a Oportunidade na saída de ação.
- Se o proprietário da conta de uma oportunidade corresponder a um registro de usuário em Usuários na entrada de ação, a ação selecionará essa oportunidade e a adicionará a Oportunidade na saída de ação.
- Se as regras anteriores não tiverem resultado em uma oportunidade adicionada à saída, a ação selecionará a oportunidade com a LastActivityDate mais recente. A ação adiciona essa oportunidade a Oportunidade na saída da ação.
Limitações
Essa ação é limitada ao uso em um fluxo. Ele não pode ser chamado por outros métodos, como Apex, API REST, Copilot, Prompt Studio ou Bots do Einstein. Embora as ações geralmente possam ser invocadas por meio de várias estruturas, como InvocableActionService, essa ação específica é restrita apenas ao Fluxo.
Se o campo activityId estiver vazio ao depurar essa ação, use o Developer Console para consultar StagedEmail para um valor.
