Salesforce

Esse conector está disponível nos seguintes produtos e regiões:

Service	Class	Regions
Copilot Studio	Premium	Todas as regiões do Power Automate , exceto as seguintes:      – Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)
Aplicativos Lógicos	Standard	Todas as regiões dos Aplicativos Lógicos , exceto as seguintes:      - Departamento de Defesa dos EUA (DoD)
Power Apps	Premium	Todas as regiões do Power Apps , exceto as seguintes:      – Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)
Power Automate	Premium	Todas as regiões do Power Automate , exceto as seguintes:      – Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)

Metadados do conector
Publicador	Microsoft

Para usar essa integração, você precisará de acesso a uma conta do Salesforce com acesso à API habilitado. Para ver quais edições do Salesforce têm acesso à API, verifique o artigo do Salesforce. Para fazer uma conexão, selecione Entrar. Você será solicitado a fornecer seu logon do Salesforce, siga o restante das telas para criar uma conexão. A versão padrão da API atualmente utilizada pelo conector é v58.0.

Agora você está pronto para começar a usar essa integração.

Problemas e limitações conhecidos

1. Há um limite no número de campos que uma consulta ao Salesforce pode conter. O limite varia dependendo do tipo das colunas, do número de colunas computadas etc. Quando você recebe um erro "A consulta está selecionando muitos campos ou as condições de filtro são muito complicadas", isso significa que sua consulta excede o limite. Para evitar isso, use a opção avançada "Selecionar Consulta" e especifique os campos de que você realmente precisa.
2. As configurações de sessão do Salesforce podem bloquear essa integração. Verifique se a configuração "Bloquear sessões para o endereço IP do qual elas se originaram" está desabilitada .
3. O acesso à API do Salesforce deve ser habilitado. Para verificar as configurações de acesso, acesse as configurações de perfil do usuário atual e pesquise a caixa de seleção "API Habilitada".
4. As contas de avaliação do Salesforce não têm acesso à API e, portanto, não podem ser usadas.
5. Não há suporte para campos personalizados do tipo "Lista de seleção (várias seleções)" por ações criar registro e atualizar registro (V3) (incluindo suas respectivas versões preteridas).
6. Não há suporte para a criação de uma nova conexão usando a entrada "Domínio Personalizado" do Salesforce.
7. O uso de campos anuláveis no Order By parâmetro deve ser evitado, pois isso pode causar um erro de runtime nas seguintes operações: Obter registros, quando um registro é criado, quando um registro é criado ou modificado.
8. Quando um registro é modificado , o gatilho só pode detectar a alteração de registro do objeto padrão, mas não pode detectar a alteração do anexo do objeto padrão.
9. Os seguintes gatilhos e ações não puderam funcionar corretamente em tabelas personalizadas sem a coluna "Id": quando um registro é criado, quando um registro é criado ou modificado, Obter registro, Criar registro, Atualizar registro (V3), Excluir registro.
10. Quando um registro for criado ou modificado , o gatilho retornará itens novos e modificados. Para verificar se um item retornado é novo ou modificado, compare seus valores de campo "CreatedDate" e "LastModifiedDate". Em novos itens, espera-se que esses valores sejam iguais. Nesse sentido, ambos os campos são obrigatórios para os itens para os quais esse gatilho é aplicado.
11. Objetos complexos (objetos com objetos aninhados, veja o exemplo abaixo) não têm suporte para Criar registro e registro de atualização (V3) ( incluindo suas respectivas versões preteridas). Para solucionar essa limitação, estruturas de objeto simples devem ser usadas.
12. Executar uma consulta SOQL e obter ações de registros são baseadas na API 'Consulta'. Portanto, nem todos os registros podem ser retornados devido a limitações de API (por exemplo, itens excluídos).
13. Se estiver enfrentando qualquer problema com a definição de dados como valor padrão usando o registro de atualização (V3), isso ocorre devido ao cabeçalho "sforce-auto-assign" definido como true. Para solucionar isso, é sugerido usar Enviar uma ação de solicitação HTTP e definir o valor do cabeçalho personalizado como "sforce-auto-assign: false"
14. O conector salesforce tem tratamento especial para autenticação, no entanto, devido a uma limitação no back-end do Salesforce, os tokens expirarão se não forem usados por um longo período de tempo e os usuários poderão enfrentar um erro "Bad_OAuth_Token/Sessão expirado ou inválido". Faça logon novamente com suas credenciais.
    • Essa limitação agora é resolvida, no entanto, uma nova conexão deve ser criada para uso. A conexão pré-existente ainda funcionará, mas o problema acima pode ser enfrentado.

Exemplo de um objeto complexo que não tem suporte porque tem um objeto aninhado com MerchandiseExtID__c campo:

