Configurar uma fonte de dados em um FlexCard

Configurar uma fonte de dados de consulta SOQL

Configure uma fonte de dados para usar uma consulta Salesforce Object Query Language (SOQL) para pesquisar os dados de uma organização para obter informações específicas. As consultas SOQL são criptografadas para que os FlexCards não exibam informações da consulta no lado do cliente.

Nota

Quando você mapeia campos, apenas os campos no seletor de campos que têm valores não nulos para o registro específico na consulta de teste ficam visíveis. Use um registro de teste que você sabe que tem valores não nulos para todos os campos a serem mapeados. Ou use campos personalizados se o registro de teste não tiver esses campos.

1. Para aplicar a segurança em nível de campo para uma consulta SOQL:
   1. Em Configuração, selecione e abra Configuração de interação Omni.
   2. Clique em Nova configuração de interação Omni.
   3. Para Nome e Rótulo, insira EnableQueryWithFLS. Em Valor, insira true.
   4. Salve suas alterações.

   Quando a configuração EnableQueryWithFLS está habilitada, os Flexcards exibem apenas os campos que o usuário tem permissão para visualizar. Os campos aos quais o usuário não tem acesso são ocultados.

   

   Importante Durante a semana de 2 de fevereiro de 2026, o Salesforce ativa a configuração EnableQueryWithFLS por padrão para aprimorar a segurança da organização. Revise e prepare sua configuração para uma transição aprimorada e para evitar possíveis interrupções de serviço. Consulte Verificações de segurança para o OmniStudio.
2. Insira uma consulta SOQL e outras opções conforme necessário.
   Por exemplo, obtenha até 10 campos do objeto Contato quando houver um endereço de email existente usando esta consulta:

   SELECT Id, Name, Email, Phone, Title FROM Contact WHERE Email != Null LIMIT 10

Configurar uma fonte de dados de pesquisa SOSL

Crie consultas de pesquisa baseadas em texto com base no índice de pesquisa com a Linguagem de pesquisa de objeto do Salesforce (SOSL). Ao usar uma única consulta, você pode pesquisar campos de texto, email e telefone para vários objetos aos quais você tem acesso, incluindo objetos personalizados. As consultas SOSL são criptografadas para que as informações da consulta não estejam visíveis no lado do cliente. Para impor a segurança em nível de campo para uma consulta SOSL, vá até Configuração e adicione a Configuração de interação do Omni EnableQueryWithFLS e defina-a como true: EnableQueryWithFLS=true

Importante Durante a semana de 2 de fevereiro de 2026, o Salesforce ativa a configuração EnableQueryWithFLS por padrão para aprimorar a segurança da organização. Revise e prepare sua configuração para uma transição aprimorada e para evitar possíveis interrupções de serviço. Consulte Verificações de segurança para o OmniStudio.

1. Insira o termo de pesquisa.
2. Selecione os campos pelos quais pesquisar.
3. Selecione pelo menos um sObject e um campo para pesquisar.
4. Se necessário, insira um limite do número máximo de linhas a retornar.
5. Insira outras informações de pesquisa conforme necessário.

Configurar uma fonte de dados remota do Apex

Configure uma fonte de dados para invocar uma classe do Apex e um método que busque dados para preencher um FlexCard. As fontes de dados remotas do Apex podem ser executadas de forma assíncrona, o que aumenta o tempo de CPU, mas garante que as transações de execução longa não expiram. Uma classe remota do Apex é uma classe padrão do Apex que implementa o VlocityOpenInterface.

1. Selecione uma classe e um método do Apex.
   Consulte Visualizar classes do Apex.
   Este exemplo mostra uma classe do Apex RemoteActionClass com um método getAccounts:

   global class RemoteActionClass implements [Namespace].VlocityOpenInterface2 {
   
       public Boolean invokeMethod(String methodName, Map<String,Object> input, Map<String,Object> outMap, Map<String,Object> options) {
           if (methodName.equals('getAccounts')) {
               getAccounts(input, outMap, options);
           }
           return true;
       }
       public void getAccounts(Map<String,Object> input, Map<String,Object> outMap, Map<String,Object> options) {
           String accountName = String.valueOf(input.get('account'));
           List<Account> accounts = new List<Account>();
           
           if (String.isBlank(accountName)) {
               accounts = [SELECT Id, Name, Phone FROM Account];
           } else {
               accounts = [SELECT Id, Name, Phone FROM Account WHERE Name Like :('%' + accountName + '%')];
           }
           outMap.put('accounts', accounts);
       }
   }

