CloudTools for Salesforce (versión preliminar)
Apptigent CloudTools proporciona una variedad de acciones de integración de datos para Salesforce a las que puede acceder cualquier aplicación o flujo de trabajo conectado a la nube.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Compatibilidad con Apptigent |
| URL | https://www.apptigent.com/help |
| Correo Electrónico | support@apptigent.com |
| Metadatos del conector | |
|---|---|
| Publicador | Apptigent |
| Sitio web | https://www.apptigent.com |
| Directiva de privacidad | https://www.apptigent.com/help/privacy-policy/ |
| Categorías | Productividad |
Automatice los procesos empresariales críticos con la integración sin problemas en la nube multiplataforma para Salesforce. Conecte fácilmente Power Apps y Power Automate con su organización de Salesforce para recuperar información del cliente, cerrar ofertas, crear registros, convertir clientes potenciales, ejecutar trabajos masivos, ejecutar acciones rápidas, cargar archivos, asociar documentos con registros, fuentes de actualización, recuperar archivos vinculados y mucho más. Incluso puede ejecutar consultas avanzadas y seaches mediante SOQL, SOSL y GraphQL. CloudTools desbloquea el potencial de los datos de CRM empresariales haciendo que sea fácilmente accesible desde cualquier aplicación o flujo de trabajo.
Prerrequisitos
CloudTools requiere una licencia de Salesforce válida, la instalación del paquete administrado de CloudTools en una organización de Salesforce (cualquier edición) y una suscripción actual de CloudTools (facturada por separado). Para obtener instrucciones paso a paso sobre cómo empezar a visitar https://www.apptigent.com/solutions/cloudtools/configuration.
Obtención de credenciales
Genere una clave de licencia (API) siguiendo estos sencillos pasos:
- Instale el paquete administrado de CloudTools a través de Salesforce App Exchange.
- Inicie la página de configuración de CloudTools seleccionando el vínculo "Apptigent CloudTools" en el iniciador de aplicaciones.
- Siga las instrucciones en pantalla para crear una aplicación conectada y generar una clave de licencia.
- Copie la clave y proporciónela en el cuadro de diálogo de conexión nueva en Power Apps, Power Automate o Azure Logic Apps.
Problemas y limitaciones conocidos
La instalación y configuración de CloudTools para Salesforce Sales Cloud requiere permisos de administrador del sistema en Salesforce. Póngase en contacto con el administrador de Salesforce para obtener ayuda si no tiene permisos suficientes en su organización.
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| Clave de licencia | securestring | La clave de licencia de CloudTools | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Acciones: Describir acción rápida |
Recuperar todas las propiedades de una acción rápida |
| Acciones: Ejecutar acción rápida |
Ejecución de una acción rápida con los datos necesarios |
| Acciones: recuperación de acciones rápidas |
Recuperar una lista de todas las acciones rápidas de una organización |
| Archivos: compartir documento |
Asociar un archivo (ContentDocument) a un registro y establecer las propiedades de uso compartido |
| Archivos: creación de un vínculo público |
Creación de un vínculo de archivo público al que los usuarios no autenticados pueden acceder |
| Archivos: crear versión |
Cargar un archivo como un nuevo objeto ContentVersion |
| Archivos: información de versión |
Recuperar información sobre una versión de archivo individual (ContentVersion) |
| Archivos: metadatos del documento |
Recuperar información sobre un archivo (ContentDocument) |
| Archivos: obtener versión |
Recuperar una versión de archivo individual (ContentVersion) |
| Archivos: versiones de documentos |
Recuperar una lista de información de versión para un archivo individual (ContentDocument) |
| Clientes potenciales: convertir un cliente potencial |
Conversión de un cliente potencial |
| Consultas: consulta de búsqueda |
Ejecución de una consulta de búsqueda (SOSL) |
| Consultas: consulta de GraphQL |
Ejecución de una consulta de QL de Graph para recuperar datos de objetos y registros |
| Consultas: consulta SOQL |
Ejecución de una consulta SOQL |
| Fuentes: crear elemento de fuente |
Crear un nuevo elemento de fuente asociado a un registro |
| Fuentes: obtener fuente de registros |
Recuperación de la fuente de registros de Chatter |
| Objetos: campos actualizables de objetos |
Recuperar los campos actualizables de un objeto sObject |
| Objetos: campos de objeto |
Recuperar los campos de un objeto sObject |
| Objetos: Describir objeto |
Recuperar todos los metadatos y campos de un sObject |
|
Objetos: enumerar s |
Recuperar una lista de todos los objetos sObject de una organización |
| Objetos: metadatos de objeto |
Recuperar los metadatos de un objeto sObject |
| Organización: enumeración de versiones de API |
Obtener una lista de todas las versiones de API admitidas en una organización |
| Organización: versión más reciente de la API |
Obtención de la versión de API compatible más reciente para una organización |
| Registros: actualizar registro |
Actualizar un registro del tipo de objeto especificado |
| Registros: archivos vinculados |
Recuperar información sobre todos los archivos vinculados a un registro |
| Registros: Crear registro |
Crear un nuevo registro del tipo de objeto especificado |
| Registros: eliminar registro |
Eliminar un registro del tipo de objeto especificado |
| Registros: Obtener registro |
Recuperar un registro del tipo de objeto especificado |
| Trabajos: anular trabajo |
Anulación de un trabajo |
| Trabajos: creación de un trabajo de consulta masiva |
Creación de un trabajo de consulta masiva |
| Trabajos: creación de un trabajo de inserción masiva |
Creación de un trabajo de inserción masiva |
| Trabajos: eliminar trabajo |
Eliminación de un trabajo |
| Trabajos: obtener el resultado del trabajo masivo |
Obtención de información de resultados de trabajos masivos |
| Trabajos: obtener estado de trabajo masivo |
Comprobación del estado de un trabajo |
| Trabajos: obtener todos los trabajos |
Obtener información sobre todos los trabajos |
Acciones: Describir acción rápida
Recuperar todas las propiedades de una acción rápida
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre
|
name | True | string |
Nombre de objeto o elemento |
Devoluciones
- Body
- outputStringResult
Acciones: Ejecutar acción rápida
Ejecución de una acción rápida con los datos necesarios
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre
|
name | True | string |
Nombre de acción rápida |
|
Data
|
data | True | object |
Datos de acción rápida |
Devoluciones
- Body
- outputStringResult
Acciones: recuperación de acciones rápidas
Recuperar una lista de todas las acciones rápidas de una organización
Devoluciones
- Body
- outputActionList
Archivos: compartir documento
Asociar un archivo (ContentDocument) a un registro y establecer las propiedades de uso compartido
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de documento
|
documentId | True | string |
Identificador del archivo (objeto ContentDocument) |
|
Identificador de registro
|
recordId | True | string |
Identificador del registro al que se asociará el archivo |
|
Visibilidad
|
visibility | True | string |
Usuarios que pueden acceder al archivo |
|
Permissions
|
permissions | True | string |
Permisos de uso compartido (Visor [Solo vista], Colaborador [Ver/Editar/Compartir], Inferido del registro relacionado) |
Devoluciones
- response
- object
Archivos: creación de un vínculo público
Creación de un vínculo de archivo público al que los usuarios no autenticados pueden acceder
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de la versión
|
versionId | True | string |
Id. de versión de contenido del archivo |
|
Nombre de archivo
|
name | True | string |
Nombre del archivo |
|
Ver en el explorador
|
viewInBrowser | boolean |
Creación de un vínculo de vista previa para verlo en el explorador |
|
|
Permitir descarga
|
allowDownload | boolean |
Creación de un vínculo de descarga para recuperar el contenido del archivo |
|
|
Contraseña
|
password | boolean |
Contraseña |
|
|
Expiration
|
expiration | string |
Fecha de expiración (opcional) |
Devoluciones
- Body
- outputPublicLink
Archivos: crear versión
Cargar un archivo como un nuevo objeto ContentVersion
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre
|
name | string |
Nombre del archivo (incluida la extensión) |
|
|
Title
|
title | string |
Título del archivo |
|
|
Id. de documento
|
documentId | string |
(Opcional) Id. del objeto ContentDocument (solo se usa al anexar una nueva versión a un archivo existente) |
|
|
Motivo del cambio
|
reasonForChange | string |
(Opcional) Descripción del cambio |
|
|
Archivo
|
file | file |
Datos de archivos binarios |
Devoluciones
- response
- object
Archivos: información de versión
Recuperar información sobre una versión de archivo individual (ContentVersion)
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de la versión
|
versionId | True | string |
Identificador de la versión de contenido del archivo que se va a recuperar |
Devoluciones
- response
- object
Archivos: metadatos del documento
Recuperar información sobre un archivo (ContentDocument)
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de documento
|
documentId | True | string |
Identificador del documento de contenido de archivo que se va a recuperar |
Devoluciones
- response
- object
Archivos: obtener versión
Recuperar una versión de archivo individual (ContentVersion)
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de la versión
|
versionId | True | string |
Identificador de la versión de archivo que se va a recuperar |
Devoluciones
- response
- object
Archivos: versiones de documentos
Recuperar una lista de información de versión para un archivo individual (ContentDocument)
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de la versión
|
documentId | True | string |
Identificador del objeto de documento de contenido que contiene las versiones que se van a recuperar |
Devoluciones
- response
- object
Clientes potenciales: convertir un cliente potencial
Conversión de un cliente potencial
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de cliente potencial
|
leadId | True | string |
Identificador de cliente potencial |
|
Crear oportunidad
|
createOpportunity | boolean |
Cree un registro de oportunidad tras la conversión. El valor predeterminado es true. |
|
|
Nombre de la oportunidad
|
opportunityName | string |
Establece el nombre de la oportunidad de crear. Si no se especifica ningún nombre, este valor tiene como valor predeterminado el nombre de la compañía del cliente potencial. |
|
|
Sobrescribir el origen de cliente potencial
|
overwriteLeadSource | boolean |
Sobrescriba el campo LeadSource en el objeto de contacto de destino con el contenido del campo LeadSource en el objeto de cliente potencial de origen. El valor predeterminado es False. |
|
|
Enviar correo electrónico de notificación
|
sendNotificationEmail | boolean |
Envíe un correo electrónico de notificación al propietario. El valor predeterminado es False. |
|
|
Combinar con el identificador de cuenta
|
mergeAccountId | string |
Identificador de la cuenta en la que se combina el cliente potencial. Use solo al actualizar una cuenta existente. |
|
|
Combinar con el identificador de contacto
|
mergeContactId | string |
Identificador del contacto en el que se combinará el cliente potencial (ya debe estar asociado a la cuenta especificada en mergeAccountId). Use solo al actualizar un contacto existente. |
|
|
Combinar con el identificador de oportunidad
|
mergeOpportunityId | string |
Identificador de la oportunidad en la que se combina el cliente potencial. Use solo al actualizar una oportunidad existente. |
|
|
Id. del propietario
|
ownerId | string |
Identificador de la persona que posee cualquier cuenta, contacto o oportunidad recién creada. Si está en blanco, se usará el valor del propietario del cliente potencial. |
Devoluciones
- response
- object
Consultas: consulta de búsqueda
Ejecución de una consulta de búsqueda (SOSL)
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre
|
query | True | string |
Buscar texto de consulta (sin codificar) |
Devoluciones
- response
- object
Consultas: consulta de GraphQL
Ejecución de una consulta de QL de Graph para recuperar datos de objetos y registros
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Query
|
query | True | string |
Texto de consulta de GraphQL |
Devoluciones
- response
- object
Consultas: consulta SOQL
Ejecución de una consulta SOQL
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
query
|
query | True | string |
Texto de consulta SOQL (sin codificar) |
Devoluciones
- response
- object
Fuentes: crear elemento de fuente
Crear un nuevo elemento de fuente asociado a un registro
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Contenido de fuente
|
body | True | string |
Contenido del elemento de fuente. Acepta valores de texto sin formato o un objeto JSON "messageSegments" para tipos posteriores más complejos (consulte https://bit.ly/4706k0M). |
|
Identificador de registro
|
recordId | True | string |
Id. de registro asociado |
Devoluciones
- response
- object
Fuentes: obtener fuente de registros
Recuperación de la fuente de registros de Chatter
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de registro
|
recordId | True | string |
Identificador del registro |
Devoluciones
- response
- object
Objetos: campos actualizables de objetos
Recuperar los campos actualizables de un objeto sObject
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre del objeto
|
name | True | string |
Nombre del objeto sObject |
Devoluciones
- Body
- outputStringResult
Objetos: campos de objeto
Recuperar los campos de un objeto sObject
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre del objeto
|
name | True | string |
Nombre del objeto sObject |
Devoluciones
- Body
- outputStringResult
Objetos: Describir objeto
Recuperar todos los metadatos y campos de un sObject
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Seleccionar nombre de objeto
|
name | True | string |
Nombre del objeto sObject |
Devoluciones
- Body
- outputStringResult
Objetos: enumerar sObjects
Recuperar una lista de todos los objetos sObject de una organización
Devoluciones
- Body
- outputStringResult
Objetos: metadatos de objeto
Recuperar los metadatos de un objeto sObject
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre del objeto
|
name | True | string |
Nombre del objeto sObject |
Devoluciones
- Body
- outputStringResult
Organización: enumeración de versiones de API
Obtener una lista de todas las versiones de API admitidas en una organización
Devoluciones
- Body
- outputVersionList
Organización: versión más reciente de la API
Obtención de la versión de API compatible más reciente para una organización
Devoluciones
- Body
- outputStringResult
Registros: actualizar registro
Actualizar un registro del tipo de objeto especificado
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Seleccionar nombre de objeto
|
name | True | string |
Tipo de objeto que se actualizará |
|
Identificador de registro
|
recordId | True | string |
Identificador del registro que se va a actualizar |
|
body
|
body | True | dynamic |
Entrada de actualización de registros |
Devoluciones
- response
- object
Registros: archivos vinculados
Recuperar información sobre todos los archivos vinculados a un registro
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de registro
|
recordId | True | string |
Identificador de registro |
|
Tipos de vínculo
|
linkTypes | True | string |
Tipo de archivos vinculados que se van a incluir |
Devoluciones
- response
- object
Registros: Crear registro
Crear un nuevo registro del tipo de objeto especificado
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Seleccionar el nombre del objeto
|
name | True | string |
Tipo de objeto que se creará |
|
body
|
body | True | dynamic |
Entrada de creación de registros |
Devoluciones
- response
- object
Registros: eliminar registro
Eliminar un registro del tipo de objeto especificado
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Seleccionar nombre de objeto
|
name | True | string |
Tipo de objeto que se eliminará |
|
Identificador de registro
|
recordId | True | string |
Identificador del registro que se va a eliminar |
Devoluciones
- response
- object
Registros: Obtener registro
Recuperar un registro del tipo de objeto especificado
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Seleccionar nombre de objeto
|
name | True | string |
Tipo de objeto que se recuperará |
|
Identificador de registro
|
recordId | True | string |
Identificador del registro que se va a recuperar |
Devoluciones
- response
- object
Trabajos: anular trabajo
Anulación de un trabajo
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
identificación
|
id | True | string |
Id. de objeto |
|
Tipo
|
type | True | string |
Tipo de objeto |
Devoluciones
- Body
- outputStringResult
Trabajos: creación de un trabajo de consulta masiva
Creación de un trabajo de consulta masiva
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Operación de consulta
|
operation | string |
Tipo de operación de consulta |
|
|
Delimitador de columna
|
delimiter | string |
Delimitador de columna en el archivo de salida |
|
|
Fin de línea
|
lineEnding | string |
Terminador de línea del archivo de salida. LF para Unix/Linux/Mac OS, CRLF para Windows |
|
|
Query
|
query | string |
Consulta SOQL de conjunto de resultados grande (sin codificar) |
Devoluciones
- response
- object
Trabajos: creación de un trabajo de inserción masiva
Creación de un trabajo de inserción masiva
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre del objeto
|
objectName | string |
Nombre del tipo sObject (por ejemplo, Oportunidad) |
|
|
Formato de archivo
|
fileFormat | string |
Formato de archivo (solo csv admitido actualmente) |
|
|
Fin de línea
|
lineEnding | string |
Terminador de línea del archivo de entrada. LF para Unix/Linus/Mac OS, CRLF para Windows |
|
|
Archivo
|
file | file |
Datos de archivos binarios (límite de 25 MB) |
Devoluciones
- response
- object
Trabajos: eliminar trabajo
Eliminación de un trabajo
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
identificación
|
id | True | string |
Id. de objeto |
|
Tipo
|
type | True | string |
Tipo de objeto |
Devoluciones
- Body
- outputStringResult
Trabajos: obtener el resultado del trabajo masivo
Obtención de información de resultados de trabajos masivos
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. del trabajo
|
jobId | string |
Id. del trabajo |
|
|
Tipo de trabajo
|
jobType | string |
Tipo de trabajo |
|
|
Tipo de resultado
|
resultType | string |
Tipo de conjunto de resultados que se va a recuperar |
|
|
Localizador
|
locator | string |
Localizador de registros |
|
|
Número máximo de registros
|
maxRecords | string |
Número máximo de registros que se van a devolver |
Devoluciones
- response
- object
Trabajos: obtener estado de trabajo masivo
Comprobación del estado de un trabajo
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
identificación
|
id | True | string |
Id. de objeto |
|
Tipo
|
type | True | string |
Tipo de objeto |
Devoluciones
- Body
- outputStringResult
Trabajos: obtener todos los trabajos
Definiciones
outputActionList
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Results
|
results | array of object |
Results |
|
items
|
results | object |
outputPublicLink
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de objeto
|
objectId | string |
Id. de objeto de distribución de contenido |
|
Success
|
success | boolean |
Indica si la operación se ha realizado correctamente o no. |
|
Contraseña
|
password | string |
Valor de contraseña generado automáticamente |
|
URL
|
url | string |
Dirección URL pública |
outputStringResult
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
resultado
|
result | string |
Respuesta de texto |
outputVersionList
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Results
|
results | array of object |
Results |
|
items
|
results | object |
objeto
Este es el tipo 'objeto'.