Integración · CRM

Conectar Zoho CRM a Igniten

Zoho CRM es donde su equipo guarda contactos, empresas y negocios. Igniten los lee para contestarle, por ejemplo cuánto hay en el pipeline o quién es el contacto de una empresa. Antes de cambiar algo le muestra una tarjeta y espera su confirmación. No borra registros, no los fusiona y no mueve plata. La aplicación se llama Igniten y la registra quien administra Igniten en la consola de Zoho. Hasta que eso ocurra, el enlace de autorización no está vivo y la conexión queda pendiente hasta que se registre. Nunca se pide pegar una clave ni un JSON.

Qué lee Igniten, y qué no

Lee

Contactos, empresas, negocios, prospectos (leads: gente que todavía no es contacto), tareas y notas.
El nombre de quien es dueño de cada registro, para preguntas como los contactos de Marcos.
La fecha de la última modificación de cada negocio, para avisar si lleva días quieto.

No lee

No se lee el correo de Zoho ni los archivos adjuntos.
No se guardan en el índice la etapa ni el monto: eso se consulta en el momento, para no mostrar un dato viejo.
No se piden permisos para borrar.
Las personas de Igniten con permiso CRM ven los registros autorizados por la cuenta de integración de Zoho, no sus cuentas particulares.

Cómo se conecta

2 pasos · ≈ 3 min

1
Conectar la lectura

En el panel de Igniten, abra Integraciones y toque Conectar lectura de Zoho CRM.
- Lo hace un administrador con una cuenta de integración de Zoho con permisos mínimos. Si no es usted, mándele este instructivo.
- Va a ir a Zoho. Entre con esa cuenta y acepte los permisos de lectura. Zoho le devuelve a Igniten; no tiene que copiar ninguna clave.
Salió bien si Igniten muestra Zoho CRM quedó conectado con los permisos que autorizó.
2
Autorizar los cambios con tarjeta

En Integraciones, toque Autorizar escritura con tarjeta y acepte en Zoho.
- Este permiso se autoriza aparte. La lectura sigue disponible si no autoriza cambios.
- Antes de cada alta o actualización, Igniten muestra una tarjeta y espera su confirmación. No borra ni fusiona registros.
Salió bien si Vuelve a Igniten y ve el aviso de conexión. No hay que pegar un texto con llaves.

Qué permisos pide

Permiso	Para qué	Cuándo hace falta
`ZohoCRM.modules.contacts.READ`	Ver contactos: para decirle quién es una persona y su correo.	Siempre
`ZohoCRM.modules.accounts.READ`	Ver empresas: para decirle la cuenta a la que pertenece un contacto.	Siempre
`ZohoCRM.modules.deals.READ`	Ver negocios: para contestarle cuánto hay en cada etapa.	Siempre
`ZohoCRM.modules.leads.READ`	Ver prospectos: gente que todavía no es contacto.	Siempre
`ZohoCRM.modules.tasks.READ`	Ver tareas: para decirle qué hay pendiente.	Siempre
`ZohoCRM.modules.notes.READ`	Ver notas: para leer lo que el equipo escribió en un registro.	Siempre
`ZohoCRM.settings.layouts.READ`	Ver diseños: para obtener el identificador requerido al leer los embudos.	Siempre
`ZohoCRM.settings.pipeline.READ`	Ver embudos: para validar las etapas de sus negocios.	Siempre
`ZohoCRM.users.READ`	Ver usuarios: para saber quién es el dueño de un contacto.	Siempre
`ZohoCRM.coql.READ`	Consultar con filtros: para pedirle hasta un tope de filas sin traer el CRM entero.	Siempre
`ZohoCRM.modules.contacts.CREATE`	Crear contactos, sólo después de que confirme la tarjeta.	Siempre
`ZohoCRM.modules.contacts.UPDATE`	Actualizar contactos, sólo después de que confirme la tarjeta.	Siempre
`ZohoCRM.modules.accounts.CREATE`	Crear empresas, sólo después de que confirme la tarjeta.	Siempre
`ZohoCRM.modules.accounts.UPDATE`	Actualizar empresas, sólo después de que confirme la tarjeta.	Siempre
`ZohoCRM.modules.deals.CREATE`	Crear negocios, sólo después de que confirme la tarjeta.	Siempre
`ZohoCRM.modules.deals.UPDATE`	Actualizar negocios y su etapa, sólo después de que confirme la tarjeta.	Siempre
`ZohoCRM.modules.tasks.CREATE`	Crear tareas, sólo después de que confirme la tarjeta.	Siempre
`ZohoCRM.modules.notes.CREATE`	Crear notas, sólo después de que confirme la tarjeta. Igniten le va a pedir confirmación cada vez antes de cambiar algo.	Siempre

