Salesforce

O Salesforce Connector fornece uma API para trabalhar com objetos do Salesforce.

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

Serviço	Class	Regiões
Estúdio Copiloto	Premium	Todas as regiões do Power Automatic , exceto as seguintes:      - Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas	Standard	Todas as regiões do Logic Apps , exceto as seguintes:      - Departamento de Defesa dos EUA (DoD)
Aplicações Power	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)
Automatize o poder	Premium	Todas as regiões do Power Automatic , exceto as seguintes:      - Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)

Metadados do conector
Editora	Microsoft

Para usar essa integração, você precisará acessar uma conta do Salesforce com o acesso à API habilitado. Para ver quais edições do Salesforce têm acesso à API, consulte o artigo do Salesforce. Para estabelecer uma ligação, selecione Iniciar sessão. Você será solicitado a fornecer seu login 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.

Observação

O conector Salesforce agora está disponível no Microsoft CoPilot Studio.

Problemas conhecidos e limitações

1. Há um limite para o número de campos que uma consulta ao Salesforce pode conter. O limite varia dependendo do tipo de colunas, do número de colunas computadas, etc. Quando você recebe um erro "A consulta está selecionando muitos campos ou as condições do filtro são muito complicadas", isso significa que sua consulta excede o limite. Para evitar isso, use a opção avançada "Select Query" e especifique os campos que você realmente precisa.
2. As configurações de sessão do Salesforce podem bloquear essa integração. Certifique-se de que a configuração "Bloquear sessões para o endereço IP do qual elas se originaram" está desativada .
3. O acesso à API do Salesforce deve ser habilitado. Para verificar as configurações de acesso, vá para as configurações de perfil do usuário atual e procure por "API habilitada".
4. As contas de avaliação do Salesforce não têm acesso à API e, portanto, não podem ser usadas.
5. Os campos personalizados do tipo "Picklist (Multi-Select)" não são suportados pelas ações Criar registo e Atualizar registo (V3) (incluindo as respetivas versões preteridas).
6. Não há suporte para a criação de uma nova conexão usando o login "Domínio personalizado" do Salesforce.
7. O uso de campos anuláveis no Order By parâmetro deve ser evitado, pois isso pode causar erro de tempo de execução 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 detetar a alteração de registro do objeto padrão, mas não pode detetar a alteração de 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 é criado ou modificado, o gatilho retornará itens novos e modificados. Para verificar se um item retornado é novo ou modificado, compare os valores dos campos "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 aos quais esse gatilho é aplicado.
11. Objetos complexos (objetos com objetos aninhados, veja o exemplo abaixo) não são suportados por Criar registro e Atualizar registro (V3) (incluindo suas respetivas versões preteridas). Para contornar essa limitação, estruturas de objeto planas devem ser usadas.
12. As ações Executar uma consulta SOQL e Obter registros são baseadas na API 'Consulta'. Portanto, nem todos os registros podem ser retornados devido a limitações da API (por exemplo, itens excluídos).
13. Se enfrentar qualquer problema com os dados sendo definidos como valor padrão usando o registro de atualização (V3), isso se deve ao cabeçalho "sforce-auto-assign" definido como true. Para contornar isso, sugere-se usar a ação Enviar uma 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 podem enfrentar um erro "Bad_OAuth_Token/Sessão expirada ou inválida". Por favor, faça o login novamente com suas credenciais.
    • Esta 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 é suportado 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 que é suportado:

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

Carregar anexos

A API do Salesforce oferece suporte ao upload de anexos para os seguintes objetos: 'Conta', 'Ativo', 'Campanha', 'Caso', 'Contato', 'Contrato', 'Objetos personalizados', 'EmailMessage', 'EmailTemplate', 'Evento', 'Lead', 'Oportunidade', 'Produto2', 'Solução', 'Tarefa'. Para carregar o arquivo anexo, use a ação Criar registro e consulte a página de documentação do Salesforce sobre os campos obrigatórios e o significado dos parâmetros.

Funções e operações delegáveis 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 processamento local no Power Apps).

Funções de nível superior

	Delegável