{
    "Name" : "LineItemCreatedViaExtID",
    "Merchandise__r" :
    {
        "MerchandiseExtID__c" : 123
    }
}

Exemplo do objeto complexo acima reescrito como um objeto simples com suporte do IS:

{
    "Name" : "LineItemCreatedViaExtID",
    "MerchandiseExtID__c" : 123
}

Carregando anexos

A API do Salesforce dá suporte ao carregamento de anexos para os seguintes objetos: 'Account', 'Asset', 'Campaign', 'Case', 'Contact', 'Contract', 'Custom objects', 'EmailMessage', 'EmailTemplate', 'Event', 'Lead', 'Opportunity', 'Product2', 'Solution', 'Task'. Para carregar o arquivo de anexo, use a ação Criar registro e consulte a página de documentação do Salesforce sobre o significado dos campos e parâmetros necessários.

Funções e operações delegadas do Power Apps para Salesforce

Essas operações do Power Apps, para um determinado tipo de dados, podem ser delegadas ao Salesforce para processamento (em vez de processar localmente no Power Apps).

Funções de nível superior

	Delegavel
Mediana	Não
Filter	Yes
LookUp	Yes
Máximo	Não
Minuto	Não
Pesquisa	Yes
Classificar	Yes
SortByColumns	Yes
Soma	Não

Predicados de filtragem e pesquisa

	Salesforce
Não	Yes
IsBlank	Não
TrimEnds	Não
Len	Não
+, -	Não
<, <=, =, <>, , >>=	Yes
E (&&), ou (||), não (!)	Yes
mergulhar	Yes
StartsWith	Não

Conector aprofundado

Para obter mais informações sobre o conector, consulte a seção detalhada.

Limites Gerais

Nome	Value
Número máximo de solicitações sendo processadas pelo conector simultaneamente	50

Criando uma conexão

O conector dá suporte aos seguintes tipos de autenticação:

Fazer logon com o URI de Logon do Salesforce Personalizado	Fazer logon com o URI de Logon do Salesforce Personalizado	Somente governo dos EUA (GCC)	Compartilhável
Fazer logon com a conta do Salesforce	Forneça credenciais do Salesforce para logon.	Todas as regiões	Compartilhável
Padrão [PRETERIDO]	Essa opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores.	Todas as regiões	Não compartilhável

Fazer logon com o URI de Logon do Salesforce Personalizado

ID de autenticação: CustomLoginURIAuth

Aplicável: somente governo dos EUA (GCC)

Fazer logon com o URI de Logon do Salesforce Personalizado

Essa é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, a conexão também será compartilhada. Para obter mais informações, consulte a visão geral dos Conectores para aplicativos de tela – Power Apps | Microsoft Docs

Nome	Tipo	Description	Obrigatório
URI de Logon do Salesforce	cadeia	https://custom-___domain-or-instance.my.salesforce.com	Verdade
Versão da API do Salesforce	cadeia	A versão da API do Salesforce. Por padrão, deixe em branco ou use v58.0

Fazer logon com a conta do Salesforce

ID de autenticação: BasicAuthentication

Aplicável: todas as regiões

Forneça credenciais do Salesforce para logon.

Essa é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, a conexão também será compartilhada. Para obter mais informações, consulte a visão geral dos Conectores para aplicativos de tela – Power Apps | Microsoft Docs

Nome	Tipo	Description	Obrigatório
URI de logon (Ambiente)	cadeia	O URI de Logon do Salesforce. Para Produção, deixe em branco ou use https://login.salesforce.com
Versão da API do Salesforce	cadeia	A versão da API do Salesforce. Por padrão, deixe em branco ou use v58.0

Padrão [PRETERIDO]

Aplicável: todas as regiões

Essa opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores.

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome	Tipo	Description	Obrigatório
URI de logon (Ambiente)	cadeia	O URI de Logon do Salesforce. Para Produção, deixe em branco ou use https://login.salesforce.com
Versão da API do Salesforce	cadeia	A versão da API do Salesforce. Por padrão, deixe em branco ou use v58.0

Limitações

Nome	Chamadas	Período de renovação
Chamadas à API por conexão	900	60 segundos

Ações

