Cómo recuperar conectores en Zoho CRM

Recuperar conectores en Zoho CRM significa acceder a los enlaces de autenticación que permiten que tu cuenta de CRM se comunique con servicios de terceros, y entender cómo referenciarlos correctamente dentro de tus funciones de Deluge.

Por qué esto es importante

Los conectores (también llamados Connections) actúan como puente de autenticación entre Zoho CRM y las aplicaciones externas. Cuando creas una función que llama a un servicio externo, necesitas conocer el nombre de enlace del conector y su estado actual antes de poder invocarlo de forma fiable. ^[8] Ya sea que estés extrayendo datos de campañas desde MailChimp o consultando una API REST externa, el conector debe estar configurado y ser recuperable antes de que cualquier código de integración funcione. ^[1]

> Nota: Beam Help es soporte experto independiente para Zoho — no somos el soporte oficial de Zoho.

---

Paso a paso

Paso 1. Inicia sesión en tu cuenta de Zoho CRM y ve a Configuración. Desde allí, localiza la sección Developer Space (o Developer Hub) en el menú de la izquierda. Aquí es donde se gestiona toda la configuración de conectores y funciones. ^[1]

Paso 2. Dentro del área de desarrollador, selecciona Connections (a veces etiquetado como Connectors según la versión de tu CRM). Esta sección lista todos los enlaces de autenticación que tu organización ya ha creado, junto con su estado actual. ^[8]

Paso 3. En la lista de Connections, localiza el conector que deseas recuperar. Cada entrada muestra tres datos clave: el nombre de enlace, el nombre del servicio (la aplicación de terceros contra la que se autentica) y el estado de la conexión (activo o inactivo). ^[1]

Paso 4. Haz clic en un conector específico para abrir su vista de detalle. Aquí encontrarás el fragmento de código generado automáticamente que te muestra exactamente cómo referenciar este conector dentro de una función de Deluge. El campo Connection en ese fragmento corresponde directamente al nombre de enlace que viste en la lista. ^[1]

Paso 5. Copia el nombre de enlace desde la vista de detalle. Esta cadena es la que pasarás como parámetro connection cada vez que uses una tarea Invoke URL en una función de Deluge para llamar al servicio de terceros. ^[1]

Paso 6. Si necesitas que el conector se use como fuente para la función Queries, ve a Configuración → Developer Space → Queries y añade una nueva fuente REST API. En ese formulario puedes especificar la URL base, los parámetros predeterminados, los encabezados y, de forma fundamental, seleccionar la conexión (conector) existente desde un menú desplegable para autenticar la consulta. ^[7]

Paso 7. Para verificar que el conector funciona de extremo a extremo, referencíalo dentro de una función de prueba usando la tarea Invoke URL. El editor de funciones te mostrará el nombre de enlace de la conexión en contexto, y podrás ejecutar una llamada de prueba para confirmar que el servicio de terceros responde como se espera. ^[1]

---

Errores comunes

• Mayúsculas y minúsculas incorrectas en el nombre de enlace: El nombre de enlace distingue entre mayúsculas y minúsculas cuando se referencia en código Deluge. Cópialo exactamente como aparece en la página de detalle del conector — no lo escribas manualmente. ^[1]

• Estado inactivo: Si el estado del conector aparece como inactivo o caducado, es posible que el token de autenticación haya expirado. Deberás volver a autorizar la conexión antes de que cualquier función que la referencie funcione correctamente. ^[8]

• Dominios de confianza faltantes para fuentes de base de datos: Si usas la función Queries con un conector REST API y el host no está en formato de dirección IP, debes añadirlo a Trusted Domains en la configuración de tu CRM y añadir a la lista blanca las IPs de Zoho CRM en el lado del servidor de retransmisión. Omitir este paso causará tiempos de espera de conexión incluso cuando el conector en sí aparezca activo. ^[7]

• Alcance del conector vs. alcance de la función: Las conexiones pueden invocarse desde funciones y widgets, pero el conector debe haber recibido los ámbitos OAuth correctos para el servicio de terceros en el momento de su creación. Recuperar un conector que fue configurado con ámbitos insuficientes generará errores de autorización en tiempo de ejecución, no en la etapa de recuperación. ^[8]

---

Qué verificar

• El nombre de enlace es exacto: Confirma que el nombre de enlace copiado desde la vista de detalle del conector coincide carácter por carácter con lo que aparece en el parámetro connection de tu función de Deluge. ^[1]
• El estado está activo: En la lista de Connections, verifica que la columna de estado del conector muestre un estado activo/conectado antes de desplegar cualquier función que dependa de él. ^[1]
• La fuente está configurada para Queries (si aplica): Si usas el conector como fuente REST API dentro de la función Queries, confirma que la URL base, los encabezados y la referencia de conexión estén todos correctamente completados en la configuración de la fuente. ^[7]