Average	Não
Filter	Yes
LookUp	Yes
Max	Não
Minuto	Não
Pesquisa	Yes
Ordenar	Yes
SortByColumns	Yes
Soma	Não

Predicados de filtro e pesquisa

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

Conector em profundidade

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

Limites Gerais

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

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:

Login com URI de login personalizado do Salesforce	Login com URI de login personalizado do Salesforce	Apenas Governo dos EUA (CCG)	Compartilhável
Faça login com a conta do Salesforce	Forneça credenciais do Salesforce para fazer login.	Todas as regiões	Compartilhável
Padrão [DEPRECATED]	Esta 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

Login com URI de login personalizado do Salesforce

ID de autenticação: CustomLoginURIAuth

Aplicável: apenas Governo dos EUA (GCC)

Login com URI de login personalizado do Salesforce

Esta é 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 de conectores para aplicativos de tela - Power Apps | Documentos Microsoft

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

Faça login com a conta do Salesforce

ID de autenticação: BasicAuthentication

Aplicável: Todas as regiões

Forneça credenciais do Salesforce para fazer login.

Esta é 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 de conectores para aplicativos de tela - Power Apps | Documentos Microsoft

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

Padrão [DEPRECATED]

Aplicável: Todas as regiões

Esta 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.

Esta conexão não é compartilhável. Se o aplicativo avançado 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 login (Ambiente)	cadeia (de caracteres)	O URI de login do Salesforce. Para Produção, deixe em branco ou use https://login.salesforce.com
Versão da API do Salesforce	cadeia (de caracteres)	A versão da API do Salesforce. Por padrão, deixe em branco ou use v58.0

Limites de Limitação

Name	Chamadas	Período de Renovação
Chamadas de API por conexão	900	60 segundos

Ações

Atualizar registro (V3)	Esta operação atualiza um registro e permite valores nulos.
Atualizar registro [DEPRECATED]	Esta ação foi preterida. Em vez disso, use o registro de atualização (V3). Esta operação atualiza um registro e permite valores nulos.
Atualizar registro [DEPRECATED]	Esta operação atualiza um registro.
Carregar dados de trabalho	Carrega dados para um trabalho usando dados CSV.
Criar registo	Esta operação cria um registro e permite valores nulos.
Criar registro [DEPRECATED]	Esta 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 de upload de dados de trabalho.
Criar um trabalho [DEPRECATED]	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 de upload de dados de trabalho.
Eliminar um trabalho	Exclui um trabalho. Para ser excluído, um trabalho deve ter um estado de UploadComplete, JobComplete, Abortado ou Failed.
Enviar uma solicitação HTTP	Construir uma solicitação de API REST do Salesforce para invocar
Excluir registro	Esta operação exclui um registro.
Executar consulta de pesquisa SOSL	Execute o qyery de pesquisa SOSL especificado
Executar uma consulta SOQL	Execute uma consulta SOQL.
Fechar ou anular um trabalho	Fecha ou aborta um trabalho. Use UploadComplete para fechar um trabalho ou Abortado para abortar um trabalho. Se você fechar um trabalho, o Salesforce enfileirará o trabalho e os dados carregados para processamento, e você não poderá adicionar dados adicionais do trabalho. Se você abortar um trabalho, ele não será enfileirado ou processado.
Inserir ou atualizar (atualizar) um registro por ID externo [DEPRECATED]	Esta ação foi preterida. Em vez disso, use Inserir ou Atualizar (Upsert) um Registro por ID Externo (V2). Esta operação insere ou atualiza (upserts) um registro usando uma ID externa.
Inserir ou atualizar (upsert) um registro por ID externo (v2)	Esta operação insere ou atualiza (upserts) um registro usando uma ID externa.
Obtenha registros de oportunidade do Salesforce	Essa operação obtém registros de oportunidade do Salesforce.
Obter informações sobre o emprego	Recupera informações detalhadas sobre um trabalho.
Obter registo	Esta operação obtém um registo.
Obter registos	Essa operação obtém registros de um determinado tipo de objeto do Salesforce, como "Leads".
Obter registro [DEPRECATED]	Esta ação foi preterida. Em vez disso, use Obter registro . Esta operação obtém um registo.
Obter registros de casos do Salesforce	Esta operação obtém registros de casos do Salesforce.
Obter registros de conta do Salesforce	Essa operação obtém registros de conta do Salesforce.
Obter registros de contato do Salesforce	Essa operação obtém registros de contato do Salesforce.
Obter registros de produtos do Salesforce	Esta operação obtém registros de produtos do Salesforce.
Obter registros de usuários do Salesforce	Essa operação obtém registros de usuário do Salesforce.
Obter resultados de 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 do Salesforce disponíveis.
Obter todos os trabalhos	Obtenha uma lista de todas as vagas
Obter um registo por ID externo	Esta operação recupera um registro usando uma ID externa.
Servidor MCP para Salesforce	Servidor MCP para Salesforce

