# Envía leads a Zoho CRM

> Un lead del chat se convierte en un registro del módulo de Zoho que elijas, en tu propio centro de datos.

Source: https://welcomeai.dev/es/docs/zoho
Category: Destinos
Updated: 2026-09-11

---
## El centro de datos va primero

Zoho tiene **estados separados** que no comparten cuentas. Una cuenta creada en Europa vive en
`zohoapis.eu` y no existe en `zohoapis.com`; un refresh token emitido en `accounts.zoho.eu` se
rechaza en `accounts.zoho.com`.

Se pregunta en la pantalla de conexión en vez de adivinarse, porque adivinarlo mal produce un error
de autenticación que parece exactamente una credencial mala, y manda a la gente a rotar un token que
estaba bien. Elige el de tu cuenta: `.com`, `.eu`, `.in`, `.com.au`, `.jp`, `.ca`, `.com.cn` o `.sa`.

## Qué necesitas

Un **Self Client** en la consola de API de Zoho, y un refresh token suyo, para tres permisos:

- `ZohoCRM.modules.ALL` -- crear el registro.
- `ZohoCRM.settings.modules.READ` -- listar los módulos, para que la ruta pueda apuntar a uno.
- `ZohoCRM.settings.fields.READ` -- leer los campos de un módulo, para que el mapeador ofrezca lo que
  existe.

De ahí salen un **client id**, un **client secret** y un **refresh token**. El refresh token no caduca
solo; cada llamada lo cambia por un token de vida corta que dura una hora aproximadamente.

## Conecta y crea la ruta

1. En **Destinos**, conecta Zoho CRM con los cuatro valores.
2. Elige el **módulo**. Están todos aquellos en los que tu cuenta puede crear, estándar y propios.
3. Crea una **ruta**: qué leads toma y en qué módulo aterrizan.
4. **Mapea los campos**, leídos de la configuración de ese módulo.

## Listas de valores, y el 201 que no es un éxito

Un valor de lista solo se envía cuando coincide con uno que tenga el módulo. Uno parecido se omite y
se nombra en el registro de envíos, porque Zoho rechaza el **registro entero** por un solo valor malo.

Zoho además responde `201 Created` con un **estado por registro dentro del cuerpo**: un registro
rechazado llega dentro de una respuesta que parece correcta. Leemos ese estado, así que un rechazo es
un envío fallido con el motivo de Zoho encima, y no un éxito que nunca ocurrió.

**Leads y Contactos necesitan apellido.** Se rellena con lo que traiga el lead cuando tu mapeo lo deja
fuera.

## Qué no hace

Crea. No deduplica contra lo que ya hay en el módulo y no asigna propietario: un propietario es un id
de usuario de Zoho, y una respuesta de lead es texto.