2. Escolha se deseja executar a chamada de forma assíncrona por meio do Apex.
3. Se necessário, insira um intervalo em milissegundos para verificar o status da resposta.
4. Se necessário, passe valores do FlexCard para o método de classe remota:
   1. Adicione um mapa de entrada.
   2. Em chave, insira uma variável de ID de contexto.
   3. Em Valor, insira o valor da variável.

   Por exemplo, insira a chave AccountId e o ID da conta de um registro como o valor.

5. Se necessário, envie pares de valores de chave adicionais para o mapa de entrada passado para o método remoto:
   1. Adicione um mapa de opções.
   2. Insira os valores.
      

      Nota

      Os campos Valor suportam valores estáticos e campos de mesclagem, como {recordId} ou {name}.

6. Insira outras informações da fonte de dados remota do Apex conforme necessário.

Configurar uma fonte de dados REST do Apex

Configure uma fonte de dados para usar uma chamada REST do Apex para recuperar dados para preencher campos em um FlexCard com o método GET. Use o método POST para enviar dados de volta ao servidor.

Nota

Para uma flexibilidade ideal e uma implementação mais fácil, use um Procedimento de integração como uma fonte de dados para executar várias ações em uma única chamada de servidor. Consulte Configurar uma fonte de dados de procedimento de integração.

1. Insira o URL do ponto de extremidade, como /services/apexrest/{namespace}/CardTestApexRestResource/{recordId}.
   Este exemplo mostra uma classe REST:

   @RestResource(urlMapping='/v1/typeahead/*') 
   
   global with sharing class TypeaheadApexRest {
       @HttpGet
       global static void doGet()
       {
           RestResponse res = RestContext.response;
           res.responseBody =blob.valueOf('["amazon","airbnb","amazon prime","american airlines","american express","apple","aol mail","at\u0026t","apple store","adele"]');
       }
       
       @HttpPost
       global static void doPost()
       {
           RestRequest req = RestContext.request;
           RestResponse res = RestContext.response;
           
           res.responseBody = blob.valueOf(JSON.serialize(new Map<String, Object>{'someResponse' => 'Post is done'}));
       }
   }

2. Selecione um tipo de método:
   • GET: Solicite dados com base nos parâmetros do URL.
   • POST: Enviar dados JSON.
3. Para o método POST, insira os dados JSON a serem enviados no campo Carga útil JSON.
   Você pode usar variáveis de contexto para passar valores herdados com qualquer um dos métodos.
4. Insira outras informações da fonte de dados REST do Apex conforme necessário.

Configurar uma fonte de dados do mapeador de dados do OmniStudio

Configure uma fonte de dados do Data Mapper para buscar dados de uma Extração do Data Mapper. A segurança em nível de campo tem suporte total.

1. Localize e selecione o Mapeador de dados a ser usado.
2. Se necessário, passe valores do FlexCard para os parâmetros de entrada do Mapeador de dados:
   1. Adicione um mapa de entrada.
   2. Em chave, insira uma variável de ID de contexto.
   3. Em Valor, insira o valor da variável.

   Por exemplo, insira a chave AccountId e o ID da conta de um registro como o valor.

   

   Nota

   O campo Valor suporta valores estáticos e campos de mesclagem, como {recordId} ou {name}.

3. Insira outras informações da fonte de dados do Data Mapper conforme necessário.

Configurar uma fonte de dados REST

Configure uma fonte de dados REST recuperando ou enviando dados por meio de uma API pública, como dados meteorológicos de uma API meteorológica com base no CEP de um titular da apólice. Você também pode usar credenciais nomeadas para autenticar chamadas do Apex que especificam o URL de um ponto final de chamada e seus parâmetros de autenticação necessários em uma definição.

1. Selecione o tipo REST e o tipo de método:
   • GET: Solicite dados com base nos parâmetros do URL.
   • POST: Enviar dados JSON.
2. Para o tipo REST da credencial nomeada:
   1. Selecione uma credencial nomeada.
   2. Insira um caminho relativo para recuperação de dados, como My_Payroll_System/paystubs?format=json.
3. Para o tipo Web REST, insira o URL do ponto de extremidade REST, como http://api.weatherstack.com/current?access_key={Session.weatherAPIkey}&query={BillingCity}.
4. Para o método POST, insira os dados JSON a serem enviados no campo Carga útil JSON.

   Você pode usar variáveis de contexto para passar valores herdados com qualquer um dos métodos.

