Una función personalizada de Deluge que intenta listar plantillas de combinación de correspondencia devuelve un error de ámbitos o acceso cuando la conexión Deluge o el token OAuth no incluyen el ámbito "settings" de CRM necesario para leer plantillas almacenadas en Configuración, o cuando el usuario de la conexión carece de permisos de plantilla. Esto impide que Deluge llame al punto final de configuración de CRM que expone las plantillas de combinación de correspondencia.
Qué significa — explicación concreta ligada a la superficie de la API de Zoho
Las plantillas de combinación de correspondencia se exponen a través de la API de Configuración de CRM en lugar de una API de módulo regular, por lo que las llamadas de Deluge que leen plantillas acceden al punto final de Configuración y requieren ámbitos OAuth de nivel de configuración (por ejemplo, ZohoCRM.settings.ALL). Si el token de su conexión Deluge carece de ese ámbito, la API devuelve un error de ámbito OAuth o de permiso cuando intenta listar plantillas de combinación de correspondencia a través de una función personalizada [8][1].
Causas comunes
- La conexión Deluge o el token OAuth no incluyen el ámbito de configuración de CRM (por ejemplo, ZohoCRM.settings.ALL), por lo que el punto final de Configuración rechaza la llamada [8].
- La conexión fue creada por un usuario que carece de derechos "Administrar Plantillas" o derechos administrativos, por lo que las plantillas en Configuración no son visibles para ese token [8].
- Utilizó solo ámbitos granulares de combinación de correspondencia o de módulo, pero no el ámbito de configuración más amplio; los ámbitos granulares no siempre cubren los puntos finales de Configuración [8][1].
- Los límites a nivel de plantilla o el contenido de plantilla mal formado causan errores relacionados con plantillas al listar o usar plantillas (errores de plantilla separados se documentan en la ayuda de CRM) [7].
Cómo solucionarlo
- Identifique la conexión que utiliza su función personalizada. Abra la función Deluge en CRM y anote el nombre de "conexión" al que hace referencia.
- Revoque y reautorice esa conexión con un ámbito de configuración. En la configuración de su conexión (la conexión utilizada por la función personalizada o su cliente OAuth autoconstruido), agregue ZohoCRM.settings.ALL (o el ámbito de configuración mínimo que requiere su aplicación) y vuelva a otorgar el consentimiento. Si utiliza un cliente OAuth personalizado, incluya el ámbito de configuración en la lista de ámbitos y solicite un nuevo token de acceso. Este paso soluciona OAUTHSCOPEMISMATCH al llamar a los puntos finales de Configuración [8].
- Confirme que el usuario de la conexión tiene permisos de plantilla. Recree/reautorice la conexión utilizando un administrador o un usuario que pueda Administrar Plantillas en CRM para que el token pueda ver los recursos de Configuración [8].
- Pruebe con una llamada API mínima desde Deluge. Ejecute una función pequeña que acceda al punto final de plantillas de Configuración y registre el código de estado y el cuerpo de la respuesta HTTP para confirmar el éxito. Si aún obtiene 403/401, inspeccione los ámbitos del token devueltos por la introspección del token o reautorice nuevamente.
- Si la lista tiene éxito pero plantillas específicas fallan, verifique el contenido y los límites de la plantilla (recuento de caracteres, formato de tabla de productos). Corrija o recree plantillas que excedan los límites conocidos o contengan HTML incorrecto, como se documenta en la solución de problemas de plantillas de CRM [7].
Cuándo escalar
Si ha reautorizado con ZohoCRM.settings.ALL y ha verificado que el usuario de la conexión tiene permisos de administrador/plantilla, pero aún recibe errores de ámbito o 403, escale al Soporte de Zoho con la conexión