Conector de Salesforce

::: (info) () Para descargar la aplicación, visite: Biblioteca:::

Introducción

Salesforce es una plataforma de software CRM basada en la nube, que se utiliza en aplicaciones que van desde el seguimiento de prospectos de ventas hasta la gestión de pedidos e inventarios.

Propósito

Este documento detalla el conector REST API de Salesforce que se encuentra en la biblioteca Tulip. Una vez configuradas, estas funciones de conector se pueden utilizar para recuperar, consultar y modificar datos de Salesforce desde una aplicación Tulip.

Documentación de API

La documentación de la API REST de Salesforce se puede encontrar aquí. Tenga en cuenta que algunas funciones de conector incluidas en este artículo realizan consultas utilizando SOQL (Salesforce Object Query Language), cuya sintaxis completa se documenta aquí.

:::(Info) (Variaciones de API) Nota: Salesforce admite una serie de API a través de una variedad de métodos, cuya lista completa puede encontrarse aquí.
Este artículo y los conectores con los que está relacionado están diseñados para utilizar la API REST de Salesforce.
:::

Configuración inicial

:::(Warning) (Advertencia sobre permisos) Advertencia: la generación de los siguientes valores requiere permisos de nivel de desarrollador o administrador en Salesforce. ::: La autenticación de la API de Salesforce sigue los estándares OAuth 2.0. El siguiente proceso describe cómo generar un token de actualización, que luego utilizará cualquier aplicación Tulip App para recuperar el token de acceso necesario para conectarse correctamente a Salesforce.

1. Cree una aplicación conectada en Salesforce. Para ello, vaya al espacio "Configuración" en Salesforce. A continuación, vaya a HERRAMIENTAS DE PLATAFORMA >> Aplicaciones >> Aplicaciones conectadas >> Gestionar aplicaciones conectadas.
2. Cree una nueva aplicación conectada. Incluya
   a. Cualquier ámbito requerido por su aplicación, pero asegúrese de incluir refresh_token. b. Seleccione Activar configuración OAuth e introduzca la URL de devolución de llamada como https://login.salesforce.com/services/oauth2/success.
3. Una vez completado, haga clic en Manage Consumer Details para ver su "Consumer Key" y "Consumer Secret". Se utilizarán más adelante.
4. Ahora en Tulip, abre la función del conector [Setup] Get Auth Code URL. Copia y pega la "Consumer Key" generada en el paso 3 anterior como el parámetro de consulta client_id.
5. "Ejecuta la Connector Function.
6. Observa que se ha generado una URL como "Salida" del Connector. Pegue esta URL en la ventana de su navegador.
7. Complete la solicitud de autenticación que aparece para autorizar a Tulip a interactuar con su instancia de Salesforce.
8. Si se realiza correctamente, su navegador debería redirigirle a una nueva página que diga Autorización de aplicación de acceso remoto. El código de autorización se encuentra en la URL de esta página.
   Por ejemplo, en la URL https://login.salesforce.com/services/oauth2/success?code=asdf1234 el Código de autorización es asdf1234.
9. Guarde este Código de Autorización. Tenga en cuenta que el código debe terminar en dos símbolos de igualdad: ==. Si el código termina en %3D%3D, elimine estos caracteres y sustitúyalos por ==.
10. Vaya a la función [Setup] Get Refresh Token Tulip Connector. En los parámetros de consulta, pegue toda la información que se ha recopilado anteriormente:
    • grant_type= authorization_code
    • redirect_uri= https://login.salesforce.com/services/oauth2/success
    • client_id= la clave del consumidor del paso 3 anterior
    • client_secret= el secreto del consumidor del paso 3 anterior
    • code= el código de autorización del paso 9 anterior
11. Ejecuta este conector y guarda el refresh_token que aparece en la respuesta.
12. Por último, vaya a la función del conector [Auth] Get Access Token. Rellena los siguientes parámetros de consulta:
    • grant_type= authorization_code
    • client_id= la clave de consumidor del paso 3 anterior
    • client_secret= secreto del usuario del paso 3 anterior
    • refresh_token= el código de actualización del paso 10.