5. Se necessário, adicione cabeçalhos de solicitação, como tokens, chaves públicas ou tipo de conteúdo:
   1. Adicione um par de chave e valor.
   2. Em chave, insira uma variável de ID de contexto.
   3. Em Valor, insira o valor da variável.
6. Insira outras informações da fonte de dados REST conforme necessário.

Configurar uma fonte de dados de procedimento de integração

Configure uma fonte de dados para usar um Procedimento de integração que execute várias ações em uma única chamada do servidor. Por exemplo, você quer que seus agentes de atendimento ao cliente visualizem a previsão meteorológica dos titulares de apólice quando eles estão em uma chamada. Para fazer isso, use um Procedimento de integração com uma Extração do mapeador de dados que retorne o CEP de uma conta. Em seguida, use uma chamada à API REST que obtenha a previsão atual para a região da conta com base no CEP.

1. Localize e selecione o Procedimento de integração a ser usado.
2. Se necessário, passe valores do FlexCard para o Procedimento de integração:
   1. Adicione um par de chave e valor.
   2. Em chave, insira uma variável de ID de contexto.
   3. Em Valor, insira o valor da variável no formato {}, {}, .... Não há suporte para formato de matriz.
   

   Nota

   Os campos Valor suportam valores estáticos e campos de mesclagem, como {recordId} ou {name}.

   array se objetos na forma de [{},{}] quebrarão a lógica de interpolação, pois aceita apenas dados do formato {}, Não é possível passar a matriz de objetos como parâmetros de entrada para dados IP Ação de um FlexCard para [Doc] Não é possível passar a matriz de objetos como parâmetros de entrada para dados IP Ação de um FlexCard

   Por exemplo, insira a chave AccountId e o ID da conta de um registro como o valor.

3. Se você usar o OmniStudio Winter '23 ou posterior, configure o Procedimento de integração para usar a classe Continuação no Apex para fazer uma solicitação de execução longa para um serviço da Web externo:
   1. Adicione um mapa de opções.
   2. Em chave, insira useContinuation.
   3. Em Valor, insira true.

   Consulte Classe de continuação.

4. Se necessário, adicione dados de amostra ao Procedimento de integração.

   Consulte Ação de resposta para procedimentos de integração.

5. Insira outras informações da fonte de dados do Procedimento de integração conforme necessário.

Configurar uma fonte de dados da API de streaming

O método da API de streaming usa a tecnologia push, que é um modelo de publicação e assinatura que transfere informações iniciadas de um servidor para o cliente com base em critérios definidos por você. Ele tem uma conexão persistente que entrega continuamente novos dados à medida que ele fica disponível, em vez de usar a pesquisa de clientes. Ao usar a API de streaming, você reduz o número de chamadas à API e, assim, melhora o desempenho.

1. Selecione o tipo de API de streaming:

   • PushTopic: Consulta SOQL que retorna um resultado que notifica os ouvintes sobre alterações de registro no Salesforce usando um canal de API de streaming. Por exemplo, use esse método para ser notificado quando alguém criar um caso para um tipo, um status ou ambos.

   • Canal de streaming: API de streaming que envia notificações de eventos gerais que não estão relacionados a alterações de dados do Salesforce. Você pode usar esse método para qualquer aplicativo que envie notificações personalizadas, como um aplicativo de chat.

   • Eventos de plataforma: Arquitetura de mensagens conduzida por evento que permite que os aplicativos se comuniquem dentro e fora do Salesforce. Um evento de plataforma combina os tipos de canal PushTopic e streaming. Em vez de trabalhar com um sObject, os eventos de plataforma funcionam com objetos personalizados.

2. Em Canal, insira o URL da API de streaming.
3. Selecione o tipo de operação, se os dados recuperados substituem ou adicionam aos dados existentes.
4. Na lista de opções Obter todas as mensagens, selecione uma destas opções:
   • True: Obtenha todos os dados das últimas 24 horas.
   • Falso: Obtenha a atualização de dados mais recente.
5. Insira outras informações da fonte de dados da API de streaming conforme necessário.

Configurar uma fonte de dados personalizada

Integre diretamente dados JSON personalizados ao FlexCard sem depender de uma origem de dados externa. Configure esses dados personalizados para testar com dados estáticos temporários, como em espera de acesso à API ou para testes de conceito rápidos.

