CloudTools for Salesforce (Pré-visualização)
O Apptigent CloudTools fornece uma variedade de ações de integração de dados para o Salesforce que podem ser acessadas por qualquer aplicativo ou fluxo de trabalho conectado à nuvem.
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 (CCG) - 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: - Regiões do Azure Government - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Aplicações Power | Premium | Todas as regiões do Power Apps , exceto as seguintes: - Governo dos EUA (CCG) - 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 (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Suporte Apptigent |
| URL | https://www.apptigent.com/help |
| support@apptigent.com |
| Metadados do conector | |
|---|---|
| Editora | Apelante |
| Sítio Web | https://www.apptigent.com |
| Política de privacidade | https://www.apptigent.com/help/privacy-policy/ |
| Categorias | Produtividade |
Automatize processos de negócios críticos com integração perfeita na nuvem entre plataformas para o Salesforce. Conecte facilmente o Power Apps e o Power Automate à sua organização do Salesforce para recuperar informações de clientes, fechar negócios, criar registros, converter leads, executar trabalhos em massa, executar ações rápidas, carregar arquivos, associar documentos a registros, atualizar feeds, recuperar arquivos vinculados e muito mais. Você pode até mesmo executar consultas avançadas e seaches usando SOQL, SOSL e GraphQL. O CloudTools libera o potencial dos dados do CRM da sua empresa, tornando-os facilmente acessíveis a partir de qualquer aplicativo ou fluxo de trabalho.
Pré-requisitos
O CloudTools requer uma licença válida do Salesforce, a instalação do pacote gerenciado do CloudTools em uma organização do Salesforce (qualquer edição) e uma assinatura atual do CloudTools (cobrada separadamente). Para obter instruções passo-a-passo sobre como começar, visite https://www.apptigent.com/solutions/cloudtools/configuration.
Como obter credenciais
Gere uma chave de licença (API) seguindo estas etapas simples:
- Instale o pacote gerenciado do CloudTools por meio do Salesforce App Exchange.
- Inicie a página de configuração do CloudTools selecionando o link "Apptigent CloudTools" no Iniciador de aplicativos.
- Siga as instruções na tela para criar um aplicativo conectado e gerar uma chave de licença.
- Copie a chave e forneça-a na nova caixa de diálogo de conexão em Power Apps, Power Automatizate ou Azure Logic Apps.
Problemas conhecidos e limitações
A instalação e configuração do CloudTools for Salesforce Sales Cloud requer permissões de administrador do sistema no Salesforce. Entre em contato com o administrador do Salesforce para obter assistência se você não tiver permissões suficientes em sua organização.
A criar uma ligação
O conector suporta os seguintes tipos de autenticação:
| Predefinição | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: Todas as regiões
Parâmetros para criar conexão.
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 |
|---|---|---|---|
| Chave de licença | securestring | A chave de licença do CloudTools | Verdade |
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
Ações
| Arquivos - Compartilhar documento |
Associar um arquivo (ContentDocument) a um registro e definir as propriedades de compartilhamento |
| Arquivos - Criar link público |
Criar um link de arquivo público que usuários não autenticados possam acessar |
| Arquivos - Criar Versão |
Carregar um arquivo como um novo objeto ContentVersion |
| Arquivos - Informações de versão |
Recuperar informações sobre uma versão de arquivo individual (ContentVersion) |
| Arquivos - Metadados do Documento |
Recuperar informações sobre um arquivo (ContentDocument) |
| Arquivos - Obter versão |
Recuperar uma versão de arquivo individual (ContentVersion) |
| Arquivos - Versões do Documento |
Recuperar uma lista de informações de versão para um arquivo individual (ContentDocument) |
| Ações - Descreva a ação rápida |
Recuperar todas as propriedades de uma Ação Rápida |
| Ações - Executar Ação Rápida |
Execute uma Ação Rápida com os dados necessários |
| Ações - Recuperar ações rápidas |
Recuperar uma lista de todas as Ações Rápidas em uma organização |
| Consultas - Consulta de pesquisa |
Executar uma consulta de pesquisa (SOSL) |
| Consultas - Consulta SOQL |
Executar uma consulta SOQL |
| Consultas - GraphQL Query |
Executar uma consulta QL do Graph para recuperar objetos e registrar dados |
| Empregos - Abortar Trabalho |
Abortar um trabalho |
| Empregos - Excluir trabalho |
Eliminar um trabalho |
| Empregos - Obter status de trabalho em massa |
Verificar o estado de um trabalho |
| Empregos - Obter Todos os Empregos |
Obter informações sobre todas as vagas |
| Feeds - Criar item de feed |
Criar um novo item de feed associado a um registro |
| Feeds - Obter feed de registros |
Recuperar o feed de registros do Chatter |
| Leads - Converta um lead |
Converter um lead |
| Objetos - Campos atualizáveis de objetos |
Recuperar os campos atualizáveis de um sObject |
| Objetos - Campos de objeto |
Recuperar os campos de um sObject |
| Objetos - Descrever objeto |
Recuperar todos os metadados e campos de um sObject |
|
Objetos - Listar s |
Recuperar uma lista de todos os sObjects em uma organização |
| Objetos - Metadados de objetos |
Recuperar os metadados de um sObject |
| Organização - Listar versões da API |
Obter uma lista de todas as versões de API suportadas em uma organização |
| Organização - Versão mais recente da API |
Obtenha a versão mais recente da API suportada para uma organização |
| Registos - Atualizar Registo |
Atualizar um registro do tipo de objeto especificado |
| Registos - Criar Registo |
Criar um novo registro do tipo de objeto especificado |
| Registos - Ficheiros Ligados |
Recuperar informações sobre todos os arquivos vinculados a um registro |
| Registos - Obter Registo |
Recuperar um registro do tipo de objeto especificado |
| Registros - Excluir registro |
Excluir um registro do tipo de objeto especificado |
| Trabalhos - Criar trabalho de consulta em massa |
Criar um trabalho de consulta em massa |
| Trabalhos - Criar trabalho de inserção em massa |
Criar um trabalho de inserção em massa |
| Trabalhos - Obter Resultado de Trabalho em Massa |
Obter informações sobre resultados de trabalhos em massa |
Arquivos - Compartilhar documento
Associar um arquivo (ContentDocument) a um registro e definir as propriedades de compartilhamento
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do documento
|
documentId | True | string |
ID do arquivo (objeto ContentDocument) |
|
ID do Registo
|
recordId | True | string |
ID do registo ao qual o ficheiro será associado |
|
Visibilidade
|
visibility | True | string |
Usuários que podem acessar o arquivo |
|
Permissions
|
permissions | True | string |
Permissões de compartilhamento (Visualizador [Somente visualização], Colaborador [Exibir/Editar/Compartilhar], Inferido do registro relacionado) |
Devoluções
- response
- object
Arquivos - Criar link público
Criar um link de arquivo público que usuários não autenticados possam acessar
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID da versão
|
versionId | True | string |
ID da versão do conteúdo do arquivo |
|
Nome do arquivo
|
name | True | string |
Nome do ficheiro |
|
Ver no navegador
|
viewInBrowser | boolean |
Criar link de visualização para visualização no navegador |
|
|
Permitir Download
|
allowDownload | boolean |
Criar link de download para recuperar o conteúdo do arquivo |
|
|
Palavra-passe
|
password | boolean |
Palavra-passe |
|
|
Expiração
|
expiration | string |
Data de validade (opcional) |
Devoluções
- Body
- outputPublicLink
Arquivos - Criar Versão
Carregar um arquivo como um novo objeto ContentVersion
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome
|
name | string |
Nome do ficheiro (incluindo extensão) |
|
|
Title
|
title | string |
Título do ficheiro |
|
|
ID do documento
|
documentId | string |
(Opcional) ID do objeto ContentDocument (usado somente ao anexar uma nova versão a um arquivo existente) |
|
|
Motivo da mudança
|
reasonForChange | string |
(Opcional) Descrição da alteração |
|
|
Ficheiro
|
file | file |
Dados de arquivo binário |
Devoluções
- response
- object
Arquivos - Informações de versão
Recuperar informações sobre uma versão de arquivo individual (ContentVersion)
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID da versão
|
versionId | True | string |
ID da versão do conteúdo do arquivo a ser recuperada |
Devoluções
- response
- object
Arquivos - Metadados do Documento
Recuperar informações sobre um arquivo (ContentDocument)
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do documento
|
documentId | True | string |
ID do documento de conteúdo do arquivo a ser recuperado |
Devoluções
- response
- object
Arquivos - Obter versão
Recuperar uma versão de arquivo individual (ContentVersion)
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID da versão
|
versionId | True | string |
ID da versão do ficheiro a recuperar |
Devoluções
- response
- object
Arquivos - Versões do Documento
Recuperar uma lista de informações de versão para um arquivo individual (ContentDocument)
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID da versão
|
documentId | True | string |
ID do objeto de documento de conteúdo que contém as versões a serem recuperadas |
Devoluções
- response
- object
Ações - Descreva a ação rápida
Recuperar todas as propriedades de uma Ação Rápida
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome
|
name | True | string |
Nome do objeto ou item |
Devoluções
- Body
- outputStringResult
Ações - Executar Ação Rápida
Execute uma Ação Rápida com os dados necessários
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome
|
name | True | string |
Nome da ação rápida |
|
Data
|
data | True | object |
Dados de ação rápida |
Devoluções
- Body
- outputStringResult
Ações - Recuperar ações rápidas
Consultas - Consulta de pesquisa
Executar uma consulta de pesquisa (SOSL)
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome
|
query | True | string |
Pesquisar texto da consulta (não codificado) |
Devoluções
- response
- object
Consultas - Consulta SOQL
Executar uma consulta SOQL
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
consulta
|
query | True | string |
Texto da consulta SOQL (não codificado) |
Devoluções
- response
- object
Consultas - GraphQL Query
Executar uma consulta QL do Graph para recuperar objetos e registrar dados
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Query
|
query | True | string |
Texto da consulta GraphQL |
Devoluções
- response
- object
Empregos - Abortar Trabalho
Abortar um trabalho
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID
|
id | True | string |
ID do objeto |
|
Tipo
|
type | True | string |
Tipo de objeto |
Devoluções
- Body
- outputStringResult
Empregos - Excluir trabalho
Eliminar um trabalho
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID
|
id | True | string |
ID do objeto |
|
Tipo
|
type | True | string |
Tipo de objeto |
Devoluções
- Body
- outputStringResult
Empregos - Obter status de trabalho em massa
Verificar o estado de um trabalho
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID
|
id | True | string |
ID do objeto |
|
Tipo
|
type | True | string |
Tipo de objeto |
Devoluções
- Body
- outputStringResult
Empregos - Obter Todos os Empregos
Feeds - Criar item de feed
Criar um novo item de feed associado a um registro
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Conteúdo do feed
|
body | True | string |
Conteúdo do item de feed. Aceita valores de texto sem formatação ou um objeto JSON 'messageSegments' para tipos de postagem mais complexos (consulte https://bit.ly/4706k0M). |
|
ID do Registo
|
recordId | True | string |
ID de registo associado |
Devoluções
- response
- object
Feeds - Obter feed de registros
Recuperar o feed de registros do Chatter
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do Registo
|
recordId | True | string |
ID do registo |
Devoluções
- response
- object
Leads - Converta um lead
Converter um lead
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Lead ID
|
leadId | True | string |
Identificador do lead |
|
Criar Oportunidade
|
createOpportunity | boolean |
Crie um registro de oportunidade após a conversão. A predefinição é verdadeira. |
|
|
Nome da oportunidade
|
opportunityName | string |
Define o nome da oportunidade de criação. Se nenhum nome for especificado, esse valor será padronizado para o nome da empresa do lead. |
|
|
Substituir fonte de lead
|
overwriteLeadSource | boolean |
Substitua o campo LeadSource no objeto de contato de destino pelo conteúdo do campo LeadSource no objeto de lead de origem. O valor padrão é falso. |
|
|
Enviar e-mail de notificação
|
sendNotificationEmail | boolean |
Envie um e-mail de notificação para o proprietário. O valor padrão é falso. |
|
|
Mesclar com ID de conta
|
mergeAccountId | string |
ID da conta na qual o lead é mesclado. Use somente ao atualizar uma conta existente. |
|
|
Mesclar com ID de contato
|
mergeContactId | string |
ID do contato no qual o lead será mesclado (já deve estar associado à conta especificada em mergeAccountId). Use somente ao atualizar um contato existente. |
|
|
Mesclar com ID de oportunidade
|
mergeOpportunityId | string |
ID da oportunidade na qual o lead é mesclado. Use somente ao atualizar uma oportunidade existente. |
|
|
ID do Proprietário
|
ownerId | string |
ID da pessoa que possui qualquer conta, contato ou oportunidade recém-criada. Se estiver em branco, será utilizado o valor do proprietário principal. |
Devoluções
- response
- object
Objetos - Campos atualizáveis de objetos
Recuperar os campos atualizáveis de um sObject
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome do objeto
|
name | True | string |
Nome do sObject |
Devoluções
- Body
- outputStringResult
Objetos - Campos de objeto
Recuperar os campos de um sObject
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome do objeto
|
name | True | string |
Nome do sObject |
Devoluções
- Body
- outputStringResult
Objetos - Descrever objeto
Recuperar todos os metadados e campos de um sObject
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Selecionar nome do objeto
|
name | True | string |
Nome do sObject |
Devoluções
- Body
- outputStringResult
Objetos - Listar sObjects
Objetos - Metadados de objetos
Recuperar os metadados de um sObject
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome do objeto
|
name | True | string |
Nome do sObject |
Devoluções
- Body
- outputStringResult
Organização - Listar versões da API
Obter uma lista de todas as versões de API suportadas em uma organização
Devoluções
- Body
- outputVersionList
Organização - Versão mais recente da API
Obtenha a versão mais recente da API suportada para uma organização
Devoluções
- Body
- outputStringResult
Registos - Atualizar Registo
Atualizar um registro do tipo de objeto especificado
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Selecionar nome do objeto
|
name | True | string |
Tipo de objeto que será atualizado |
|
ID do Registo
|
recordId | True | string |
ID do registo a atualizar |
|
body
|
body | True | dynamic |
Entrada de atualização de registro |
Devoluções
- response
- object
Registos - Criar Registo
Criar um novo registro do tipo de objeto especificado
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Selecionar nome do objeto
|
name | True | string |
Tipo de objeto que será criado |
|
body
|
body | True | dynamic |
Entrada de criação de registros |
Devoluções
- response
- object
Registos - Ficheiros Ligados
Recuperar informações sobre todos os arquivos vinculados a um registro
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do Registo
|
recordId | True | string |
ID do Registo |
|
Tipos de link
|
linkTypes | True | string |
Tipo de ficheiros ligados a incluir |
Devoluções
- response
- object
Registos - Obter Registo
Recuperar um registro do tipo de objeto especificado
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Selecionar nome do objeto
|
name | True | string |
Tipo de objeto que será recuperado |
|
ID do Registo
|
recordId | True | string |
ID do registo a recuperar |
Devoluções
- response
- object
Registros - Excluir registro
Excluir um registro do tipo de objeto especificado
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Selecionar nome do objeto
|
name | True | string |
Tipo de objeto que será excluído |
|
ID do Registo
|
recordId | True | string |
ID do registo a eliminar |
Devoluções
- response
- object
Trabalhos - Criar trabalho de consulta em massa
Criar um trabalho de consulta em massa
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Operação de consulta
|
operation | string |
Tipo de operação de consulta |
|
|
Delimitador de Coluna
|
delimiter | string |
Delimitador de coluna no arquivo de saída |
|
|
Fim de linha
|
lineEnding | string |
Terminador de linha do arquivo de saída. LF para Unix/Linux/Mac OS, CRLF para Windows |
|
|
Query
|
query | string |
Consulta SOQL de conjunto de resultados grande (não codificada) |
Devoluções
- response
- object
Trabalhos - Criar trabalho de inserção em massa
Criar um trabalho de inserção em massa
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome do objeto
|
objectName | string |
Nome do tipo sObject (por exemplo, Opportunity) |
|
|
Formato de arquivo
|
fileFormat | string |
Formato de arquivo (apenas CSV suportado atualmente) |
|
|
Fim de linha
|
lineEnding | string |
Terminador de linha do arquivo de entrada. LF para Unix/Linus/Mac OS, CRLF para Windows |
|
|
Ficheiro
|
file | file |
Dados de ficheiros binários (limite de 25MB) |
Devoluções
- response
- object
Trabalhos - Obter Resultado de Trabalho em Massa
Obter informações sobre resultados de trabalhos em massa
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do trabalho
|
jobId | string |
ID do trabalho |
|
|
Tipo de trabalho
|
jobType | string |
Tipo de emprego |
|
|
Tipo de resultado
|
resultType | string |
Tipo de conjunto de resultados a recuperar |
|
|
Localizador
|
locator | string |
Localizador de registos |
|
|
Max Recordes
|
maxRecords | string |
Número máximo de registos a devolver |
Devoluções
- response
- object
Definições
outputActionList
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Results
|
results | array of object |
Results |
|
items
|
results | object |
outputPublicLink
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do objeto
|
objectId | string |
ID do objeto de distribuição de conteúdo |
|
Sucesso
|
success | boolean |
Indica o sucesso ou falha da operação |
|
Palavra-passe
|
password | string |
Valor da senha gerada automaticamente |
|
Endereço URL
|
url | string |
URL pública |
outputStringResult
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Resultado
|
result | string |
Resposta em texto |
outputVersionList
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Results
|
results | array of object |
Results |
|
items
|
results | object |
objecto
Este é o tipo 'objeto'.