Conector de Salesforce

Introducción

Salesforce es una plataforma de software CRM basada en la nube, utilizada en aplicaciones que van desde el seguimiento de oportunidades de venta hasta la gestión de pedidos e inventario.

Objetivo

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

Documentación de la API

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

Configuración inicial

La autenticación de la API de Salesforce sigue los estándares de OAuth 2.0. El siguiente proceso describe cómo generar un token de actualización, que posteriormente utilizará cualquier aplicación de Tulip para recuperar el token de acceso necesario para conectarse correctamente a Salesforce.

1. Crea una aplicación conectada en Salesforce. Para ello, ve al espacio «Configuración» de Salesforce. A continuación, ve a HERRAMIENTAS DE LA PLATAFORMA >> Aplicaciones >> Aplicaciones conectadas >> Gestionar aplicaciones conectadas.
2. Crea una nueva aplicación conectada. Incluye: a. los ámbitos que requiera tu aplicación, pero asegúrate de incluir refresh_token. b. Selecciona «Habilitar configuración de OAuth» e introduce la URL de devolución de llamada como https://login.salesforce.com/services/oauth2/success.
3. Una vez completado, haz clic en «Gestionar detalles del consumidor » para ver tu «Clave de consumidor» y tu «Secreto de consumidor». Estos se utilizarán más adelante.
4. Ahora, en Tulip, abre la URL « Connector Function » [Configuración] «Obtener código de autorización». Copia y pega la «Clave de consumidor» generada en el paso 3 anterior como parámetro de consulta client_id.
5. «Ejecuta» el conector « Connector Function ».
6. Fíjate en que se ha generado una URL como «Salida» del conector. Pega esta URL en la ventana de tu navegador.
7. Sigue las instrucciones de autenticación que aparecen para autorizar correctamente a Tulip a interactuar con tu instancia de Salesforce.
8. Si todo va bien, tu navegador debería redirigirte a una nueva página que dice «Autorización de la 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. Guarda este código de autorización. Ten en cuenta que el código debe terminar con dos símbolos de igualdad: ==. Si el código termina en %3D%3D, elimina estos caracteres y sustitúyelos por ==.
10. Accede a la página [Configuración] Obtener token de actualización de Tulip Connector Function. En los parámetros de consulta, pega toda la información recopilada anteriormente:
    • grant_type= authorization_code
    • redirect_uri= https://login.salesforce.com/services/oauth2/success
    • client_id= la clave de consumidor del paso 3 anterior
    • client_secret= el secreto de 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, ve a [Auth] Obtener token de acceso Connector Function. Rellena los siguientes parámetros de consulta:
    • grant_type= authorization_code
    • client_id= la clave de consumidor del paso 3 anterior
    • client_secret= el secreto de consumidor del paso 3 anterior
    • refresh_token= el token de actualización del paso 10 anterior
13. Ejecuta el conector. Ten en cuenta que la respuesta incluye un «access_token», que se asigna como salida. Guarda el conector para conservar el token de actualización

Una vez que esta función sea capaz de generar un access_token, ¡la configuración habrá finalizado! Este access_token podrá utilizarse a partir de ahora en cualquier Connector Function posterior, siempre y cuando lo permitan los ajustes de tiempo de espera configurados en el paso 2.

Detalles de conexión de Tulip

Para que sus conectores puedan interactuar 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 debería ser sample.my.

Ten en cuenta que todos los conectores « Connector Functions » están diseñados para funcionar con la API REST de Salesforce v46.0.

Connector Functions

Existen dos tipos principales de conectores: los de tipo objeto y los de tipo consulta. Ten en cuenta que ambos conectores requieren un access_token, así que asegúrate de ejecutar [Auth] Obtener token de acceso en tu aplicación antes de utilizarlos. Se recomienda habitualmente generar un nuevo token de acceso al iniciar la aplicación o el proceso, y guardarlo en una variable de la aplicación para su uso posterior.

Conectores de tipo objeto

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

Conectores de tipo consulta

• Devuelven únicamente los campos especificados en la consulta.
• Pueden devolver información vinculada (por ejemplo, el nombre de la cuenta relacionada con una oportunidad) o agregada (por ejemplo, un recuento de registros).
• Utiliza el punto final ./services/data/v46.0/query
• Es necesario escribir una consulta utilizando SOQL (documentación aquí{target=_blank}).
• Ejemplo: Conector [Pedido] Obtener todos los pedidos con estado

Incluido Connector Functions

En este paquete se incluyen los siguientes « Connector Functions », que pretenden servir como introducción a las funciones disponibles a través de la API de Salesforce:* [Configuración] Obtener URL del código de autenticación y [Configuración] Obtener token de actualización * Se utilizan únicamente para la configuración inicial. Consulta más arriba para obtener más información.*[Autenticación] Obtener token de acceso * Se utiliza para generar un token de acceso, que debe incluirse en todas las llamadas posteriores a Connector Functions.* Funciones [Oportunidad]: * Obtener todos los campos * Devuelve todos los campos de la oportunidad consultada. Requiere un token de acceso y el ID de la oportunidad. * Cambiar fase * Actualiza la fase de la oportunidad indicada al valor especificado.* Funciones [Pedido]: * Obtener todos los pedidos con un estado determinado * Devuelve una lista de todos los pedidos con un estado específico. * Contar pedidos con un estado determinado * Devuelve el recuento de todos los pedidos con un estado específico. * Obtener el número de pedido a partir del ID * Devuelve el número de pedido a partir de un ID de pedido específico.

Para modificar estas funciones según tus necesidades, ten en cuenta las siguientes recomendaciones: 1. Para modificar las funciones de tipo objeto Connector Functions, basta con cambiar el objeto indicado en la URL. Añade o elimina nuevas salidas según sea necesario. 2. Para modificar funciones de tipo consulta Connector Functions, todos los cambios deben realizarse en la consulta. Esto se encuentra en los parámetros de consulta, con la clave q. 1. Consejo: limita el número de respuestas de una consulta con la función LIMIT(número_de_respuestas)

¿Has encontrado lo que buscabas?

También puedes visitar community.tulip.co para publicar tu pregunta o ver si otros usuarios se han enfrentado a un problema similar.