Atualizar registro (V3)

ID da Operação:

PatchItem_V3

Esta operação atualiza um registro e permite valores nulos.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Tipo de objeto do Salesforce	table	True	string	nome da tabela
ID do registo	id	True	string	chave do item
Ponto a atualizar	item	True	dynamic	Ponto a atualizar
Selecionar consulta	$select		string	Campos específicos para recuperar de entradas (padrão = todos).

Devoluções

As saídas desta operação são dinâmicas.

Atualizar registro [DEPRECATED]

ID da Operação:

PatchItem_V2

Esta ação foi preterida. Em vez disso, use o registro de atualização (V3).

Esta operação atualiza um registro e permite valores nulos.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Tipo de objeto do Salesforce	table	True	string	nome da tabela
ID do registo	id	True	string	chave do item
Ponto a atualizar	item	True	dynamic	Ponto a atualizar
Selecionar consulta	$select		string	Campos específicos para recuperar de entradas (padrão = todos).

Devoluções

As saídas desta operação são dinâmicas.

Atualizar registro [DEPRECATED]

ID da Operação:

PatchItem

Esta operação atualiza um registro.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Tipo de objeto do Salesforce	table	True	string	O tipo de objeto Salesforce como "Leads".
ID do registo	id	True	string	O identificador exclusivo do registro a ser atualizado.
Gravar / Registo	item	True	dynamic	O registro com propriedades alteradas.

Devoluções

As saídas desta operação são dinâmicas.

Carregar dados de trabalho

ID da Operação:

UploadJobData

Carrega dados para um trabalho usando dados CSV.

Parâmetros

Name	Chave	Necessário	Tipo	Description
ID do trabalho	jobId	True	string	ID do trabalho
Conteúdo do arquivo CSV	body	True	binary	Dados CSV para carregar

Criar registo

ID da Operação:

PostItem_V2

Esta operação cria um registro e permite valores nulos.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Tipo de objeto do Salesforce	table	True	string	nome da tabela
Gravar / Registo	item	True	dynamic	Gravar / Registo

Devoluções

As saídas desta operação são dinâmicas.

Criar registro [DEPRECATED]

ID da Operação:

PostItem

Esta operação cria um registro.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Tipo de objeto do Salesforce	table	True	string	O tipo de objeto Salesforce como "Leads".
Gravar / Registo	item	True	dynamic	O registo a criar.

Devoluções

As saídas desta operação são dinâmicas.

Criar um trabalho (V2)

ID da Operação:

CreateJobV2

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 de upload de dados de trabalho.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Objeto	object	True	string	O tipo de objeto para os dados que estão sendo processados.
Funcionamento	operation	True	string	A operação de processamento para o trabalho.
Delimitador de Coluna	columnDelimiter		string	O delimitador de coluna usado para dados de trabalho CSV.
Nome do Campo de ID Externo	externalIdFieldName		string	O campo ID externo no objeto que está sendo atualizado. Apenas necessário para operações de upsert. Os valores de campo também devem existir nos dados de trabalho CSV.
Fim de linha	lineEnding		string	A terminação da linha usada para dados de trabalho CSV, marcando o final de uma linha de dados.
Tipo de conteúdo	contentType		string	O tipo de conteúdo para o trabalho.

Devoluções

Saída para a operação 'CreateJobV2'

Body

CreateJobResponse

