CloudTools for Salesforce (versão prévia)
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.
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) – 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: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – 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) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Suporte do Apptigent |
| URL | https://www.apptigent.com/help |
| support@apptigent.com |
| Metadados do conector | |
|---|---|
| Publicador | Apptigent |
| Site | https://www.apptigent.com |
| Política de privacidade | https://www.apptigent.com/help/privacy-policy/ |
| Categorias | Produtividade |
Automatize processos comerciais críticos com integração direta entre plataformas de nuvem para o Salesforce. Conecte facilmente o Power Apps e o Power Automate à sua organização Salesforce para recuperar informações do cliente, fechar negócios, criar registros, converter clientes potenciais, 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 e seaches avançadas usando SOQL, SOSL e GraphQL. O CloudTools desbloqueia o potencial dos dados de CRM corporativos, tornando-os facilmente acessíveis 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 cloudTools em uma organização salesforce (qualquer edição) e uma assinatura atual do CloudTools (cobrada separadamente). Para obter instruções passo a passo sobre como começar a visitar https://www.apptigent.com/solutions/cloudtools/configuration.
Como obter credenciais
Gere uma chave de API (licença) 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 Inicializador 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 no Power Apps, no Power Automate ou nos Aplicativos Lógicos do Azure.
Problemas e limitações conhecidos
Instalar e configurar o CloudTools para 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.
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | 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.
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 |
|---|---|---|---|
| Chave de licença | secureString | A chave de licença do CloudTools | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à 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 os usuários não autenticados podem 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 – Descrever a ação rápida |
Recuperar todas as propriedades de uma Ação Rápida |
| Ações – Executar ação rápida |
Executar 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 SOSL (pesquisa) |
| Consultas – Consulta GraphQL |
Executar uma consulta QL do Graph para recuperar dados de objeto e registro |
| Consultas – Consulta SOQL |
Executar uma consulta SOQL |
| Feeds – Criar Item do Feed |
Criar um novo item de feed associado a um registro |
| Feeds – Obter Feed de Registro |
Recuperar o feed de registro do Chatter |
| Leads – Converter um lead |
Converter um lead |
| Objetos – Campos atualizáveis do objeto |
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 objeto |
Recuperar os metadados de um sObject |
| Organização – Listar versões da API |
Obter uma lista de todas as versões de API com suporte em uma organização |
| Organização – Versão mais recente da API |
Obter a versão mais recente da API com suporte para uma organização |
| Registros – Arquivos Vinculados |
Recuperar informações sobre todos os arquivos vinculados a um registro |
| Registros – Atualizar Registro |
Atualizar um registro do tipo de objeto especificado |
| Registros – Criar Registro |
Criar um novo registro do tipo de objeto especificado |
| Registros – Excluir Registro |
Excluir um registro do tipo de objeto especificado |
| Registros – Obter Registro |
Recuperar um registro do tipo de objeto especificado |
| Trabalhos – Anular Trabalho |
Anular um trabalho |
| 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 – Excluir Trabalho |
Excluir um trabalho |
| Trabalhos – Obter resultado do trabalho em massa |
Obter informações de resultado do trabalho em massa |
| Trabalhos – Obter status do trabalho em massa |
Verificar o status de um trabalho |
| Trabalhos – Obter todos os trabalhos |
Obter informações sobre todos os trabalhos |
Arquivos – Compartilhar Documento
Associar um arquivo (ContentDocument) a um registro e definir as propriedades de compartilhamento
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do documento
|
documentId | True | string |
ID do arquivo (objeto ContentDocument) |
|
ID do Registro
|
recordId | True | string |
ID do registro ao qual o arquivo será associado |
|
Visibilidade
|
visibility | True | string |
Usuários que podem acessar o arquivo |
|
Permissions
|
permissions | True | string |
Permissões de compartilhamento (Visualizador [Somente Exibição], Colaborador [Exibição/Edição/Compartilhamento], Inferido do registro relacionado) |
Retornos
- response
- object
Arquivos – Criar link público
Criar um link de arquivo público que os usuários não autenticados podem acessar
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da versão
|
versionId | True | string |
ID da versão de conteúdo do arquivo |
|
Nome do Arquivo
|
name | True | string |
Nome do arquivo |
|
Exibir no navegador
|
viewInBrowser | boolean |
Criar link de visualização para exibição no navegador |
|
|
Permitir Download
|
allowDownload | boolean |
Criar link de download para recuperar o conteúdo do arquivo |
|
|
Senha
|
password | boolean |
Senha |
|
|
Vencimento
|
expiration | string |
Data de validade (opcional) |
Retornos
- Corpo
- outputPublicLink
Arquivos – Criar versão
Carregar um arquivo como um novo objeto ContentVersion
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome
|
name | string |
Nome do arquivo (incluindo extensão) |
|
|
Title
|
title | string |
Título do arquivo |
|
|
ID do documento
|
documentId | string |
(Opcional) ID do objeto ContentDocument (usado somente ao acrescentar uma nova versão a um arquivo existente) |
|
|
Motivo da alteração
|
reasonForChange | string |
(Opcional) Descrição da alteração |
|
|
File
|
file | file |
Dados de arquivo binário |
Retornos
- response
- object
Arquivos – Informações de versão
Recuperar informações sobre uma versão de arquivo individual (ContentVersion)
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da versão
|
versionId | True | string |
ID da versão do conteúdo do arquivo a ser recuperada |
Retornos
- response
- object
Arquivos – Metadados do documento
Recuperar informações sobre um arquivo (ContentDocument)
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do documento
|
documentId | True | string |
ID do documento de conteúdo do arquivo a ser recuperado |
Retornos
- response
- object
Arquivos – Obter versão
Recuperar uma versão de arquivo individual (ContentVersion)
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da versão
|
versionId | True | string |
ID da versão do arquivo a ser recuperada |
Retornos
- response
- object
Arquivos – Versões do documento
Recuperar uma lista de informações de versão para um arquivo individual (ContentDocument)
Parâmetros
| Nome | Chave | Obrigató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 |
Retornos
- response
- object
Ações – Descrever a ação rápida
Recuperar todas as propriedades de uma Ação Rápida
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome
|
name | True | string |
Nome do objeto ou item |
Retornos
- Corpo
- outputStringResult
Ações – Executar ação rápida
Executar uma ação rápida com os dados necessários
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome
|
name | True | string |
Nome da ação rápida |
|
Dados
|
data | True | object |
Dados de Ação Rápida |
Retornos
- Corpo
- outputStringResult
Ações – Recuperar Ações Rápidas
Consultas – Consulta de pesquisa
Executar uma consulta SOSL (pesquisa)
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome
|
query | True | string |
Pesquisar texto de consulta (não codificado) |
Retornos
- response
- object
Consultas – Consulta GraphQL
Executar uma consulta QL do Graph para recuperar dados de objeto e registro
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Query
|
query | True | string |
Texto da consulta GraphQL |
Retornos
- response
- object
Consultas – Consulta SOQL
Executar uma consulta SOQL
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
consulta
|
query | True | string |
Texto da consulta SOQL (não codificado) |
Retornos
- response
- object
Feeds – Criar Item do Feed
Criar um novo item de feed associado a um registro
Parâmetros
| Nome | Chave | Obrigató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 Registro
|
recordId | True | string |
ID do registro associado |
Retornos
- response
- object
Feeds – Obter Feed de Registro
Recuperar o feed de registro do Chatter
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do Registro
|
recordId | True | string |
ID do registro |
Retornos
- response
- object
Leads – Converter um lead
Converter um lead
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do cliente potencial
|
leadId | True | string |
Identificador de chumbo |
|
Criar oportunidade
|
createOpportunity | boolean |
Crie um registro de oportunidade após a conversão. O padrão é true. |
|
|
Nome da Oportunidade
|
opportunityName | string |
Define o nome da oportunidade a ser criada. Se nenhum nome for especificado, esse valor usará como padrão o nome da empresa do cliente potencial. |
|
|
Substituir origem do cliente potencial
|
overwriteLeadSource | boolean |
Substitua o campo LeadSource no objeto de contato de destino com o conteúdo do campo LeadSource no objeto de chumbo de origem. O padrão é false. |
|
|
Enviar email de notificação
|
sendNotificationEmail | boolean |
Envie um email de notificação para o proprietário. O padrão é false. |
|
|
Mesclar com a ID da Conta
|
mergeAccountId | string |
ID da conta na qual o cliente potencial é mesclado. Use somente ao atualizar uma conta existente. |
|
|
Mesclar com a ID de Contato
|
mergeContactId | string |
ID do contato no qual o cliente potencial será mesclado (já deve estar associado à conta especificada em mergeAccountId). Use somente ao atualizar um contato existente. |
|
|
Mesclar com a ID de Oportunidade
|
mergeOpportunityId | string |
ID da oportunidade na qual o cliente potencial é 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, o valor do proprietário do cliente potencial será usado. |
Retornos
- response
- object
Objetos – Campos atualizáveis do objeto
Recuperar os campos atualizáveis de um sObject
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do objeto
|
name | True | string |
Nome do sObject |
Retornos
- Corpo
- outputStringResult
Objetos – Campos de Objeto
Recuperar os campos de um sObject
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do objeto
|
name | True | string |
Nome do sObject |
Retornos
- Corpo
- outputStringResult
Objetos – Descrever objeto
Recuperar todos os metadados e campos de um sObject
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Selecionar Nome do Objeto
|
name | True | string |
Nome do sObject |
Retornos
- Corpo
- outputStringResult
Objetos – Listar sObjects
Objetos – Metadados de objeto
Recuperar os metadados de um sObject
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do objeto
|
name | True | string |
Nome do sObject |
Retornos
- Corpo
- outputStringResult
Organização – Listar versões da API
Obter uma lista de todas as versões de API com suporte em uma organização
Retornos
- Corpo
- outputVersionList
Organização – Versão mais recente da API
Obter a versão mais recente da API com suporte para uma organização
Retornos
- Corpo
- outputStringResult
Registros – Arquivos Vinculados
Recuperar informações sobre todos os arquivos vinculados a um registro
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do Registro
|
recordId | True | string |
ID do Registro |
|
Tipos de link
|
linkTypes | True | string |
Tipo de arquivos vinculados a serem incluídos |
Retornos
- response
- object
Registros – Atualizar Registro
Atualizar um registro do tipo de objeto especificado
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Selecionar Nome do Objeto
|
name | True | string |
Tipo de objeto que será atualizado |
|
ID do Registro
|
recordId | True | string |
ID do registro a ser atualizado |
|
body
|
body | True | dynamic |
Entrada de atualização de registro |
Retornos
- response
- object
Registros – Criar Registro
Criar um novo registro do tipo de objeto especificado
Parâmetros
| Nome | Chave | Obrigató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 registro |
Retornos
- response
- object
Registros – Excluir Registro
Excluir um registro do tipo de objeto especificado
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Selecionar Nome do Objeto
|
name | True | string |
Tipo de objeto que será excluído |
|
ID do Registro
|
recordId | True | string |
ID do registro a ser excluído |
Retornos
- response
- object
Registros – Obter Registro
Recuperar um registro do tipo de objeto especificado
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Selecionar Nome do Objeto
|
name | True | string |
Tipo de objeto que será recuperado |
|
ID do Registro
|
recordId | True | string |
ID do registro a ser recuperado |
Retornos
- response
- object
Trabalhos – Anular Trabalho
Anular um trabalho
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID
|
id | True | string |
ID do objeto |
|
Tipo
|
type | True | string |
Tipo de objeto |
Retornos
- Corpo
- outputStringResult
Trabalhos – Criar trabalho de consulta em massa
Criar um trabalho de consulta em massa
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Operação de consulta
|
operation | string |
Tipo de operação de consulta |
|
|
Delimitador de Colunas
|
delimiter | string |
Delimitador de coluna no arquivo de saída |
|
|
Final da 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 do conjunto de resultados grande (não codificada) |
Retornos
- response
- object
Trabalhos – Criar trabalho de inserção em massa
Criar um trabalho de inserção em massa
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do objeto
|
objectName | string |
Nome do tipo sObject (por exemplo, Oportunidade) |
|
|
Formato de Arquivo
|
fileFormat | string |
Formato de arquivo (somente CSV com suporte atualmente) |
|
|
Final da linha
|
lineEnding | string |
Terminador de linha do arquivo de entrada. LF para Unix/Linus/Mac OS, CRLF para Windows |
|
|
File
|
file | file |
Dados de arquivo binário (limite de 25 MB) |
Retornos
- response
- object
Trabalhos – Excluir Trabalho
Excluir um trabalho
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID
|
id | True | string |
ID do objeto |
|
Tipo
|
type | True | string |
Tipo de objeto |
Retornos
- Corpo
- outputStringResult
Trabalhos – Obter resultado do trabalho em massa
Obter informações de resultado do trabalho em massa
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do trabalho
|
jobId | string |
ID do trabalho |
|
|
Tipo de Trabalho
|
jobType | string |
Tipo de trabalho |
|
|
Tipo de resultado
|
resultType | string |
Tipo de conjunto de resultados a ser recuperado |
|
|
Localizador
|
locator | string |
Localizador de registros |
|
|
Registros máximos
|
maxRecords | string |
Número máximo de registros a serem retornados |
Retornos
- response
- object
Trabalhos – Obter status do trabalho em massa
Verificar o status de um trabalho
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID
|
id | True | string |
ID do objeto |
|
Tipo
|
type | True | string |
Tipo de objeto |
Retornos
- Corpo
- outputStringResult
Trabalhos – Obter todos os trabalhos
Definições
outputActionList
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Results
|
results | array of object |
Results |
|
items
|
results | object |
outputPublicLink
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do objeto
|
objectId | string |
ID do objeto de distribuição de conteúdo |
|
Êxito
|
success | boolean |
Indica êxito ou falha da operação |
|
Senha
|
password | string |
Valor da senha gerada automaticamente |
|
URL
|
url | string |
URL pública |
outputStringResult
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
resultado
|
result | string |
Resposta de texto |
outputVersionList
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Results
|
results | array of object |
Results |
|
items
|
results | object |
objeto
Esse é o tipo 'object'.