salesforce

El plugin salesforce integra Salesforce CLI con Claude Code, proporcionando autenticación de org y un agente CLI de propósito general que puede ejecutar cualquier comando sf, incluidas las consultas SOQL. Admite entornos de contenedor sin interfaz gráfica con flujos de autenticación JWT, access-token y SFDX URL. La guía de uso que se muestra a continuación demuestra cómo utilizar el lenguaje natural para consultar cuentas, oportunidades, casos y contactos a través del agente CLI.

v1.0.0 Development

Instalación

/plugin install salesforce@f5-sales-demo-marketplace

Requisitos previos

Salesforce CLI (@salesforce/cli)
Org de Salesforce con acceso a la API
Una cuenta de usuario con permisos para consultar objetos (Cases, Opportunities, Accounts, Contacts)

Instale Salesforce CLI en su estación de trabajo:

brew install sf

Verifique la instalación:

sf --version

Debería ver una salida como @salesforce/cli/2.x.x.

Configuración de autenticación

Paso 1: Encuentre su dominio de Salesforce

Observe la URL de Salesforce en el navegador. Si accede a Salesforce en https://acme.lightning.force.com, su dominio de inicio de sesión es https://acme.my.salesforce.com.

Paso 2: Autenticar mediante navegador

sf org login web --alias my-org --set-default --instance-url https://YOUR-DOMAIN.my.salesforce.com

Reemplace YOUR-DOMAIN con el dominio de su empresa del Paso 1. Su navegador se abre — complete el flujo de SSO o inicio de sesión y autorice la aplicación. Debería ver:

Successfully authorized your-email@company.com with org ID 00DXXXXXXXXXXXXXXX

Paso 3: Verifique la conexión

sf org display --target-org my-org

Confirme que la salida muestre Connected Status: Connected con su nombre de usuario y la URL de instancia.

Paso 4: Autenticación portátil para contenedores (opcional)

Si necesita autenticarse en un entorno sin interfaz gráfica (CI/CD, contenedor, sesión remota), exporte la URL de autenticación SFDX desde su estación de trabajo:

sf org display --verbose --target-org my-org