Criar um trabalho [DEPRECATED]

ID da Operação:

CreateJob

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 de upload de dados de trabalho.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Delimitador de Coluna	columnDelimiter		string	Delimitador de Coluna
Nome do Campo de ID Externo	externalIdFieldName		string	Nome do Campo de ID Externo
Fim de linha	lineEnding		string	Fim de linha
Objeto	object	True	string	Objeto
Funcionamento	operation	True	string	Funcionamento

Devoluções

Body

JobInfo

Eliminar um trabalho

ID da Operação:

DeleteJob

Exclui um trabalho. Para ser excluído, um trabalho deve ter um estado de UploadComplete, JobComplete, Abortado ou Failed.

Parâmetros

Name	Chave	Necessário	Tipo	Description
ID do trabalho	jobId	True	string	ID do trabalho

Enviar uma solicitação HTTP

ID da Operação:

HttpRequest

Construir uma solicitação de API REST do Salesforce para invocar

Parâmetros

Name	Chave	Necessário	Tipo	Description
URI	Uri	True	string	O URI completo ou relativo. Exemplo de URI relativo: /services/data/v41.0/sobjects/account
Método	Method	True	string	O método HTTP (o padrão é GET).
Body	Body		binary	O conteúdo do corpo da solicitação.
Tipo de conteúdo	ContentType		string	O cabeçalho do tipo de conteúdo para o corpo (o padrão é application/json).
CustomHeader1	CustomHeader1		string	Cabeçalho personalizado 1. Especificar em formato: header-name: header-value
CustomHeader2	CustomHeader2		string	Cabeçalho personalizado 2. Especificar em formato: header-name: header-value
CustomHeader3	CustomHeader3		string	Cabeçalho personalizado 3. Especificar em formato: header-name: header-value
CustomHeader4	CustomHeader4		string	Cabeçalho personalizado 4. Especificar em formato: header-name: header-value
CustomHeader5	CustomHeader5		string	Cabeçalho personalizado 5. Especificar em formato: header-name: header-value

Devoluções

response

ObjectWithoutType

Excluir registro

ID da Operação:

DeleteItem

Esta operação exclui um registro.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Tipo de objeto do Salesforce	table	True	string	O tipo de objeto Salesforce como "Leads".
ID do registo	id	True	string	O identificador exclusivo do registro a ser excluído.

Executar consulta de pesquisa SOSL

ID da Operação:

ExecuteSOSLQuery

Execute o qyery de pesquisa SOSL especificado

Parâmetros

Name	Chave	Necessário	Tipo	Description
Cadeia de pesquisa SOSL	q	True	string	Cadeia de pesquisa SOSL

Devoluções

Resposta da consulta de pesquisa SOSL

Body

SOSLSearchQueryResponse

Executar uma consulta SOQL

ID da Operação:

ExecuteSoqlQuery

Execute uma consulta SOQL.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Consulta SOQL	query	True	string	Texto da consulta SOQL. Os parâmetros dinâmicos podem ser especificados usando a sintaxe '@paramName'.
Parâmetros de consulta	parameters		object	Parâmetros dinâmicos de consulta SOQL. Chave é nome do parâmetro (sem '@' no sinal), valor é valor do parâmetro.

Devoluções

response

object

Fechar ou anular um trabalho

ID da Operação:

CloseJob

Fecha ou aborta um trabalho. Use UploadComplete para fechar um trabalho ou Abortado para abortar um trabalho. Se você fechar um trabalho, o Salesforce enfileirará o trabalho e os dados carregados para processamento, e você não poderá adicionar dados adicionais do trabalho. Se você abortar um trabalho, ele não será enfileirado ou processado.

Parâmetros

Name	Chave	Necessário	Tipo	Description
ID do trabalho	jobId	True	string	ID do trabalho
state	state	True	string	state

Devoluções

Body

JobInfo

Inserir ou atualizar (atualizar) um registro por ID externo [DEPRECATED]

ID da Operação:

PatchItemByExternalId

Esta ação foi preterida. Em vez disso, use Inserir ou Atualizar (Upsert) um Registro por ID Externo (V2).

