Zoho es multirregión: tu cuenta reside en un centro de datos específico, y el flujo OAuth debe pasar por los servidores de autenticación de la región correspondiente. Anexus te pregunta cuál antes de redirigir.
Antes de comenzar
- Una cuenta de Zoho CRM en cualquier plan que exponga la API (incluido el plan gratuito).
- Saber en qué centro de datos está tu cuenta de Zoho (lo puedes ver en la URL de tu panel de Zoho).
Referencia rápida de centros de datos
| Tu URL de Zoho termina en… | Elige este CD |
|---|---|
.zoho.com | US |
.zoho.eu | EU |
.zoho.in | IN |
.zoho.com.au | AU |
.zoho.jp | JP |
.zohocloud.ca | CA |
Paso 1: Elige tu CD y haz clic en Conectar
En Anexus, Configuración → Integraciones CRM → Zoho CRM.
En el pequeño menú desplegable junto al botón Conectar, selecciona tu centro de datos (US, EU, IN, AU, JP o CA).
Haz clic en Conectar con Zoho CRM. Se te redirige a la página de inicio de sesión de Zoho de la región que elegiste.
Paso 2: Inicia sesión y autoriza
Inicia sesión con tus credenciales de Zoho.
Zoho te muestra una pantalla de consentimiento. Anexus solicita:
- ZohoCRM.modules.contacts.ALL — leer y escribir registros de Contacto
- ZohoCRM.users.READ — leer tu registro de usuario (se usa para mostrar el nombre de tu cuenta)
Haz clic en Aceptar.
Zoho te redirige de vuelta a Anexus. La tarjeta de Zoho cambia al estado verde "Conectado".
Qué se sincroniza con Zoho CRM
Cada contacto capturado se convierte en (o actualiza) un Contacto de Zoho. Usamos el endpoint upsert de Zoho: si la misma persona envía tu formulario dos veces, se actualiza el Contacto existente y nunca se crea un duplicado.
Campos sincronizados:
- Nombre, Apellido (el Apellido se establece como "Unknown" por defecto si falta: requerido por Zoho)
- Correo electrónico
- Teléfono
- Cargo
- Nombre de la cuenta (desde el campo empresa)
Usa Sincronizar contactos anteriores en la tarjeta de Zoho para reponer todo lo capturado antes de conectar.
Si algo sale mal
"Invalid Client" en la pantalla de consentimiento
Elegiste el centro de datos equivocado. La aplicación Anexus está registrada por separado en cada región de Zoho: si seleccionas US pero tu cuenta está en EU, el servidor US de Zoho no encuentra una aplicación coincidente. Desconecta, elige el CD correcto e inténtalo de nuevo.
"Sesión de Zoho inválida" al probar
El token de acceso expiró y la actualización falló. Es poco común: desconecta y vuelve a conectar.
Faltan campos en los contactos en Zoho
A veces las organizaciones de Zoho añaden campos personalizados obligatorios. Nuestro upsert solo envía los campos estándar; si tu organización exige campos personalizados, el contacto igual se guarda pero con valores personalizados vacíos. Tu administrador puede marcar esos campos personalizados como no obligatorios, o puedes completarlos manualmente.
Cómo desconectar
Haz clic en Desconectar en Anexus. Para revocar también desde el lado de Zoho: inicia sesión en Zoho, haz clic en tu perfil, Mi cuenta → Authtokens activos, busca Anexus Connect y haz clic en Revocar.