Recuperar notas en Zoho CRM puede hacerse a través de la interfaz de usuario en registros individuales o de forma programática mediante la API REST de Zoho CRM, según tu caso de uso. Aquí en Beam Help — soporte experto independiente para Zoho, no soporte oficial de Zoho — te explicamos ambos enfoques a continuación.
Por qué esto es importante
Las notas son una de las formas más prácticas de hacer seguimiento del progreso de una venta o interacción con el cliente, ofreciendo a cada miembro del equipo un resumen actualizado de lo que ha ocurrido en un registro. [2] Ya sea que necesites extraer notas para informes, auditorías o mostrarlas en un widget personalizado, conocer el método de recuperación correcto ahorra mucho tiempo. Si estás construyendo una integración o automatización, es especialmente importante entender bien la ruta de la API.
Paso a paso
Paso 1. Comprende qué son las Notas en Zoho CRM.
Las notas actúan como una capa de resumen sobre los registros de CRM, permitiendo a los representantes de ventas documentar observaciones sobre las interacciones con clientes y prospectos, de modo que el progreso del negocio siempre sea visible para el equipo. [8] Pueden adjuntarse a módulos estándar como Leads, Contacts, Accounts y Deals.
Paso 2. Recupera notas a través de la interfaz de usuario de Zoho CRM.
Abre cualquier registro en Zoho CRM (por ejemplo, un Contact o Account). Desplázate hacia abajo hasta la sección de listas relacionadas de la página de detalle del registro, donde una pestaña o panel de Notes mostrará todas las notas asociadas a ese registro. [1] Puedes hacer clic en cualquier nota individual para leer su contenido completo.
Paso 3. Usa el endpoint de la API de Notes para recuperar notas de forma programática.
Zoho CRM expone un módulo Notes dedicado a través de su API REST. Para obtener notas, llamas al endpoint estándar Get Records, apuntando al módulo Notes:
GET https://www.zohoapis.com/crm/v8/NotesIncluye tu token OAuth en el encabezado Authorization como Zoho-oauthtoken <your_token>. [6]
Paso 4. Autentícate con el scope OAuth correcto.
La recuperación del módulo Notes requiere acceso de nivel administrador. Si un usuario no administrador intenta llamar al endpoint del módulo Notes, la API devuelve un error HTTP 403 NOT_SUPPORTED, lo que indica que solo los usuarios administradores tienen permiso para obtener registros del módulo Notes. [6] Asegúrate de que el token OAuth que estás usando pertenezca a un usuario administrador o haya sido generado en su nombre.
Paso 5. Gestiona la paginación con page_token para conjuntos de resultados grandes.
Cuando el número de notas es grande, la respuesta de la API incluirá un valor page_token. Pasa este token como parámetro de consulta en tu siguiente solicitud para recuperar la página siguiente de resultados. [6] Por ejemplo:
GET https://www.zohoapis.com/crm/v8/Notes?page_token=<token_value>Continúa iterando hasta que no se devuelva ningún page_token adicional, lo que indica que has llegado a la última página.
Paso 6. Filtra notas por registro padre si es necesario.
Si solo quieres las notas pertenecientes a un registro específico (por ejemplo, un Lead o Contact en particular), usa la API COQL para escribir una consulta dirigida contra el módulo Notes, filtrando por el ID del registro padre. [2] Esto evita extraer todas las notas de todo el CRM y mantiene tus llamadas a la API eficientes.
Paso 7. Visualiza notas a través de la extensión Zoho FSM (si aplica).
Si tu organización usa la extensión Zoho FSM dentro de Zoho Desk, las notas en registros de CRM vinculados también pueden mostrarse allí. Navega a un registro de Contact o Account, haz clic en la pestaña Zoho FSM, pasa el cursor sobre un Request, Estimate, Work Order, Service Appointment o Asset vinculado, y haz clic en el ícono View Notes. Serás llevado directamente a la pestaña Notes de ese registro. [1]
Errores comunes
- Error 403 NOT_SUPPORTED: Este es el problema más frecuente al recuperar notas mediante la API. Ocurre cuando el token OAuth en uso no pertenece a un usuario administrador. Verifica el rol del usuario y regenera el token con credenciales de administrador. [6]
- Notas visibles en escritorio pero no en móvil/tablet: Existen inconsistencias de visualización conocidas donde las listas relacionadas de Notes y Attachments se muestran correctamente en el navegador de escritorio, pero pueden no renderizarse como se espera en las versiones para tablet o móvil de Zoho CRM. [5] Si tu equipo depende del acceso móvil, prueba la visibilidad de las Notes en cada tipo de dispositivo.
- Paginación no gestionada: Si solo realizas una única llamada a la API sin verificar si hay un
page_tokenen la respuesta, podrías perder silenciosamente una gran parte de tus datos de notas. Comprueba siempre los metadatos de la respuesta en busca de tokens de paginación. [6]
Qué verificar
- Confirma que el token OAuth utilizado para las llamadas a la API pertenezca a un usuario administrador, ya que los tokens de no administradores serán rechazados con un error 403 al consultar el módulo Notes. [6]
- Verifica que la lista relacionada Notes esté habilitada y visible en el diseño del módulo para los registros que estás inspeccionando en la interfaz de usuario. [5]
- Si usas paginación, asegúrate de que tu código recorra todos los valores de
page_tokenhasta alcanzar la página final, para que no se omita ninguna nota de tus resultados. [6]