Esta operação insere ou atualiza (upserts) um registro usando uma ID externa.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Tipo de objeto do Salesforce	table	True	string	O tipo de objeto Salesforce como "Leads".
Campo ID Externo	externalIdField	True	string	Campo marcado como campo de ID externo no objeto Salesforce.
ID externo	externalId	True	string	ID externo do registro a ser atualizado.
Gravar / Registo	item	True	dynamic	O registro com propriedades alteradas.

Devoluções

As saídas desta operação são dinâmicas.

Inserir ou atualizar (upsert) um registro por ID externo (v2)

ID da Operação:

PatchItemByExternalIdV2

Esta operação insere ou atualiza (upserts) um registro usando uma ID externa.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Tipo de objeto do Salesforce	table	True	string	O tipo de objeto Salesforce como "Leads".
Campo ID Externo	externalIdField	True	string	Campo marcado como campo de ID externo no objeto Salesforce.
ID externo	externalId	True	string	ID externo do registro a ser atualizado.
Gravar / Registo	item	True	dynamic	O registro com propriedades alteradas.

Devoluções

As saídas desta operação são dinâmicas.

Obtenha registros de oportunidade do Salesforce

ID da Operação:

GetItems_table_opportunity

Essa operação obtém registros de oportunidade do Salesforce.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Filtrar consulta	$filter		string	Uma consulta de filtro ODATA para restringir as entradas retornadas (por exemplo, stringColumn eq 'string' OR numberColumn lt 123).
Encomendar por	$orderby		string	Uma ordem ODATAPor consulta para especificar a ordem das entradas.
Contagem superior	$top		integer	Número total de entradas a recuperar (padrão = todas).
Pular contagem	$skip		integer	O número de entradas a serem ignoradas (padrão = 0).
Selecionar consulta	$select		string	Campos específicos para recuperar de entradas (padrão = todos).

Devoluções

As saídas desta operação são dinâmicas.

Obter informações sobre o emprego

ID da Operação:

GetJobInfo

Recupera informações detalhadas sobre um trabalho.

Parâmetros

Name	Chave	Necessário	Tipo	Description
ID do trabalho	jobId	True	string	ID do trabalho

Devoluções

Body

CheckJobResponse

Obter registo

ID da Operação:

GetItem_V2

Esta operação obtém um registo.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Tipo de objeto do Salesforce	table	True	string	nome da tabela
ID do registo	id	True	string	chave do item
Selecionar consulta	$select		string	Campos específicos para recuperar de entradas (padrão = todos).

Devoluções

As saídas desta operação são dinâmicas.

Obter registos

ID da Operação:

GetItems

Essa operação obtém registros de um determinado tipo de objeto do Salesforce, como "Leads".

Parâmetros

Name	Chave	Necessário	Tipo	Description
Tipo de objeto do Salesforce	table	True	string	O tipo de objeto Salesforce como "Leads".
Filtrar consulta	$filter		string	Uma consulta de filtro ODATA para restringir as entradas retornadas (por exemplo, stringColumn eq 'string' OR numberColumn lt 123).
Encomendar por	$orderby		string	Uma ordem ODATAPor consulta para especificar a ordem das entradas.
Contagem superior	$top		integer	Número total de entradas a recuperar (padrão = todas).
Pular contagem	$skip		integer	O número de entradas a serem ignoradas (padrão = 0).
Selecionar consulta	$select		string	Campos específicos para recuperar de entradas (padrão = todos).

Devoluções

As saídas desta operação são dinâmicas.

Obter registro [DEPRECATED]

ID da Operação:

GetItem

Esta ação foi preterida. Em vez disso, use Obter registro .

Esta operação obtém um registo.

Parâmetros

Name	Chave	Necessário	Tipo	Description
tabela	table	True	string
id	id	True	string

Devoluções

As saídas desta operação são dinâmicas.

Obter registros de casos do Salesforce

ID da Operação:

GetItems_table_case

