Salesforce Tool
Salesforce Tool lee información de tu cuenta de Salesforce: cuentas, contactos, oportunidades, casos o cualquier otro objeto al que tenga acceso tu usuario. Las consultas se escriben en SOQL, el lenguaje de consultas de Salesforce.
Puedes usarlo como herramienta, conectando su salida Tool a la entrada Tools de un agente: el agente escribe la consulta según lo que le pregunten y responde con los registros. También puedes usarlo como paso del flujo, escribiendo tú la consulta en Query to execute.
Cuándo usarlo
- Un comercial pregunta al asistente “¿Qué oportunidades tengo abiertas este mes?”.
- Quieres que un agente de soporte consulte los casos abiertos de un cliente antes de responder.
- Un flujo saca cada lunes la lista de oportunidades que cierran esa semana.
- Necesitas cruzar datos de Salesforce con otra fuente dentro de un flujo.
Configuración
Necesitas una credencial Salesforce Rest API con tu usuario, contraseña, token de seguridad y dominio de Salesforce (login para producción, test para un entorno de pruebas). Consulta Credenciales.
| Campo | Qué hace |
|---|---|
| Credential (obligatorio) | La credencial Salesforce Rest API con la que se accede a tu cuenta. |
| Query to execute | La consulta SOQL que se ejecuta con la salida Data, por ejemplo SELECT Name, Amount FROM Opportunity WHERE IsClosed = false. Como herramienta, la consulta la escribe el agente. |
Resultado
- Tool: se conecta a la entrada Tools de un agente. El agente recibe los registros que devuelve cada consulta.
- Data: una lista con un elemento por registro encontrado, con los campos que pediste en la consulta.
Ejemplo
Una empresa de software quiere que su equipo comercial consulte Salesforce desde el chat.
- Añade Salesforce Tool y elige la credencial Salesforce Rest API.
- Conecta la salida Tool a la entrada Tools del agente.
- En las instrucciones del agente, indica qué objetos y campos usáis, por ejemplo que el importe de una oportunidad está en
Amount. - Una comercial pregunta “¿Cuáles son mis cinco oportunidades abiertas de mayor importe?”. El agente consulta Salesforce y responde con la lista.
Buenas prácticas
- El componente solo lee datos; no crea ni modifica registros.
- Si el inicio de sesión falla o la consulta de Query to execute tiene un error, el componente falla con el mensaje de Salesforce. Como herramienta, el agente recibe ese mensaje y puede corregir su consulta.
- Si Domain está vacío, se usa
login(producción). - El agente ve todo lo que puede ver el usuario de la credencial. Usa un usuario con acceso solo a lo necesario.