Cómo configurar Zoho CRM con Vendedor Pro

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

Antes de empezar

  • Cuenta de Zoho CRM activa (cualquier plan, incluyendo Free)
  • Acceso a Zoho API Console (api-console.zoho.com)
  • Cuenta de Vendedor Pro (trial o de pago)

Crear la app en Zoho API Console

  1. Ir a https://api-console.zoho.com e iniciar sesión con tu cuenta de Zoho
  2. Hacer clic en “Add Client”
  3. Seleccionar “Server-based Applications” (para flujo OAuth con servidor)
  4. Completar los campos:
    • Client Name: Vendedor Pro
    • Homepage URL: https://vendedorpro.app
    • Authorized Redirect URIs: https://vendedorpro.app/api/auth/zoho/callback
  5. Hacer clic en “Create”
Zoho llama a estas apps “Server-based Applications” porque el flujo OAuth ocurre en el servidor, no en el navegador del usuario.

Configurar los scopes

Los scopes definen qué datos puede acceder Vendedor Pro en tu Zoho CRM. Los scopes requeridos son:

ZohoCRM.modules.deals.ALL
ZohoCRM.modules.contacts.ALL
ZohoCRM.modules.notes.ALL
ZohoCRM.modules.tasks.ALL
ZohoCRM.org.ALL
No necesitas configurar los scopes en la API Console — Zoho los solicita automáticamente durante el flujo OAuth cuando conectas tu cuenta desde el dashboard de Vendedor Pro.

Obtener las credenciales

  1. Una vez creada la app, verás el Client ID y el Client Secret en la pantalla de detalle
  2. Copia ambos valores — los necesitarás en el paso siguiente
El Client Secret es sensible. Guárdalo en tu gestor de contraseñas o directamente en las variables de entorno de Railway. Nunca lo compartas ni lo incluyas en código fuente.

Configurar las variables de entorno

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

ZOHO_CLIENT_ID=tu-client-id-aqui
ZOHO_CLIENT_SECRET=tu-client-secret-aqui
ZOHO_REDIRECT_URI=https://vendedorpro.app/api/auth/zoho/callback
Para desarrollo local, usa http://localhost:3000/api/auth/zoho/callback como ZOHO_REDIRECT_URI y agrégala también como Authorized Redirect URI en la API Console.

Configurar el pipeline de Zoho CRM

Vendedor Pro usa nombres de etapa específicos para mover los deals en tu pipeline. Antes de conectar, asegúrate de que tu pipeline de Zoho CRM tenga las siguientes etapas con estos nombres exactos:

  • Interés
  • Intención de Compra
  • Respondido
  • SLA Vencido
  • Pedido Realizado
  • Cancelado
Los nombres de las etapas deben coincidir exactamente (incluyendo acentos). Si usas nombres diferentes, los deals no se moverán automáticamente entre etapas.

Conectar tu cuenta

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

Preguntas frecuentes

¿Qué datacenter de Zoho debo usar?

V1 soporta el datacenter global de Zoho (zohoapis.com). Si tu cuenta está en la región EU o IN, contacta a soporte.

¿Qué pasa si regenero el Client Secret?

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

¿Qué pipelines debo crear en Zoho?

Los stages del pipeline deben llamarse exactamente: Interés, Intención de Compra, Respondido, SLA Vencido, Pedido Realizado, Cancelado.

¿Puedo conectar múltiples organizaciones de Zoho?

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

← Configurar HubSpotConfigurar Pipedrive →