Saltearse al contenido
Nappai Documentation

Salesforce Tool

El Salesforce Tool te permite ejecutar consultas SOQL directamente desde tu panel de Nappai y obtener los resultados como datos estructurados que puedes usar en cualquier flujo de trabajo. Es ideal para extraer información de tu cuenta de Salesforce sin salir de la plataforma.

¿Cómo funciona?

Cuando configuras el componente, seleccionas una credencial de tipo Salesforce Rest API que ya has creado en la sección de credenciales de Nappai. Esa credencial contiene tu nombre de usuario, contraseña, token de seguridad y dominio (login o test).
Al ejecutar el componente:

  1. Conexión: Se crea un objeto SalesforceWrapper con los datos de la credencial.
  2. Consulta: Se envía la consulta SOQL que escribiste en el campo Query to execute a Salesforce.
  3. Resultado: Los registros devueltos se convierten en una lista de objetos Data, que se entregan como salida Data.
  4. Herramienta: También puedes obtener una herramienta BaseTool (salida Tool) que se puede usar en pipelines de Nappai para ejecutar consultas de forma programática.

Entradas

El componente necesita dos cosas:

  • Credential – Selecciona la credencial Salesforce Rest API que ya configuraste en Nappai.
  • Query to execute – Escribe la consulta SOQL que quieres ejecutar.
    • Ejemplo: 
      SELECT Id, Name, Email FROM Contact WHERE CreatedDate > LAST_N_DAYS:30

Nota: Los campos de la credencial (usuario, contraseña, token, dominio) no se muestran aquí porque ya están incluidos en la credencial seleccionada.

Campos de Entrada

  • Query to execute: La consulta SOQL que se enviará a Salesforce.
    • Visible en: Todas las ejecuciones del componente.

Salidas

SalidaTipoDescripción
DataDataLista de registros devueltos por la consulta. Puedes usarla como entrada para otros componentes o visualizarla en tu dashboard.
ToolBaseToolHerramienta que permite ejecutar consultas SOQL desde pipelines de Nappai. Útil si quieres integrar la consulta en flujos más complejos.

Ejemplo de Uso

  1. Configura la credencial
    • Ve a Credenciales → Agregar credencial → selecciona Salesforce Rest API.
    • Ingresa tu usuario, contraseña, token de seguridad y dominio (ej. login o test).
  2. Añade el componente
    • Arrastra el Salesforce Tool al canvas.
    • En el campo Credential, elige la credencial que acabas de crear.
    • En Query to execute, escribe: 
      SELECT Id, Name, Email FROM Contact WHERE CreatedDate > LAST_N_DAYS:30
  3. Ejecuta
    • Haz clic en Run y observa la salida Data con los contactos creados en los últimos 30 días.
    • Si necesitas usar la herramienta en un pipeline, conecta la salida Tool a otro componente que requiera un BaseTool.

Componentes Relacionados

  • SalesforceSOQLTool – La herramienta que se crea internamente para ejecutar consultas SOQL dentro de pipelines.
  • SalesforceWrapper – Clase que gestiona la conexión a la API REST de Salesforce.

Consejos y Mejores Prácticas

  • Prueba tus consultas en la consola de Salesforce antes de usarlas en Nappai para evitar errores.
  • Limita los campos que consultas para reducir la carga de datos y acelerar la respuesta.
  • Usa dominios de sandbox (test) cuando desarrolles o pruebes, y cambia a login en producción.
  • Mantén tus credenciales seguras: no las compartas y revisa los permisos de la cuenta de Salesforce.

Consideraciones de Seguridad

  • La credencial Salesforce Rest API se almacena de forma cifrada en Nappai; no se exponen los datos sensibles en el flujo.
  • Asegúrate de que la cuenta de Salesforce tenga solo los permisos necesarios para las consultas que vas a ejecutar.
  • Si compartes el flujo con otros usuarios, revisa que tengan acceso a la credencial correspondiente.