Cómo configurar Salesforce con Vendedor Pro
Crea un Connected App en Salesforce, configura los scopes OAuth y conecta tu org con Vendedor Pro en menos de 15 minutos.
Antes de empezar
- Cuenta de Salesforce activa (cualquier edición — Developer, Professional, Enterprise, etc.)
- Permisos de administrador en tu org (para crear Connected Apps)
- Cuenta de Vendedor Pro (trial o de pago)
Crear el Connected App
- En Salesforce, hacer clic en el ícono de engranaje (⚙️) → Setup
- En la barra de búsqueda rápida, escribir “App Manager” y seleccionarlo
- Hacer clic en “New Connected App” (esquina superior derecha)
- Completar la sección Basic Information:
- Connected App Name:
Vendedor Pro - API Name: se completa automáticamente
- Contact Email: tu email de administrador
- Connected App Name:
- Continuar al siguiente paso
Necesitas permisos de administrador (
Customize Application) para crear Connected Apps en Salesforce.Configurar OAuth
En la sección API (Enable OAuth Settings):
- Marcar la casilla “Enable OAuth Settings”
- En “Callback URL”, agregar:
https://vendedorpro.app/api/auth/salesforce/callback - En “Selected OAuth Scopes”, agregar los siguientes (usando el botón “Add”):
Access and manage your data (api)Perform requests at any time (refresh_token, offline_access)
- Dejar las demás opciones con sus valores por defecto
- Hacer clic en “Save”
Salesforce puede tardar hasta 10 minutos en activar el nuevo Connected App. Si ves errores durante la conexión, espera unos minutos y vuelve a intentarlo.
Obtener las credenciales
- Después de guardar, ve a la vista de detalle del Connected App
- Hacer clic en “Manage Consumer Details” (puede requerir verificación de identidad)
- Copiar el Consumer Key (= Client ID) y el Consumer Secret
El Consumer Secret es equivalente a una contraseña. Guárdalo en tu gestor de contraseñas o agrégalo directamente a las variables de entorno de Railway. Nunca lo incluyas en código fuente.
Configurar las variables de entorno
En Railway (o tu plataforma de deploy), agregar:
SALESFORCE_CLIENT_ID=tu-consumer-key-aqui
SALESFORCE_CLIENT_SECRET=tu-consumer-secret-aqui
SALESFORCE_REDIRECT_URI=https://vendedorpro.app/api/auth/salesforce/callbackPara desarrollo local, usa
http://localhost:3000/api/auth/salesforce/callback y agrégalo también como Callback URL en el Connected App (puedes tener múltiples URLs separadas por línea).Conectar tu org
- Ve a tu dashboard de Vendedor Pro → Configuración → Cuentas CRM
- Haz clic en “Conectar Salesforce”
- Se abrirá la pantalla de autorización de Salesforce
- Inicia sesión con tu cuenta de Salesforce (si no estás ya autenticado)
- Revisa los permisos y haz clic en “Allow”
- Serás redirigido de vuelta a Vendedor Pro
Una vez conectado, Vendedor Pro comenzará a crear Opportunities, Contacts y Tasks en Salesforce automáticamente cada vez que llegue una nueva pregunta de Mercado Libre.
Qué crea Vendedor Pro en Salesforce
| Evento en ML | Objeto en Salesforce |
|---|---|
| Nueva pregunta con alta intención | Opportunity + OpportunityContactRole |
| Comprador identificado | Contact (deduplicado por email) |
| Borrador de respuesta generado | Task vinculado al Opportunity |
| SLA vencido | Stage del Opportunity actualizado |
Las Opportunities se crean con
CloseDate a 30 días desde la pregunta. Puedes ajustar este valor desde Configuración → Ajustes de Pipeline.Preguntas frecuentes
¿Funciona con Salesforce Sandbox?
V1 solo soporta orgs de producción (login.salesforce.com). El soporte para Sandbox (test.salesforce.com) está en el roadmap.
¿Qué pasa si mi org cambia de instancia?
Vendedor Pro almacena el ID estable de tu org (sf_org_id), no la URL de instancia. Si tu org migra a otra instancia de Salesforce, solo necesitas reconectarte una vez para actualizar la URL.
¿Qué pasa si regenero el Consumer Secret?
Deberás actualizar SALESFORCE_CLIENT_SECRET en Railway y reconectar desde Configuración → Cuentas CRM.
¿Puedo conectar múltiples orgs de Salesforce?
Cada tenant de Vendedor Pro se conecta a una org de Salesforce. Para múltiples orgs, necesitarás múltiples tenants.