Zoho CRM
Conecte Zoho CRM con un cliente OAuth de Zoho y el centro de datos correcto para que un agente pueda crear clientes potenciales y añadir notas.
Qué conseguirá
Un agente podrá crear un Lead en Zoho CRM y añadir notas a los registros.
Descripción general y casos de uso
- Guardar a quien llama como Leads de Zoho.
- Añadir notas de las llamadas a un Contact u otro registro.
Requisitos previos
- Una cuenta de Zoho CRM y acceso a la API Console de Zoho para crear un cliente OAuth.
- Saber en qué centro de datos está su cuenta:
com,eu,in,com.au,jpoca. Forma parte de la dirección web de su Zoho.
Configuración de la cuenta externa (en Zoho)
Zoho controla estas pantallas. La guía de Zoho: OAuth overview.
- En la API Console de Zoho (la de su centro de datos), cree un cliente basado en servidor.
- Fije el URI de redireccionamiento (autorizado) en el que aparece en el cuadro Connect de Phynxa.
- Copie el Client ID y el Client secret.
Conéctelo en Phynxa
- Integrations, Connect en Zoho CRM.
- Escriba el Client ID, el Client secret y el Data centre.
- Continúe hasta Zoho y apruebe. La tarjeta muestra Connected.
Permisos y ajustes
| Scope | Para qué |
|---|---|
ZohoCRM.modules.ALL | Leer y escribir registros en los módulos |
ZohoCRM.settings.ALL | Leer los ajustes de los módulos |
ZohoCRM.users.READ | Leer usuarios |
Phynxa firma las solicitudes con Zoho-oauthtoken (no Bearer) y usa el dominio de API que Zoho devuelve para su centro de datos. Un token de acceso de Zoho dura una hora y Phynxa lo renueva.
Úselo en una llamada
| Acción | Qué hace | Se ejecuta |
|---|---|---|
| Create lead | Crea un Lead. Si falta el apellido o la empresa, se rellena con «Unknown». | En segundo plano |
| Add note | Añade una nota; si se le da un contact id, queda asociada a ese Contact. | En segundo plano |
| Fetch customer history | Enumera las notas de un registro. Necesita un contact id; con solo un correo devuelve «A contact_id is needed.» | Espera |
| Update contact | Cambia el nombre, el correo, el teléfono o la empresa de un contacto; solo se cambia lo que indique. Necesita el id del contacto de una consulta de historial. | En segundo plano |
| Create task | Crea una tarea de seguimiento para su equipo (subject, y opcionales body y due_date como 2026-11-02), vinculada a un contacto si indica su id. | En segundo plano |
| Create ticket | Abre un caso de soporte con un subject y un body opcional, vinculado a un contacto si indica su id. | En segundo plano |
Pruébelo
Test connection y después pida a un agente en Chat que guarde un cliente potencial y revise el módulo Leads en Zoho.
Resultado esperado
El Lead aparece en Zoho CRM y la tarjeta cuenta un éxito.
Solución de problemas
- invalid_client o redireccionamiento erróneo. El URI de redireccionamiento debe coincidir, y el cliente debe crearse en el mismo centro de datos que su cuenta.
- Todo falla tras conectar. El Data centre de Phynxa no es el de su cuenta. Use Edit credentials y corríjalo.
- El historial devuelve un error sobre un id. El historial de Zoho necesita un id que el agente no suele tener; use Create lead y Add note con Zoho.
Seguridad y credenciales
El client secret se almacena cifrado. Remove lo elimina; revoque el cliente en la API Console si deja de usarlo.
Guías relacionadas
¿Algo de esto no coincide con lo que ve en el panel? Avísenos.