Copie el valor de Sfdx Auth Url (comienza con force://). En el contenedor, ejecute:

export SFDX_AUTH_URL="force://PlatformCLI::YOUR_AUTH_TOKEN@your-domain.my.salesforce.com"
echo "$SFDX_AUTH_URL" | sf org login sfdx-url --sfdx-url-stdin=- --alias=my-org --set-default

Referencia de métodos de autenticación

Método	Ideal para	Requiere
Web Login	Estaciones de trabajo con navegador	Navegador + SSO
SFDX URL	Contenedores, CI/CD, autenticación portátil	URL de autenticación de una sesión autenticada
JWT Bearer	Pipelines automatizados	Connected App + clave privada + clave de consumidor
Access Token	Autenticación mediante variable de entorno	`SF_ACCESS_TOKEN` + `SF_ORG_INSTANCE_URL`

Nota: El flujo de dispositivo (sf org login device) está bloqueado desde agosto de 2025 y no es compatible.

Variables de entorno

Variable	Propósito
`SF_ACCESS_TOKEN`	Token Bearer para autenticación con access-token
`SFDX_AUTH_URL`	URL de autenticación Force para SFDX URL auth
`SF_ORG_INSTANCE_URL`	URL de instancia de la org
`SF_JWT_KEY_FILE`	Ruta a la clave privada JWT
`SF_CLIENT_ID`	Clave de consumidor de Connected App
`SF_USERNAME`	Nombre de usuario de Salesforce para JWT

Comandos

/salesforce:sf-status

Comprueba el estado de conexión de su org de Salesforce, la versión del CLI y las orgs autenticadas.

/salesforce:sf-status

Qué esperar: Una tabla que muestra la versión del CLI de sf, el alias de la org autenticada, el nombre de usuario, la URL de instancia, el estado de conexión y la versión de la API.

/salesforce:sf-login

Autenticarse en una org de Salesforce. Opcionalmente, proporcione un alias.

/salesforce:sf-login
/salesforce:sf-login my-org

Qué esperar: Si una org con ese alias ya está autenticada, reporta los detalles de la conexión. De lo contrario, comprueba las credenciales disponibles (variables de entorno) y se autentica utilizando el primer método completamente satisfecho.

Habilidades

salesforce-index

Enrutador de intención de nivel superior. Se activa automáticamente cuando menciona Salesforce, gestión de org o consultas de datos en lenguaje natural.

Usted dice	Ruta hacia
”login to salesforce”, “authenticate org”	habilidad `salesforce-auth`
”check org status”, “list orgs”	agente `cli-operator`
”show me opportunities”, “look up case”	agente `cli-operator` (consulta SOQL)
“generate Apex class”, “create Flow”	habilidades de desarrollo afv-library

salesforce-auth

Habilidad de autenticación adaptada para contenedores. Admite cuatro métodos de autenticación y detecta automáticamente qué credenciales están disponibles. Prioriza: access-token, luego JWT, luego SFDX URL y finalmente inicio de sesión web.

Agentes

cli-operator

Agente autónomo de Salesforce CLI que ejecuta comandos sf con restricciones de seguridad. Todas las operaciones de Salesforce se delegan a este agente para mantener el contexto de la sesión principal reducido.

Reglas de seguridad:

Solo lectura de forma predeterminada — las operaciones de escritura requieren aprobación explícita
Nunca despliega sin una vista previa y un paso de confirmación
Nunca muestra access tokens, URLs de autenticación ni credenciales en la salida
Sanea todos los valores proporcionados por el usuario (rechaza metacaracteres de shell)
Utiliza salida --json para resultados estructurados y analizables

Formato de respuesta:

## Result: [SUCCESS | FAILURE | PARTIAL]
### Command Executed
### Output Summary
### Issues

Guía de uso: Gestión de cuentas

Estos prompts funcionan con cualquier org de Salesforce. Reemplace los valores de marcador de posición con su propia información. Cada prompt produce resultados específicos para su rol, cuentas y territorio.

Primeros pasos

Después de autenticarse, verifique que todo funcione correctamente:

/salesforce:sf-status

Luego pruebe una consulta simple en lenguaje natural:

list my authenticated salesforce orgs

Qué esperar: Una tabla que muestra todas las orgs conectadas con alias, nombre de usuario, URL de instancia y estado de conexión.

Encuentre sus cuentas

Descubra a qué cuentas está asignado:

what salesforce accounts am I on the account team for? My email is your-email@company.com

Qué esperar: Una lista de cuentas agrupadas por propietario de cuenta, que muestra su rol como miembro del equipo en cada una. Si la mayoría de los roles aparecen vacíos, eso es una brecha de higiene de datos común — las membresías del equipo de cuenta existen pero los roles no fueron completados.

Compare su cobertura con un colega

Compare su cobertura de cuentas con un compañero de equipo para encontrar brechas:

In salesforce, find all accounts where Colleague Name is on the account team. Then for each of those accounts, check if your-email@company.com is also on the account team. Show me two lists: accounts where we are BOTH tagged, and accounts where only my colleague is tagged but I am missing.

Qué esperar: Una tabla resumen que muestra el recuento de superposiciones y brechas, seguida de dos listas. Si cambió de rol recientemente, puede encontrar cero superposiciones — esto revela a qué cuentas necesita ser agregado.

Resumen de pipeline de territorio

Vea todas las oportunidades abiertas en sus cuentas:

show me all open salesforce opportunities on Colleague Name's account team accounts, sorted by close date, include the stage, amount, and probability

Qué esperar: Un resumen con el recuento total de oportunidades, pipeline bruto y pipeline ponderado. Luego una tabla de distribución por etapa y una lista de las principales oportunidades por monto. La salida señala problemas de higiene de datos como fechas de cierre vencidas o montos nulos.

Análisis detallado de oportunidad

Obtenga una visión completa de un acuerdo específico:

show me a detailed view of the OPPORTUNITY NAME opportunity in salesforce - include the opportunity team members, any activities or tasks, and the account contacts

Qué esperar: La descripción general de la oportunidad (etapa, monto, fecha de cierre, probabilidad, categoría de pronóstico, propietario), miembros del equipo de oportunidad con roles, contactos etiquetados, tareas y eventos recientes, e historial de cambios de campos que muestra cómo el monto y la fecha de cierre han variado con el tiempo.

Casos de soporte en el territorio

Verifique los casos de soporte abiertos en sus cuentas:

show me all open salesforce cases across Colleague Name's account team accounts, grouped by account, sorted by most recent first

Qué esperar: Un recuento de casos abiertos con desglose por prioridad y estado, luego detalles de casos agrupados por cuenta. Los casos obsoletos (meses o años de antigüedad sin actividad) se señalan como candidatos de higiene.

Pronóstico de pipeline trimestral

Obtenga una vista de su pipeline lista para pronóstico:

for Colleague Name's accounts, show me a quarterly pipeline summary - group the open opportunities by close date quarter with count, total amount, and weighted amount for each quarter

Qué esperar: Una tabla con una fila por trimestre que muestra el recuento de oportunidades, pipeline total y pipeline ponderado. Incluye un desglose de combinación de etapas por trimestre y destaca los principales acuerdos ponderados. Las oportunidades vencidas se agrupan por separado.

Resumen completo de cuenta

Análisis detallado de un cliente específico:

give me a full account overview for ACCOUNT NAME in salesforce including contacts, open opportunities, and recent cases

Qué esperar: Perfil de la empresa (industria, ingresos, empleados, ubicación), contactos clave con títulos y correo electrónico, oportunidades abiertas con etapas y montos, y casos de soporte recientes con estado.

Búsqueda de caso

Busque un caso de soporte específico por número:

look up salesforce case CASE-NUMBER and show me the case details, the customer account, and who owns it

Qué esperar: Asunto del caso, estado, prioridad, descripción, el perfil de cuenta del cliente y el propietario del caso con información de contacto.

Guía de uso: Consultas de datos

Para usuarios avanzados, puede solicitar consultas específicas de estilo SOQL en lenguaje natural. El plugin traduce su solicitud al SOQL apropiado y lo ejecuta.

Campos específicos

query salesforce for all Contacts at ACCOUNT NAME - show Name, Title, Email, Phone, and Department

Filtrado por fecha

show me all salesforce opportunities that closed won in the last 90 days on ACCOUNT NAME

Agregación

count all open salesforce cases grouped by priority and status across my accounts

Objetos personalizados

query the CUSTOM_OBJECT__c object in salesforce for records where Status__c = 'Active'

Habilidades de desarrollo

Las 30 habilidades de desarrollo de Salesforce de la biblioteca forcedotcom/afv-library se activan automáticamente para tareas de Apex, Flow, LWC, SOQL, metadatos, Agentforce y despliegue. Instálelas por separado:

npx skills add forcedotcom/afv-library

Tema	Habilidad
Clases y servicios Apex	`generating-apex`
Pruebas Apex	`generating-apex-test`
Flows	`generating-flow`
LWC y paquetes de UI	`building-ui-bundle-app`
Objetos personalizados	`generating-custom-object`
Campos personalizados	`generating-custom-field`
Reglas de validación	`generating-validation-rule`
Conjuntos de permisos	`generating-permission-set`
FlexiPages	`generating-flexipage`
Agentes Agentforce	`developing-agentforce`
Pruebas de Agentforce	`testing-agentforce`
Despliegue	`deploying-ui-bundle`
Migración SLDS2	`uplifting-components-to-slds2`
Refactorización de triggers	`trigger-refactor-pipeline`