Atualizar registro (V3)	Essa operação atualiza um registro e permite valores nulos.
Atualizar registro [PRETERIDO]	Esta ação foi preterida. Em vez disso, use o registro de atualização (V3 ). Essa operação atualiza um registro e permite valores nulos.
Atualizar registro [PRETERIDO]	Esta operação atualiza um registro.
Carregar dados do trabalho	Carrega dados de um trabalho usando dados CSV.
Criar registro	Essa operação cria um registro e permite valores nulos.
Criar registro [PRETERIDO]	Essa operação cria um registro.
Criar um trabalho (V2)	Cria um trabalho, que representa uma operação em massa (e dados associados) que é enviada ao Salesforce para processamento assíncrono. Forneça dados de trabalho por meio de uma solicitação carregar dados do trabalho.
Criar um trabalho [PRETERIDO]	Esta ação foi preterida. Em vez disso, use Criar um trabalho (V2 ). Cria um trabalho, que representa uma operação em massa (e dados associados) que é enviada ao Salesforce para processamento assíncrono. Forneça dados de trabalho por meio de uma solicitação carregar dados do trabalho.
Enviar uma solicitação HTTP	Construir uma solicitação da API REST do Salesforce para invocar
Excluir registro	Essa operação exclui um registro.
Excluir um trabalho	Exclui um trabalho. Para ser excluído, um trabalho deve ter um estado de UploadComplete, JobComplete, Abortado ou Com Falha.
Executar consulta de pesquisa SOSL	Executar o qyery de pesquisa SOSL especificado
Executar uma consulta SOQL	Execute uma consulta SOQL.
Fechar ou anular um trabalho	Fecha ou anula um trabalho. Use UploadComplete para fechar um trabalho ou Abortado para anular um trabalho. Se você fechar um trabalho, o Salesforce enfileira o trabalho e os dados carregados para processamento e você não pode adicionar nenhum dado de trabalho adicional. Se você anular um trabalho, o trabalho não será enfileirado ou processado.
Inserir ou atualizar (Upsert) um registro por ID externa (V2)	Esta operação insere ou atualiza (upserts) um registro usando uma ID externa.
Inserir ou atualizar (Upsert) um registro por ID externa [PRETERIDO]	Esta ação foi preterida. Em vez disso, use Inserir ou Atualizar (Upsert) um Registro por ID Externa (V2 ). Esta operação insere ou atualiza (upserts) um registro usando uma ID externa.
Obter informações de trabalho	Recupera informações detalhadas sobre um trabalho.
Obter registro	Esta operação obtém um registro.
Obter registro [PRETERIDO]	Esta ação foi preterida. Em vez disso, use Obter registro . Esta operação obtém um registro.
Obter registros	Esta operação obtém registros de um determinado tipo de objeto Salesforce, como 'Leads'.
Obter registros case do Salesforce	Esta operação obtém registros case do Salesforce.
Obter registros de conta do Salesforce	Esta operação obtém registros de conta do Salesforce.
Obter registros de contato do Salesforce	Esta operação obtém registros de contato do Salesforce.
Obter registros de oportunidade do Salesforce	Esta operação obtém registros de oportunidade do Salesforce.
Obter registros de produto do Salesforce	Esta operação obtém registros de produto do Salesforce.
Obter registros de usuário do Salesforce	Esta operação obtém registros de usuário do Salesforce.
Obter resultados do trabalho	Recupera uma lista de registros com base no tipo de resultado de um trabalho concluído.
Obter tipos de objeto	Esta operação lista os tipos de objeto salesforce disponíveis.
Obter todos os trabalhos	Obter uma lista de todos os trabalhos
Obter um registro por ID externa	Essa operação recupera um registro usando uma ID externa.
Servidor MCP para Salesforce	Servidor MCP para Salesforce

Atualizar registro (V3)

Atualizar registro [PRETERIDO]

Atualizar registro [PRETERIDO]

Carregar dados do trabalho

Criar registro

Criar registro [PRETERIDO]

Criar um trabalho (V2)

Criar um trabalho [PRETERIDO]

Enviar uma solicitação HTTP

Excluir registro

Excluir um trabalho

Executar consulta de pesquisa SOSL

Executar uma consulta SOQL

Fechar ou anular um trabalho

Inserir ou atualizar (Upsert) um registro por ID externa (V2)

Inserir ou atualizar (Upsert) um registro por ID externa [PRETERIDO]

Obter informações de trabalho

Obter registro

Obter registro [PRETERIDO]

Obter registros

Obter registros case do Salesforce

Obter registros de conta do Salesforce

Obter registros de contato do Salesforce

Obter registros de oportunidade do Salesforce

Obter registros de produto do Salesforce

Obter registros de usuário do Salesforce

Obter resultados do trabalho

Obter tipos de objeto

Obter todos os trabalhos

Obter um registro por ID externa

Servidor MCP para Salesforce

Gatilhos

Quando um registro é criado	Essa operação é disparada quando há registros recém-criados.
Quando um registro é modificado	Essa operação é disparada quando há registros recém-modificados.

Quando um registro é criado

Quando um registro é modificado

Definições

CreateJobResponse

Table

TablesList

GetAllJobsResponse

JobInfo

CheckJobResponse

SOSLSearchQueryResponse

SearchRecordObject

ObjectWithoutType

MCPQueryResponse

cadeia

objeto