Cómo configurar Pipedrive con Vendedor Pro

Crea tu app de Pipedrive, obtén las credenciales OAuth y conecta tu cuenta con Vendedor Pro en menos de 10 minutos.

Antes de empezar

  • Cuenta de Pipedrive activa (cualquier plan)
  • Acceso al Pipedrive Developer Hub (developers.pipedrive.com)
  • Cuenta de Vendedor Pro (trial o de pago)

Crear la app en el Developer Hub

  1. Ir a https://developers.pipedrive.com e iniciar sesión con tu cuenta de Pipedrive
  2. Hacer clic en “Create an app”
  3. Seleccionar “Create a private app” (para uso personal/empresa) o “Create a marketplace app” (si planeas publicarla — no recomendado para uso interno)
  4. Completar los campos básicos:
    • App name: Vendedor Pro (o el nombre de tu empresa)
    • Short description: CRM para vendedores de Mercado Libre
  5. Hacer clic en “Save”
Las apps privadas de Pipedrive no requieren revisión de Pipedrive. Están disponibles de inmediato para tu cuenta.

Configurar OAuth

  1. En el menú lateral de tu app, ir a “OAuth & access scopes”
  2. En “Callback URL”, agregar: https://vendedorpro.app/api/auth/pipedrive/callback
  3. En “Permissions”, activar los siguientes scopes:
    • deals:read y deals:write
    • persons:read y persons:write
    • activities:read y activities:write
  4. Hacer clic en “Save changes”
No olvides guardar antes de salir de la página. Los scopes sin guardar no se aplicarán al flujo OAuth.

Obtener las credenciales

  1. En el menú lateral, ir a “OAuth & access scopes” → sección “Client credentials”
  2. Copiar el Client ID — lo necesitarás en el paso siguiente
  3. Hacer clic en “Show” junto a Client secret y copiarlo también
El Client Secret solo se muestra una vez. Guárdalo en un lugar seguro (tu gestor de contraseñas o como variable de entorno en Railway). Si lo pierdes, deberás regenerarlo.

Configurar las variables de entorno

En Railway (o tu plataforma de deploy), agregar estas tres variables:

PIPEDRIVE_CLIENT_ID=tu-client-id-aqui
PIPEDRIVE_CLIENT_SECRET=tu-client-secret-aqui
PIPEDRIVE_REDIRECT_URI=https://vendedorpro.app/api/auth/pipedrive/callback
Si estás en desarrollo local, usa http://localhost:3000/api/auth/pipedrive/callback como PIPEDRIVE_REDIRECT_URI y agrégala también como Callback URL en el Developer Hub (puedes tener múltiples URLs).

Conectar tu cuenta

  1. Ve a tu dashboard de Vendedor Pro → Configuración → Cuentas CRM
  2. Haz clic en “Conectar Pipedrive”
  3. Se abrirá la pantalla de autorización de Pipedrive
  4. Revisa los permisos solicitados y haz clic en “Allow and install”
  5. Serás redirigido de vuelta a Vendedor Pro
Una vez conectado, Vendedor Pro comenzará a crear Deals, Personas y Actividades en Pipedrive automáticamente cada vez que llegue una nueva pregunta de Mercado Libre.

Preguntas frecuentes

¿Pipedrive V1 API vs V2?

Usamos Pipedrive REST API v1 que es la versión estable actual. Cuando Pipedrive migre su API a v2, Vendedor Pro se actualizará automáticamente.

¿Qué pasa si regenero el Client Secret?

Deberás actualizar PIPEDRIVE_CLIENT_SECRET en Railway y reconectar tu cuenta desde Configuración → Cuentas CRM.

¿En qué datacenter funciona?

V1 funciona con el dominio global de Pipedrive (api.pipedrive.com). Si tu empresa usa un datacenter regional personalizado, contacta a soporte.

¿Puedo conectar múltiples cuentas de Pipedrive?

Cada tenant de Vendedor Pro se conecta a una organización de Pipedrive. Para múltiples organizaciones, necesitarás múltiples tenants.