Esta operação obtém registros de casos do Salesforce.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Filtrar consulta	$filter		string	Uma consulta de filtro ODATA para restringir as entradas retornadas (por exemplo, stringColumn eq 'string' OR numberColumn lt 123).
Encomendar por	$orderby		string	Uma ordem ODATAPor consulta para especificar a ordem das entradas.
Contagem superior	$top		integer	Número total de entradas a recuperar (padrão = todas).
Pular contagem	$skip		integer	O número de entradas a serem ignoradas (padrão = 0).
Selecionar consulta	$select		string	Campos específicos para recuperar de entradas (padrão = todos).

Devoluções

As saídas desta operação são dinâmicas.

Obter registros de conta do Salesforce

ID da Operação:

GetItems_table_account

Essa operação obtém registros de conta do Salesforce.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Filtrar consulta	$filter		string	Uma consulta de filtro ODATA para restringir as entradas retornadas (por exemplo, stringColumn eq 'string' OR numberColumn lt 123).
Encomendar por	$orderby		string	Uma ordem ODATAPor consulta para especificar a ordem das entradas.
Contagem superior	$top		integer	Número total de entradas a recuperar (padrão = todas).
Pular contagem	$skip		integer	O número de entradas a serem ignoradas (padrão = 0).
Selecionar consulta	$select		string	Campos específicos para recuperar de entradas (padrão = todos).

Devoluções

As saídas desta operação são dinâmicas.

Obter registros de contato do Salesforce

ID da Operação:

GetItems_table_contact

Essa operação obtém registros de contato do Salesforce.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Filtrar consulta	$filter		string	Uma consulta de filtro ODATA para restringir as entradas retornadas (por exemplo, stringColumn eq 'string' OR numberColumn lt 123).
Encomendar por	$orderby		string	Uma ordem ODATAPor consulta para especificar a ordem das entradas.
Contagem superior	$top		integer	Número total de entradas a recuperar (padrão = todas).
Pular contagem	$skip		integer	O número de entradas a serem ignoradas (padrão = 0).
Selecionar consulta	$select		string	Campos específicos para recuperar de entradas (padrão = todos).

Devoluções

As saídas desta operação são dinâmicas.

Obter registros de produtos do Salesforce

ID da Operação:

GetItems_table_product2

Esta operação obtém registros de produtos do Salesforce.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Filtrar consulta	$filter		string	Uma consulta de filtro ODATA para restringir as entradas retornadas (por exemplo, stringColumn eq 'string' OR numberColumn lt 123).
Encomendar por	$orderby		string	Uma ordem ODATAPor consulta para especificar a ordem das entradas.
Contagem superior	$top		integer	Número total de entradas a recuperar (padrão = todas).
Pular contagem	$skip		integer	O número de entradas a serem ignoradas (padrão = 0).
Selecionar consulta	$select		string	Campos específicos para recuperar de entradas (padrão = todos).

Devoluções

As saídas desta operação são dinâmicas.

Obter registros de usuários do Salesforce

ID da Operação:

GetItems_table_user

Essa operação obtém registros de usuário do Salesforce.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Filtrar consulta	$filter		string	Uma consulta de filtro ODATA para restringir as entradas retornadas (por exemplo, stringColumn eq 'string' OR numberColumn lt 123).
Encomendar por	$orderby		string	Uma ordem ODATAPor consulta para especificar a ordem das entradas.
Contagem superior	$top		integer	Número total de entradas a recuperar (padrão = todas).
Pular contagem	$skip		integer	O número de entradas a serem ignoradas (padrão = 0).
Selecionar consulta	$select		string	Campos específicos para recuperar de entradas (padrão = todos).

Devoluções

As saídas desta operação são dinâmicas.

Obter resultados de trabalho

ID da Operação:

GetJobRecordResults

Recupera uma lista de registros com base no tipo de resultado de um trabalho concluído.

Parâmetros

Name	Chave	Necessário	Tipo	Description
ID do trabalho	jobId	True	string	ID do trabalho
Tipo de resultado	resultType	True	string	Tipo de resultado

Devoluções

response

string

Obter tipos de objeto

ID da Operação:

GetTables

Esta operação lista os tipos de objeto do Salesforce disponíveis.

Devoluções

Representa uma lista de tabelas.

Body

TablesList

Obter todos os trabalhos