Los dos niveles de permiso que recomendamos, y qué habilita cada uno, están en Permisos recomendados.

Qué puede salir mal

Zoho rechazó la clave.

Por qué El refresh token no corresponde a este data center, o la app de Igniten todavía no tiene identificador.

Qué hacer Revise que el servidor de cuentas sea el de su región y avísenos si falta registrar la app Igniten.

Ve un 403 o «no autorizado».

Por qué Falta un alcance de lectura o de escritura en la app.

Qué hacer Vuelva a autorizar la lectura o la escritura desde Integraciones. Si sigue el error, avísenos; los alcances de la aplicación los administra Igniten.

La dirección de Zoho no está en la lista.

Por qué El data center que devolvió Zoho no es uno de los publicados.

Qué hacer No se envió la clave. Copie el servidor de cuentas tal como lo muestra Zoho, con https.

Zoho pidió esperar.

Por qué El CRM limitó la cantidad de consultas por minuto.

Qué hacer Espere un momento y vuelva a preguntar. Igniten no reintenta una escritura que falló.

Los límites, dichos

Cada consulta trae hasta cien registros. Si hay más, la respuesta dice «hasta N» y no inventa el total.
La escritura se puede apagar sin desconectar la lectura.

Preguntas frecuentes

¿Dónde encuentro la clave?

En el panel de Igniten, abra Integraciones y toque Conectar lectura de Zoho CRM. Entre en Zoho con la cuenta de integración y acepte. Vuelve a Igniten sin copiar ninguna clave. Autorice la escritura aparte desde Autorizar escritura con tarjeta. Si la app todavía no está registrada, la conexión queda pendiente y avísenos.

Me dice que Zoho rechazó la clave, o veo un 403.

La clave no alcanza para lo que se pidió, o venció. Pídale a un administrador que vuelva a autorizar ese nivel desde Integraciones; no pegue ninguna clave. No hace falta reiniciar nada en su computadora.

¿Puede borrar cosas?

No. Igniten no pide el permiso de borrar y no tiene una acción de borrado ni de fusión. Lo único que escribe es crear o actualizar, y siempre después de que confirme una tarjeta.

No soy administrador.

Mándele este instructivo a alguien con permiso de administrador de Zoho CRM. Esa persona autoriza la cuenta de integración desde Integraciones; no hay que sacar una clave.

¿Cuánto tarda?

Conectar y aceptar los permisos lleva unos tres minutos. La primera consulta se ve enseguida. Si Zoho pide esperar, Igniten no se queda colgado más de medio minuto.

¿Qué ve Igniten?

Contactos, empresas, negocios, prospectos, tareas y notas, y quién es el dueño de cada uno. La etapa y el monto se miran en el momento y no se guardan en el índice. No ve su correo de Zoho ni los adjuntos.

¿Cómo lo desconecto?

En el panel de Igniten, en la fila de Zoho CRM, revoque la clave. A partir de ahí las preguntas dejan de consultar Zoho. En Zoho puede además quitar el acceso de la aplicación Igniten.

Pegué en el chat un texto largo que parece una clave. ¿Lo van a leer?

No lo repita. El chat de ayuda corta cuando ve una clave y no la manda al modelo. Bórrela del mensaje y pida el paso otra vez sin pegarla. La clave se carga sólo en el campo de la conexión, que se completa automáticamente y queda cifrado.