13. Ejecuta el conector. Observa que la respuesta incluye un access_token, que se asigna como salida. Guarda el conector para guardar el token de actualización.

Una vez que esta función es capaz de generar un access_token, la configuración está completa. Este access_token puede utilizarse en cualquier otra función del conector durante el tiempo que permitan los ajustes de tiempo de espera configurados en el paso 2.

Detalles de la conexión Tulip

Para permitir que sus conectores interactúen con Salesforce, introduzca el subdominio de su instancia de Salesforce como "Subdominio predeterminado" en los detalles de conexión del conector.
Por ejemplo, si la instancia de Salesforce se encuentra en sample.my.salesforce.com, el subdominio predeterminado debe ser sample.my.

Tenga en cuenta que todas las funciones del conector están diseñadas para funcionar con Salesforce REST API v46.0.

Funciones de conector

Existen dos tipos principales de conectores: conectores de tipo objeto y conectores de tipo consulta.
Tenga en cuenta que ambos conectores requieren un código de acceso, por lo que debe ejecutar [Auth] Get Access Token en su aplicación antes de utilizarlos. Normalmente se recomienda generar un nuevo token de acceso cuando se inicia la aplicación o el proceso, y guardarlo en una variable de la aplicación para su uso posterior.

Conectores de tipo objeto

• Devuelve todos los campos del objeto en cuestión.
• Utilice el punto final ./services/data/v46.0/sobjects/<Object Name>/<Object ID>.
• Ejemplo: Conector [Oportunidad] Obtener todos los campos

Conectores de tipo consulta

• Devuelve sólo los campos especificados en la consulta.
• Puede devolver información vinculada (por ejemplo, el Nombre de cuenta relacionado con una Oportunidad) o agregada (por ejemplo, un recuento de registros).
• Utilice el punto final ./services/data/v46.0/query
• Requiere escribir una consulta utilizando SOQL (documentación here{target=_blank}).
• Ejemplo: Conector [Pedido] Obtener todos los pedidos de estado

Funciones de conector incluidas

Las siguientes funciones de conector se incluyen en este paquete y pretenden servir como introducción a las funciones posibles a través de la API de Salesforce: * [Setup] Get Auth Code URL & [Setup] Get Refresh Token * Se utiliza sólo para la primera configuración. Consulte más arriba para obtener más información.* [Auth] Get Access Token * Se utiliza para generar un token de acceso, que debe incluirse en todas las funciones de conector posteriores.* Funciones [Opportunity]:
* Get All Fields * Devuelve todos los campos de la Oportunidad consultada. Requiere Identificador de Acceso e ID de Oportunidad. * Cambiar Etapa * Actualiza la Etapa de la Oportunidad indicada al valor especificado.* Funciones [Pedido]: * Obtener Todos los Pedidos de Estado * Devuelve una lista de todos los Pedidosde un Estado especificado. * Contar Pedidos de Estado * Devuelve un recuento de todos los Pedidos de un Estado especificado.* Obtener Número de Pedido a partir de ID * Devuelve un Número de Pedido a partir de un ID de Pedido especificado.

Para modificar estas funciones para adaptarlas a sus necesidades, tenga en cuenta los siguientes consejos:

1. Para modificar Funciones de Conector de tipo objeto, simplemente cambie el Objeto indicado en la URL. Añada o elimine nuevas salidas según sea necesario. 2. Para modificar Funciones Conectoras de tipo consulta, todos los cambios deben realizarse en la Consulta. Esto se encuentra en los Parámetros de la Consulta, con la clave q.
2. Consejo: limite el número de respuestas de una Consulta con la función LIMIT(número_de_respuestas)

¿Ha encontrado lo que buscaba?

También puedes dirigirte a community.tulip.co para publicar tu pregunta o ver si otras personas se han enfrentado a una pregunta similar.