ID da Operação:

GetAllJobs

Obtenha uma lista de todas as vagas

Parâmetros

Name	Chave	Necessário	Tipo	Description
Modo de simultaneidade	concurrenyMode		string	Modo de simultaneidade
O PK Chunking está habilitado	isPkChunkingEnabled		boolean	O PK Chunking está habilitado
Tipo de trabalho	jobType		string	Tipo de trabalho
Localizador de Consultas	queryLocator		string	Localizador de Consultas

Devoluções

Body

GetAllJobsResponse

Obter um registo por ID externo

ID da Operação:

GetItemByExternalId

Esta operação recupera um registro usando uma ID externa.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Tipo de objeto do Salesforce	table	True	string	O tipo de objeto Salesforce como "Leads".
Campo ID Externo	externalIdField	True	string	Campo marcado como campo de ID externo no objeto Salesforce.
ID externo	externalId	True	string	ID externa do registro a ser recuperado.

Devoluções

As saídas desta operação são dinâmicas.

Servidor MCP para Salesforce

ID da Operação:

mcp_SalesforceManagement

Servidor MCP para Salesforce

Parâmetros

Name	Chave	Necessário	Tipo	Description
jsonrpc	jsonrpc		string
id	id		string
método	method		string
parâmetros	params		object
Resultado	result		object
erro	error		object
ID de sessão	sessionId		string

Devoluções

Body

MCPQueryResponse

Acionadores

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

Quando um registo é criado

ID da Operação:

GetOnNewItems

Essa operação é acionada quando há registros recém-criados.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Tipo de objeto do Salesforce	table	True	string	O tipo de objeto Salesforce como "Leads".
Filtrar consulta	$filter		string	Uma consulta de filtro ODATA para restringir as entradas retornadas (por exemplo, stringColumn eq 'string' OR numberColumn lt 123).
Encomendar por	$orderby		string	Uma ordem ODATAPor consulta para especificar a ordem das entradas.
Selecionar consulta	$select		string	Campos específicos para recuperar de entradas (padrão = todos).

Devoluções

As saídas desta operação são dinâmicas.

Quando um registo é modificado

ID da Operação:

GetOnUpdatedItems

Essa operação é acionada quando há registros recém-modificados.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Tipo de objeto do Salesforce	table	True	string	O tipo de objeto Salesforce como "Leads".
Filtrar consulta	$filter		string	Uma consulta de filtro ODATA para restringir as entradas retornadas (por exemplo, stringColumn eq 'string' OR numberColumn lt 123).
Encomendar por	$orderby		string	Uma ordem ODATAPor consulta para especificar a ordem das entradas.
Selecionar consulta	$select		string	Campos específicos para recuperar de entradas (padrão = todos).

Devoluções

As saídas desta operação são dinâmicas.

Definições

CreateJobResponse

Saída para a operação 'CreateJobV2'

Name	Caminho	Tipo	Description
Objeto	object	string	O tipo de objeto para os dados que estão sendo processados.
Funcionamento	operation	string	A operação de processamento para o trabalho.
Delimitador de Coluna	columnDelimiter	string	O delimitador de coluna usado para dados de trabalho CSV.
Nome do Campo de ID Externo	externalIdFieldName	string	O campo ID externo no objeto que está sendo atualizado. Apenas necessário para operações de upsert. Os valores de campo também devem existir nos dados de trabalho CSV.
Fim de linha	lineEnding	string	A terminação da linha usada para dados de trabalho CSV, marcando o final de uma linha de dados.
Tipo de conteúdo	contentType	string	O tipo de conteúdo para o trabalho.
Versão da API	apiVersion	float	A versão da API na qual o trabalho foi criado.
Modo de simultaneidade	concurrencyMode	string	O modo de simultaneidade para o trabalho.
URL do conteúdo	contentUrl	string	A URL a ser usada para solicitações de Upload de Dados de Trabalho para este trabalho. Válido apenas se o trabalho estiver no estado 'Aberto'.
Criado por Id	createdById	string	A ID do usuário que criou o trabalho.
Data de criação	createdDate	date-time	A data e a hora no fuso horário UTC quando o trabalho foi criado.
Id	id	string	ID exclusivo para este trabalho.
Tipo de trabalho	jobType	string	O tipo de trabalho.
Estado	state	string	O estado atual do processamento do trabalho.
Sistema Modstamp	systemModstamp	date-time	Data e hora no fuso horário UTC quando o trabalho terminou.

