> For the complete documentation index, see [llms.txt](https://aizy.gitbook.io/aizy-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://aizy.gitbook.io/aizy-docs/aizy-docs-es/crm-integrations/zoho-crm.md).

# Zoho CRM

### 1. Antes de empezar

Crea un cliente OAuth en Zoho API Console y registra la **Redirect URI** que muestra Aizy.

Necesitarás:

* Client ID.
* Client Secret.
* Dominio de cuentas de tu región.
* Dominio API de tu región.
* Versión API.

Referencias oficiales:

* <https://api-console.zoho.com/>
* <https://www.zoho.com/crm/developer/docs/api/v8/register-client.html>
* <https://www.zoho.com/crm/developer/docs/api/v8/oauth-overview.html>
* <https://www.zoho.com/crm/developer/docs/api/v8/api-endpoints.html>

### 2. Conectar Zoho CRM

1. Selecciona **Zoho CRM** y activa la integración.
2. Completa Client ID, Client Secret, dominios y versión API.
3. Copia la Redirect URI a Zoho.
4. Pulsa **Conectar Zoho (OAuth)** y autoriza los scopes.
5. Guarda, actualiza permisos y habilita las acciones necesarias.

El refresh token se guarda para renovar el acceso. Zoho conserva los scopes concedidos por OAuth; si faltan acciones, reconecta solicitando los permisos correctos.

### 3. Acciones disponibles

Según los scopes detectados:

* Buscar contacto por email.
* Buscar contacto por teléfono.
* Crear o actualizar contacto.
* Crear lead.
* Crear caso.
* Crear tarea.

### 4. Configurar una Task

Añade una acción CRM con proveedor Zoho. Las búsquedas usan exclusivamente el criterio elegido. Si un lead, caso o tarea debe relacionarse con un contacto, ejecuta antes la acción de contacto correspondiente.

Los casos creados se registran como nota interna en Inbox con su ID. Aizy no inventa una URL web de Zoho cuando la configuración no ofrece una ruta fiable.

### 5. Seguridad

No compartas Client Secret, refresh token ni access tokens. Si cambias de región, revisa ambos dominios antes de reconectar.