Automatizar a entrega de dados com fluxos acionados por ativação
Conecte automaticamente as ativações do Data 360 a sistemas externos usando conectores do MuleSoft para integração de fluxo ou uma ação de chamada HTTP.
Edições obrigatórias
| Exibir edições com suporte. |
| Permissões de usuário necessárias | |
|---|---|
| Para criar, editar, salvar, excluir e ativar um fluxo acionado por ativação | Administrador de marketing do Data Cloud legado OU Gerenciador de ativação do Data Cloud OU Arquiteto do Data Cloud OU Especialista de ativação do Data Cloud OU Gerenciar fluxo OU Todas estas permissões:
|
Você pode se conectar a um sistema de destino externo usando fluxos acionados por ativação de duas maneiras:
- Conectores do MuleSoft: Os conectores do MuleSoft estão disponíveis no Flow Builder. Ao configurar uma ação em seu fluxo, você pode selecionar entre estes conectores. Para localizar as ações com suporte e a licença complementar necessária para cada conector, consulte Conectores de terceiros.
- Serviços externos (chamada HTTP): Você pode se conectar por meio de uma chamada HTTP, que usa recursos existentes da plataforma Salesforce, como Serviços externos e Credenciais nomeadas. Antes de criar o fluxo, configure uma Credencial nomeada usando a funcionalidade da plataforma para configurar os pontos de extremidade da API e os detalhes de autenticação para o sistema externo. Ao adicionar uma ação ao seu fluxo, selecione a opção Criar chamada HTTP e selecione a Credencial nomeada que você configurou anteriormente. Para saber mais sobre como criar e gerenciar serviços externos, consulte Registrar um serviço externo.
Para criar um fluxo acionado por ativação, você deve criar uma ativação para um segmento ou criar uma ativação para DMO em lote no Data 360. Fluxos acionados por ativação oferecem suporte apenas ao tipo de destino da ativação do Data 360.
Fluxos acionados por ativação oferecem suporte aos seguintes métodos de autenticação ao se conectar a outros destinos baseados em API:
- OAuth 2.0
- Fluxo de código de autorização – recomendado para aplicativos em que a interação do usuário é por meio de um navegador da Web.
- Fluxo de credenciais do cliente – recomendado para interações entre servidores sem envolvimento do usuário. Os apertos entre o Salesforce e o sistema externo de destino para obter e atualizar tokens devem estar em conformidade com os padrões para usar as Credenciais do cliente.
- Autenticação básica – o usuário fornece um nome de usuário e senha.
- Chaves de API – acesso à API fornecendo uma chave exclusiva na solicitação HTTP.
Consulte Considerações sobre fluxos acionados por ativação para obter mais informações sobre autenticação.
- Criar o fluxo
Crie um fluxo acionado por ativação. - Solucionar problemas e visualizar métricas e relatórios de fluxo
Configure sua organização para visualizar métricas e relatórios para fluxos acionados por ativação para que você possa monitorar e solucionar problemas de execuções de fluxo. - Considerações para fluxos acionados por ativação
Veja mais considerações para fluxos acionados por ativação.
Consulte também:
Criar o fluxo
Crie um fluxo acionado por ativação.
- Vá para a guia Fluxos no aplicativo Automação e clique em Novo.
- Pesquise e selecione Fluxo acionado por ativação.
-
Na Biblioteca de ativação, selecione a ativação do Data 360 que aciona o fluxo.
Fluxos acionados por ativação oferecem suporte apenas a ativações criadas com o Data 360 como o tipo de destino da ativação. Embora a lista de ativações disponíveis no Flow Builder possa mostrar ativações com outros tipos de destino, como Marketing , selecionar um que não seja do tipo de destino do Data 360 gera um erro quando você tenta salvar o fluxo. Você deve saber antecipadamente que a ativação selecionada tem o tipo de destino do Data 360.
- No elemento Iniciar, como opção, configure regras de saída e condições de reentrada. As regras de saída encerram um fluxo se determinadas condições forem atendidas. As regras de saída são úteis para situações em que as circunstâncias do usuário mudam ao longo do tempo. As condições de nova entrada determinam se um usuário é elegível para entrar novamente no mesmo fluxo.
-
Clique em
e selecione Ação.
-
No painel de pesquisa, selecione um Grupo de ações. Selecione um Conector ou selecione Outro para criar uma Chamada HTTP (serviço externo).
- Se você quiser usar um Conector do MuleSoft, selecione o conector desejado e configure os detalhes da conexão ou selecione uma conexão existente.
- Se você quiser usar um Serviço externo, selecione um Serviço externo existente ou Criar chamada HTTP selecionando a Credencial nomeada pré-configurada e usando o método PUSH/PUT junto com o URL do ponto de extremidade da API e a solicitação JSON de amostra.
-
Escolha uma ação e mapeie os campos exigidos pelo sistema externo para os dados disponíveis dos dados de ativação acionadores.
Você pode mapear dados de ativação até cinco níveis para atributos relacionados.
- Se você precisar usar atributos relacionados a dados de ativação, primeiro transforme os atributos relacionados em um tipo com suporte, como uma classe ou objeto do Apex. Por exemplo, se seu serviço externo exigir uma classe do Apex, use um elemento de transformação ou atribuição para criar um mapeamento do Apex.
- Para identificar o tipo Apex necessário para a ação, crie um novo recurso. Na janela Novo recurso, copie o valor existente no campo Classe do Apex. Depois de copiar o valor, cancele ou feche a janela.
- Adicione um elemento de transformação antes do elemento de ação.
- No elemento de transformação, selecione $ActivationData como a fonte de dados e selecione Apex-Defined para o tipo de dados dos dados de destino. Cole o valor da Classe do Apex no campo Classe do Apex. Clique em Criar.
- Configure o restante do fluxo.
- Ative o fluxo.
Solucionar problemas e visualizar métricas e relatórios de fluxo
Configure sua organização para visualizar métricas e relatórios para fluxos acionados por ativação para que você possa monitorar e solucionar problemas de execuções de fluxo.
Se você encontrar um comportamento inesperado:
- Verifique o status de publicação do segmento usado para criar a ativação do Data 360.
- Se o status de publicação do segmento for Bem-sucedido, verifique a contagem de segmento e a contagem de ativação correspondente na tabela "Histórico de publicação" da IU de segmento no Data 360 ou na tabela "Histórico de ativação" na IU de ativação do Data 360.
- Se o status de publicação para o segmento e a contagem de ativações for Bem-sucedido, a ativação correspondente deverá acionar o fluxo acionado pela ativação.
- Depois que uma ativação aciona um fluxo acionado por ativação, mas antes que o próprio fluxo termine de ser executado, criamos um registro de ocorrência de versão do fluxo. Conforme o fluxo é executado, o registro de ocorrência da versão do fluxo rastreia entradas, saídas e erros para uma versão específica do fluxo.
- Ao visualizar um fluxo acionado por ativação no Flow Builder, você pode selecionar elementos individuais na tela e ver as métricas para esse elemento.
Para visualizar os detalhes de suas execuções de fluxo, você também pode criar um relatório de Execução de elemento de fluxo. Fluxos acionados por ativação exigem que você implemente fluxos de dados para o DMO FlowRun e FlowElementRun. Esses fluxos de dados habilitam o registro do histórico de execução de fluxo. O histórico de execução de fluxo é consultável e pode ajudá-lo a entender os detalhes de suas execuções de fluxo e ajudar a solucionar quaisquer problemas.
- Instale o pacote Salesforce Data Cloud – Integração de fluxo para todos os usuários.
- No aplicativo Data 360, selecione a guia Fluxos de dados e clique em Novo.
- Na janela Novo fluxo de dados, selecione Kits e pacotes de dados instalados e clique em Avançar.
- Selecione Fluxo do Data Cloud na lista Kits de dados
- Marque a caixa de seleção ao lado de Fluxo_Ingestão para selecionar todos os fluxos de dados e clique em Avançar.
- Para o Nome do conector, selecione Novo conector.
- Insira Ingestão de execução de fluxo como o nome do conector e clique em Salvar.
- Clique em Avançar para avançar pelas etapas até poder implementar o fluxo de dados e, em seguida, clique em Implantar.
- Em seguida, implemente os fluxos de Registro de fluxo. Em Configuração, na caixa Busca rápida, insira Conjuntos de permissões e selecione-o.
- Clique no conjunto de permissões do Conector do Salesforce do Data Cloud.
- Na seção Aplicativos, clique em Permissões do aplicativo.
- Na seção Fluxo e Orquestração de fluxo, selecione Visualizar fluxos e clique em Salvar e confirme.
- No aplicativo Data 360, selecione a guia Fluxos de dados e clique em Novo.
- Na janela Novo fluxo de dados, selecione Salesforce CRM e clique em Avançar.
- Na seção Pacotes personalizados, selecione Fluxos e clique em Avançar.
- Clique em Avançar para avançar pelas etapas até poder implementar o fluxo de dados e, em seguida, clique em Implantar.
- Para criar um relatório, no aplicativo Data 360, navegue até a guia Relatórios e clique em Novo relatório.
- Na categoria do Data Cloud, selecione Elemento de fluxo com execução de elemento de fluxo e clique em Iniciar relatório.
-
Na guia Estrutura, adicione estas colunas:
- Elemento do fluxo: Informações – Nome
- Elemento do fluxo: Informações – Versão do fluxo
- Elemento do fluxo: Informações – Motivo do erro
- Elemento do fluxo: Informações – Descrição do erro
- Execução do elemento de fluxo: Info – DateTime agendado
- Execução do elemento de fluxo: Info – DateTime concluído
- Na guia Filtros, adicione um filtro em branco com o operador equals para Versão do fluxo.
- Clique em Salvar.
- Para obter o ID de versão do fluxo necessário para o filtro de relatório, no aplicativo Automação Lightning, selecione o fluxo acionado pela ativação.
- Na guia Relacionado, selecione a versão do fluxo relevante.
-
Na barra de endereço do navegador, copie o ID da versão do fluxo. O ID começa com
10v. - No relatório que você criou anteriormente, cole o ID da versão do fluxo no filtro e clique em Aplicar.
Considerações para fluxos acionados por ativação
Veja mais considerações para fluxos acionados por ativação.
Considerações sobre limite de taxa
O limite de frequência para fluxos acionados por ativação depende da sua licença. Os limites de frequência são medidos em ações por hora. As ações são definidas pela execução de um único caminho de um fluxo, incluindo quando o fluxo começa e quando o fluxo é retomado. Os fluxos são retomados depois de esperar algo acontecer, como a expiração de uma duração do elemento Aguardar ou o recebimento de um evento de engajamento.
Por exemplo, um fluxo sem elementos Aguardar é executado em uma ação. Um fluxo com um elemento Aguardar é executado em duas ações, com a primeira ação incluindo tudo até o elemento Aguardar e a segunda ação incluindo tudo após a retomada do fluxo.
Além do limite de ação por hora, há um limite de simultaneidade que determina o número de execuções de fluxo executadas por hora. Em geral, o limite total de simultaneidade é dividido igualmente entre todos os fluxos em execução.
| Limite de execução | Segmentos simultâneos |
|---|---|
| 150 mil ações por hora | 2 |
| Starter: 1.000.000 de ações por hora | 14 |
| Marketing Cloud Next, Data 360: 15.000.000 de ações por hora | 210 |
Use a fórmula (actions per hour * time to execute in seconds) / 3600 = required
concurrency per hour para determinar se seu fluxo excede o limite de simultaneidade necessário para maximizar suas ações por hora.
Por exemplo, uma organização provisionada com 15 milhões de ações por hora tem um fluxo com uma única ação que leva em média 40 milissegundos para ser executada. (15,000,000 * 0.04) /
3600 = 167. Como 167 está abaixo do limite de simultaneidade de 210, o fluxo pode executar 15 milhões de ações por hora.
Se outro fluxo tiver uma única ação, mas levar em média 150 milissegundos para ser executado devido a uma ação de serviço externo, use a fórmula (15,000,000 * 0.15) / 3600 =
625. Como 625 é maior que o limite de simultaneidade de 210, o fluxo poderá executar aproximadamente 5.000.000 ações por hora se usar todas as 210 sequências.
O último fator limitante é a taxa de erro do fluxo. As taxas de erro contam apenas erros repetíveis. Elementos de fluxo que falham mais de 2,5% do tempo acionam a limitação de taxa adicional. O limite de simultaneidade é ajustado até que as taxas de erro permaneçam consistentemente abaixo de 2,5%. Esses ajustes ajudam a proteger serviços downstream, como serviços externos. As taxas de erro provavelmente são o fator de limitação mais comum que afeta a capacidade de um fluxo de executar suas ações máximas por hora.
Fluxos que exigem respostas em tempo real, como envios de formulário, inscrições de SMS, mensagens SMS de duas vias e emails de transação de alta prioridade, têm uma alocação adicional de 50% ao limite de simultaneidade. Por exemplo, se você tiver um limite de simultaneidade de 210, os fluxos que exigem respostas em tempo real poderão acessar 105 solicitações simultâneas adicionais (210 * 1,5 = 315).
Considerações sobre autenticação
Fluxos acionados por ativação oferecem suporte a dois fluxos de autenticação OAuth 2.0.
- Fluxo de código de autorização
- Objetivo: Usado principalmente para aplicações em que a interação do usuário por meio de um navegador da Web é esperada ou obrigatória.
- Processo:
- O usuário é redirecionado para o servidor de autorização do aplicativo externo para autenticar e autorizar o aplicativo.
- Após uma autorização bem-sucedida, um código de autorização é retornado ao Salesforce por meio de um URI de redirecionamento.
- O aplicativo troca esse código de autorização por um token de acesso, que o Salesforce atualiza quando necessário.
- Caso de uso: Melhor para aplicativos da Web e aplicativos que precisam de alta segurança, especialmente em casos que exigem acesso Por usuário.
- Referências:
- Especificação de fluxo de código de autorização OAuth 2.0
- Exemplo de credencial nomeada: Fluxo do navegador OAuth 2.0 com uma entidade de segurança nomeada
- Exemplo de credencial nomeada: Fluxo do navegador OAuth 2.0 com uma entidade de segurança por usuário
- Criar ou editar uma credencial externa do OAuth com o fluxo do navegador
- Fluxo de credenciais do cliente
- Objetivo: Adaptado para interações entre servidores em que nenhum usuário está envolvido.
- Processo:
- O aplicativo cliente envia uma solicitação diretamente ao ponto de extremidade de token do aplicativo externo, incluindo seu ID de cliente e segredo do cliente.
- O aplicativo externo retorna um token de acesso que pode ser usado para autenticar solicitações de API.
- Caso de uso: Ideal para serviços de back-end ou aplicativos que acessam recursos em nome próprio, em vez de um usuário.
- Referências:
- Considerações: Os contactos entre o Salesforce e o sistema externo de destino para obter e atualizar tokens devem estar em conformidade com os padrões para usar as Credenciais do cliente. Não há suporte para determinados provedores que não exibem comportamentos em conformidade com os padrões.
Fluxos acionados por ativação oferecem suporte a formas adicionais de autenticação:
- Autenticação básica
- Objetivo: Um método simples para comunicação cliente-servidor.
- Processo:
- O cliente envia solicitações HTTP com o nome de usuário e senha codificados em base64 no cabeçalho da solicitação.
- O servidor decodifica e verifica as credenciais antes de conceder acesso.
- Considerações de segurança: A autenticação básica deve ser usada com cautela e sempre por HTTPS para criptografar as credenciais e garantir que elas não sejam expostas durante a transmissão.
- Referências:
- Chaves de API
- Objetivo: Habilita acesso à API simples integrando uma chave exclusiva na solicitação HTTP.
- Processo:
- O Salesforce inclui a chave de API como parte das solicitações HTTP (geralmente em um cabeçalho) para autenticação com o serviço.
- O servidor valida a chave de API antes de processar a solicitação.
- Caso de uso: Conveniente para integração de sistemas em que a facilidade de uso é uma prioridade sobre requisitos de segurança complexos.
- Referências:
- Não há padrão ou especificação do setor para chaves de API. Examine a documentação do aplicativo externo de perto para determinar o nível de ajuste com o suporte do Salesforce.
- Usar chaves de API em cabeçalhos personalizados com credenciais nomeadas
Outras considerações
Não é possível empacotar metadados do Data 360, como ativações, no mesmo pacote que metadados não Data 360. Para empacotar uma ativação do Data 360 com um fluxo, use dois pacotes.
Uma execução de fluxo que inclui um conector do MuleSoft consome créditos de automação. As execuções de fluxo que falham devido a erros internos de especificação não consomem créditos de automação. Consulte MuleSoft: Uso e taxas de créditos de automação.