Table

Representa uma tabela.

Name	Caminho	Tipo	Description
Nome	Name	string	O nome da tabela. O nome é usado em tempo de execução.
Nome de Exibição	DisplayName	string	O nome para exibição da tabela.
DynamicProperties	DynamicProperties	object	Propriedades de tabela adicionais fornecidas pelo conector para os clientes.

Lista de Tabelas

Representa uma lista de tabelas.

Name	Caminho	Tipo	Description
valor	value	array of Table	Lista de Tabelas

GetAllJobsResponse

Name	Caminho	Tipo	Description
Concluído	done	boolean	Concluído
registos	records	array of JobInfo
Próximo URL remarcado	nextRecordUrl	string	URL do próximo registo

JobInfo

Name	Caminho	Tipo	Description
Versão da API	apiVersion	float	Versão da API
Delimitador de Coluna	columnDelimiter	string	Delimitador de Coluna
Modo de simultaneidade	concurrencyMode	string	Modo de simultaneidade
Tipo de conteúdo	contentType	string	Tipo de conteúdo
URL do conteúdo	contentUrl	string	URL do conteúdo
Criado por ID	createdById	string	Criado por ID
Data de criação	createdDate	date-time	Data de criação
Nome do Campo de ID Externo	externalIdFieldName	string	Nome do Campo de ID Externo
ID	id	string	ID
Tipo de trabalho	jobType	string	Tipo de trabalho
Fim de linha	lineEnding	string	Fim de linha
Objeto	object	string	Objeto
Funcionamento	operation	string	Funcionamento
Estado	state	string	Estado
Sistema Mod Stamp	systemModstamp	date-time	Sistema Mod Stamp

CheckJobResponse

Name	Caminho	Tipo	Description
Tempo de processamento APEX	apexProcessingTime	number	Tempo de processamento APEX
Tempo de processamento ativo da API	apiActiveProcessingTime	number	Tempo de processamento ativo da API
Versão da API	apiVersion	float	Versão da API
Delimitador de Coluna	columnDelimiter	string	Delimitador de Coluna
Modo de simultaneidade	concurrencyMode	string	Modo de simultaneidade
Tipo de conteúdo	contentType	string	Tipo de conteúdo
URL do conteúdo	contentUrl	string	URL do conteúdo
Criado por ID	createdById	string	Criado por ID
Data de criação	createdDate	date-time	Data de criação
Nome do campo externo	externalFieldName	string	Nome do campo externo
ID	id	string	ID
Tipo de trabalho	jobType	string	Tipo de trabalho
Fim de linha	lineEnding	string	Fim de linha
Objeto	object	string	Objeto
Funcionamento	operation	string	Funcionamento
Repetições	retries	number	Repetições
Estado	state	string	Estado
sistemaModStamp	systemModStamp	date-time
Tempo total de processamento	totalProcessingTime	number	Tempo total de processamento

SOSLSearchQueryResponse

Resposta da consulta de pesquisa SOSL

Name	Caminho	Tipo	Description
pesquisaRegistos	searchRecords	array of SearchRecordObject	Uma lista de registros de pesquisa retornados por uma consulta de pesquisa SOSL

SearchRecordObject

Registro individual retornado pela consulta SOSL

Name	Caminho	Tipo	Description
tipo	attributes.type	string	Tipo de registo
URL	attributes.url	string	Caminho da API que pode ser usado para recuperar o objeto
Id	Id	string	Identificador único do registo

ObjectWithoutType

MCPQueryResponse

Name	Caminho	Tipo	Description
jsonrpc	jsonrpc	string
id	id	string
método	method	string
parâmetros	params	object
Resultado	result	object
erro	error	object

cadeia (de caracteres)

Este é o tipo de dados básico 'string'.

objecto

Este é o tipo 'objeto'.