1. Insira seu código JSON personalizado, como:

   [
   	{
   		"attributes": {
   			"type": "Contact",
   			"url": "/services/data/v49.0/sobjects/Contact/0033700000TOF0eAAH"
   		},
   		"Name": "Perry",
   		"Id": "0033700000TOF0eAAH",
   		"Phone": "(734) 489-5851",
   		"AccountId": "0013700000NVVLvAAP",
   		"Email": "perry@vlocity.com",
   		"MailingAddress": {
   			"city": "Concord",
   			"country": "US",
   			"geocodeAccuracy": null,
   			"latitude": null,
   			"longitude": null,
   			"postalCode": "53813",
   			"state": "WI",
   			"street": "856 4th Avenue #76"
   		},
   		"CreatedDate": "2017-06-14T18:53:11.000+0000"
   	},
   	{
   		"attributes": {
   			"type": "Contact",
   			"url": "/services/data/v49.0/sobjects/Contact/0033700000TOB6mAAH"
   		},
   		"Name": "Robert0 Taylor",
   		"Id": "0033700000TOB6mAAH",
   		"Phone": "(888) 888-8888",
   		"AccountId": "00137000007D63JAAS",
   		"MailingAddress": {
   			"city": "SF",
   			"country": "US",
   			"geocodeAccuracy": null,
   			"latitude": null,
   			"longitude": null,
   			"postalCode": "99999",
   			"state": "CA",
   			"street": "50 Santa Rita St"
   		},
   		"CreatedDate": "2017-06-13T21:08:25.000+0000"
   	},
   	{
   		"attributes": {
   			"type": "Contact",
   			"url": "/services/data/v49.0/sobjects/Contact/0033700000TNvK0AAL"
   		},
   		"Name": "c1",
   		"Id": "0033700000TNvK0AAL",
   		"AccountId": "0013700000NVE4tAAH",
   		"MailingAddress": null,
   		"CreatedDate": "2017-06-08T20:13:41.000+0000"
   	},
   	{
   		"attributes": {
   			"type": "Contact",
   			"url": "/services/data/v49.0/sobjects/Contact/0033700000TNvKKAA1"
   		},
   		"Name": "c2",
   		"Id": "0033700000TNvKKAA1",
   		"AccountId": "0013700000NVE4tAAH",
   		"MailingAddress": null,
   		"CreatedDate": "2017-06-08T20:13:50.000+0000"
   	},
   	{
   		"attributes": {
   			"type": "Contact",
   			"url": "/services/data/v49.0/sobjects/Contact/0033700000Vs6RzAAJ"
   		},
   		"Name": "Smith",
   		"Id": "0033700000Vs6RzAAJ",
   		"Phone": "(300) 333-3763",
   		"AccountId": "001370000098i8mAAA",
   		"MailingAddress": {
   			"city": "SF",
   			"country": "US",
   			"geocodeAccuracy": null,
   			"latitude": null,
   			"longitude": null,
   			"postalCode": "99999",
   			"state": "CA",
   			"street": "50 Fremont St"
   		},
   		"CreatedDate": "2017-08-16T20:26:07.000+0000"
   	}
   ]

2. Insira outras informações de origem de dados personalizada conforme necessário.

Fluxos iniciados automaticamente em FlexCards

Conecte um FlexCard diretamente a um fluxo iniciado automaticamente do Salesforce. O fluxo iniciado automaticamente é executado em segundo plano sem uma interface do usuário, permitindo que você reutilize a lógica de negócios existente.

Um fluxo iniciado automaticamente é um fluxo que é executado em segundo plano e não requer interação do usuário. Esse tipo de fluxo não oferece suporte a telas e ações locais. Um fluxo iniciado automaticamente permite que os usuários interajam com informações em uma tela ou visualizem as informações mostradas a eles. Para obter mais informações, consulte Tipo de fluxo.

Use um fluxo iniciado automaticamente como fonte de dados para preencher o cartão com a saída do fluxo quando o cartão é carregado ou use-o como uma ação para executar o fluxo iniciado automaticamente quando um usuário interage com o cartão.

Nota Fluxos iniciados automaticamente têm suporte apenas em designers padrão do OmniStudio.

• Adicionar fluxo iniciado automaticamente como fonte de dados do FlexCard
  Adicione um fluxo iniciado automaticamente a um FlexCard e use-o como uma fonte de dados para preencher o cartão com a saída do fluxo.
• Adicionar fluxo iniciado automaticamente como ação do FlexCard
  Adicione um fluxo iniciado automaticamente como uma ação para que ele seja executado quando um usuário interage com o cartão.