Notas de la versión
Aumento del límite mínimo de uso de la API
Aumentamos el límite mínimo de la API en todas las ediciones para mejorar su experiencia de uso de la API.
Edición de Zoho CRM | Solicitudes de la API - Límite superior |
Edición gratuita | 1000 solicitudes al día por organización |
Edición estándar |
|
Edición profesional |
|
Edición empresarial |
|
Consulte los Límites de la API para obtener más información acerca de este cambio.
Publicado el 1 de noviembre del 2014
Nuevo método: searchRecords
Introdujimos el método searchRecords para ayudarlo a buscar los registros de los módulos. Consulte la Guía de la API para obtener más información sobre este nuevo método.
Publicado el 20 de octubre del 2014
Nuevos métodos: getModules y getDeletedRecordIds
Introdujimos los siguientes métodos para ayudarlo a recuperar la lista de los módulos de CRM y los ID de registros eliminados de la papelera de reciclaje:
Consulte nuestra Guía de la API para obtener más información acerca de estos nuevos métodos.
Publicado el 7 de agosto del 2014
Cantidad de solicitudes de la API
La API de Zoho CRM está disponible en todas las ediciones de Zoho CRM. Para usar la API, necesitará el token de autenticación de su cuenta de Zoho CRM. Asegúrese de contar con el permiso para acceder al servicio de la API. Si no cuenta con el permiso, comuníquese con el administrador de su CRM.
Límite de la API
Edición de Zoho CRM | Solicitudes de la API - Límite superior |
Edición gratuita | 250 solicitudes al día por organización |
Edición estándar | Mínimo: 1000 solicitudes al día Máximo: 5000 solicitudes al día por organización o 250 solicitudes o licencias de usuario, la cantidad que sea inferior |
Edición profesional | Mínimo: 2000 solicitudes al día Máximo: 10 000 solicitudes al día por organización o 250 solicitudes o licencias de usuario, la cantidad que sea inferior |
Edición empresarial | Mínimo: 3000 solicitudes al día Máximo: 25 000 solicitudes al día por organización o 500 solicitudes o licencias de usuario, la cantidad que sea inferior |
Notas importantes:
- Por ejemplo, en la edición gratuita, si utiliza el método getRecords, puede obtener un máximo de 200 registros por solicitud, a su vez, un total de 50 000 registros diarios (250 x 200 = 50 000 registros).
- Si utiliza los métodos getSearchRecords o getCVRecords, puede enviar un máximo de 250 llamadas al día, independientemente de su edición de Zoho CRM.
Publicado el 15 de junio del 2013
Nuevos métodos: adjunte archivos o fotos a registros utilizando la API para desarrolladores
Introdujimos los siguientes métodos que lo ayudan a adjuntar archivos o fotos a los registros:
- uploadFile
- downloadFile
- deleteFile
- uploadPhoto
- downloadPhoto
- deletePhoto
Puede leer el anuncio completo en nuestros Foros de la API para desarrolladores.
Consulte nuestra Guía de la API para obtener más información acerca de estos nuevos métodos.
Publicado el 11 de julio del 2012
Introducción del token de autenticación
Ahora admitimos el token de autenticación en nuestra implementación de la API para desarrolladores.
Se trata de un token permanente que solo dejará de ser válido si lo elimina.
Aprenda más sobre el token de autenticación en nuestra Guía de la API.
Publicado el 5 de marzo del 2012
Introducción de nuevos métodos
Introdujimos los siguientes métodos en nuestra API para desarrolladores:
- getFields
- getRelatedRecords
- updateRelatedRecords
Método de la API | Finalidad |
getFields | Para obtener todos los detalles de los campos disponibles en un módulo en particular. |
getRelatedRecords | Para obtener los registros relacionados con otro registro (registro primario). . |
updateRelatedRecords | Para actualizar los registros relacionados con otro registro. |
Puede leer el anuncio completo en nuestros Foros de la API para desarrolladores. Consulte nuestra Guía de la API para obtener más información acerca de estos nuevos métodos.
Publicado el 27 de enero del 2012
Solo se admite HTTPS desde el 28 de abril del 2011:
En la actualidad, admitimos tanto HTTP como HTTPS durante la implementación de nuestra API para desarrolladores. En un plazo de cuatro semanas, planeamos admitir todas las transacciones de la API solo a través de HTTPS y descontinuar permanentemente el protocolo HTTP. Este sistema de seguridad adicional SSL de 256 bits lo ayudará a proteger la integración de terceros de los problemas de seguridad durante la transferencia de datos.
A partir del 28 de abril del 2011, si sigue usando el protocolo HTTP en su programa, las solicitudes de API no se ejecutarán. Por lo tanto, recomendamos encarecidamente que nuestra comunidad de desarrolladores solo llame a la API de Zoho CRM por medio de solicitudes de HTTPS, y que comience hacerlo lo antes posible.
Introducción de un nuevo parámetro llamado '"version"
Introdujimos un nuevo parámetro llamado "version" para los métodos de la API para desarrolladores. Puede obtener los valores del campo "Fuente de campaña" con este parámetro.
En una reciente mejora del módulo de campañas, se quitó el campo Fuente de campaña para respaldar la función de los miembros de la campaña. Después de esta mejora:
- Puede asociar varios clientes potenciales y contactos a una campaña.
- Puede ahorrar tiempo mediante la importación de varios clientes potenciales o contactos, en lugar de asociarlos uno por uno.
- El campo Fuente de campaña no estará disponible en el módulo de clientes potenciales y contactos.
Obtenga más información sobre esta mejora en nuestra Guía de transición.
¿Cómo se utiliza el parámetro "version" en solicitudes de la API?
Puede utilizar el parámetro "version" en métodos para obtener los valores del campo Fuente de campaña en la implementación de la API.
El parámetro "version" con el valor "1" también buscará respuestas del campo "Fuente de campaña".
El parámetro "version" con el valor "2" buscará las respuestas en función de la implementación de la API actual. En este caso, no se buscarán los valores del campo "Fuente de campaña".
Este no es un parámetro obligatorio. Hasta el 30 de octubre del 2011, todas las respuestas se obtendrán en función de la implementación anterior, es decir, antes de la mejora. Durante este período, si desea obtener respuestas en función de la nueva implementación, puede utilizar el parámetro "version" en sus solicitudes con un valor de "2", es decir, version=2.
Nota:
- Este no es un parámetro obligatorio.
- Hasta el 30 de octubre del 2011, todas las respuestas se obtendrán en función de la implementación anterior, es decir, antes de la mejora. Durante este período, si desea obtener respuestas en función de la nueva implementación, puede utilizar el parámetro "version" en sus solicitudes con un valor de "2", es decir, version=2.
- Después del 30 de octubre del 2011, se suspenderá el soporte para la versión 1 y solo será compatible con la versión 2.
Este es un ejemplo sobre el uso del parámetro "version".
También introdujimos un nuevo método de la API llamado getRelatedRecords. Puede buscar registros (clientes potenciales, contactos, etc.) relacionados con un registro en otro módulo.
Por ejemplo, puede buscar clientes potenciales o contactos relacionados con una campaña determinada. Más información
Publicado el 17 de abril del 2011
Publicación de disponibilidad general de la API para desarrolladores de Zoho CRM y otros cambios
Nos complace anunciar el lanzamiento de la disponibilidad general de la API del servicio Zoho CRM. Nuestra API está disponible en formatos XML y JSON, por lo que la comunidad de desarrolladores puede crear aplicaciones mediante su lenguaje de programación favorito. Ahora contamos con métodos de API mucho más sólidos y mejores para satisfacer las necesidades de la implementación en tiempo real. Su valiosa contribución en la identificación de errores, la creación de nuevas situaciones de negocios y la publicación de ejemplos realmente nos ayudó a idear una mejor API para nuestro sistema de CRM. Además del lanzamiento de la disponibilidad general, también estamos haciendo algunos cambios importantes en nuestra implementación de la API existente, lo que nos permite cumplir con las necesidades futuras de nuestra comunidad de desarrolladores. Algunos de estos cambios incluyen la depreciación de los métodos de búsqueda, un nuevo formato de respuesta, la restricción de las solicitudes de la API y los nuevos métodos de la API para implementar una nueva lógica de negocios de CRM. Creemos sinceramente que estos cambios nos ayudarán enormemente a proporcionar una mejor experiencia a la comunidad de desarrolladores y a llevar la plataforma para desarrolladores Zoho CRM al siguiente nivel.
Cambios importantes
- La depreciación de los actuales métodos de búsqueda: getAllSearchRecords y getMySearchRecords
- La implementación del nuevo formato de respuesta de todos los métodos
- La restricción de las solicitudes de la API según la edición de Zoho CRM
- Introducción de nuevos métodos para las funciones de búsqueda, conversión de clientes potenciales y eliminación
Depreciación de la API
Enfocados en el futuro crecimiento de la comunidad, entregar un mejor servicio de desarrollo y optimizar las operaciones de alto rendimiento, retiraremos los siguientes métodos de la API:
- getAllSearchRecords
- getMySearchRecords
Método de la API | Finalidad |
getAllSearchRecords | Se usa para capturar todos los datos relacionados con la palabra de búsqueda especificada, independientemente de a quién pertenezcan. |
getMySearchRecords | Se usa para capturar los datos que pertenecen al nombre de inicio de sesión relacionado con la palabra de búsqueda especificada en la solicitud. |
getAllRecords | El nombre se cambió a getRecords |
getEntityRecord | El nombre se cambió a getRecordById |
Últimamente, estamos encontrando un gran porcentaje de uso de recursos durante la implementación de los métodos getMySearchRecords y getAllSearchRecords. Este porcentaje es mucho mayor que el esperado. Para superar este tipo de situación, introduciremos nuevos métodos de búsqueda, getSearchRecords y getSearchRecordsByPDC, los que tienen un propósito similar. Optimizamos estos nuevos métodos para obtener un mejor rendimiento.
Fin de vida útil: 21 de enero del 2010
Nota:
- Desde el 21 de enero del 2010 (12:00 a. m. PST), estos métodos dejarán de funcionar, y si todavía los utiliza, el sistema mostrará el siguiente mensaje de error en su aplicación:
<response> No se pudo procesar su solicitud. Compruebe que ingresó el nombre de un método apropiado, así como los parámetros y los valores de parámetro adecuados
</response>
Nota importante:
Antes del fin de la vida útil, se recomienda encarecidamente que actualice su aplicación con los nuevos métodos de búsqueda: getSearchRecords o getSearchRecordsByPDC. Para solicitar ayuda o aclaraciones, escríbanos a la dirección support@zohocrm.com
Para obtener más detalles acerca de los métodos obsoletos, consulte nuestra Guía de la API
Nuevo formato de respuesta
En la actualidad, el formato XML de la respuesta de la API es < fieldlabel value = "LEADID" > Field Value </ fieldlabel>, que contiene alrededor de 26 caracteres (incluidos espacios) en las etiquetas de apertura y cierre. En nuestra nueva implementación, acortamos el tamaño de las etiquetas cambiando las XML a <FL val="LEADID"> Field Value </FL>, que contiene un total de 8 caracteres, lo que permite ahorrar aproximadamente 18 bytes por campo. Esto es de mucha utilidad para optimizar el uso del ancho de banda.
Hasta el 21 de enero del 2010, de forma predeterminada, obtendrá la respuesta en el formato antiguo. Si desea recibir la respuesta en el nuevo formato, debe ingresar el argumento adicional con newFormat=1 o 2 en la solicitud de la API para capturar los datos desde Zoho CRM.
Nota importante:
Tenga en cuenta que debe utilizar los datos XML del parámetro newFormat=1 para ingresar o actualizar los registros.
Parámetro | Finalidad |
newFormat=1 | Para excluir los campos con valores "null" cuando capture los datos de su cuenta de CRM. |
newFormat=2 | Para incluir los campos con valores "null" cuando capture los datos de su cuenta de CRM. |
Formato antiguo:
En este ejemplo, todos los campos se capturan a pesar de la presencia de valores "null" en el registro. Si tiene 150 campos en un módulo, tendremos que capturar los datos de todos los campos, lo que exigirá el uso innecesario de ancho de banda. Nuevo formato:
En este ejemplo, no capturamos los campos que contienen valores "null" ingresando el parámetro newFormat=1. Puntos clave:
- Se cambió la etiqueta XML de <fieldlable value=""> field value </fieldlable> a <FL val=""> field value <FL>
- Puede detener la captura de los registros con valores "null" ingresando el parámetro newFormat=1 en la solicitud de la API. Si desea capturar los datos de todos los campos (incluidos los valores null), utilice el parámetro newFormat=2.
Nuevo formato de respuesta: disponible desde el 22 de octubre del 2009
Fin de la vida útil del antiguo formato de respuesta: 21 de enero del 2010
Cantidad de solicitudes de la API
Para un mejor rendimiento y servicio para desarrolladores, limitaremos el número de solicitudes a la API, como se indica a continuación:
Edición de Zoho CRM | Solicitudes de la API - Límite superior |
Edición gratuita: 3 usuarios gratis | 250 llamadas al día por organización |
Edición profesional: USD 12 al mes por usuario | 250 llamadas al día por licencia de usuario O |
Edición estándar: USD 20 al mes por usuario | 250 llamadas al día por licencia de usuario O |
Edición empresarial: USD 35 al mes por usuario | 500 llamadas al día por licencia de usuario O Máx.: 25000 llamadas al día por organización, Mín.: 3000 llamadas al día por organización |
Por ejemplo, en la Edición gratuita, si utiliza el método getSearchRecords, puede capturar un máximo de 200 registros por solicitud, es decir, un total de 50 000 registros diarios (250 x 200 = 50 000 registros).
Nota:
- Si utiliza los métodos getSearchRecords o getCVRecords, puede enviar un máximo de 250 llamadas al día, independientemente de su edición de Zoho CRM.
Nota importante:
Las restricciones mencionadas anteriormente se pueden aplicar a todos los usuarios nuevos y existentes. En el futuro, planeamos notificar al administrador de CRM (superadministrador de la cuenta de Zoho CRM) si su organización excede el límite mencionado. También proporcionaremos estadísticas de la API para una mejor evaluación de sus necesidades de integración.
Fecha de implementación: 21 de enero del 2010
Desde el 21 de enero del 2010 (12:00 a. m. PST), puede solicitar llamadas a la API de acuerdo con las características de su edición de Zoho CRM. En el caso de que su aplicación requiera más que el límite máximo, las solicitudes adicionales a la API no se procesarán. Para evitar problemas en la transferencia de datos, evalúe sus necesidades en relación con la API con suficiente antelación. Si necesita ayuda, comuníquese con nuestro equipo de soporte a support@zohocrm.com o llámenos por teléfono al +1 888 900 9646
Nuevos métodos de la API
Nos complace presentar los siguientes nuevos métodos que beneficiarán a una creciente comunidad de desarrolladores:
- getSearchRecords
- getSearchRecordsByPDC
- deleteRecords
- convertLead
Método de la API | Finalidad |
getSearchRecords | Para capturar todos los datos de los usuarios especificados en la solicitud de la API. |
getSearchRecordsByPDC | Para buscar los valores de acuerdo con las columnas predefinidas de manera predeterminada de las entidades de Zoho CRM. |
deleteRecords | Para eliminar un registro ingresando su ID. |
convertLead | Para convertir un cliente potencial en una cuenta, un contacto y un candidato. |
Estamos seguros de que los métodos mencionados anteriormente serán muy útiles en la ejecución de funciones de búsqueda y de que lo ayudarán a desarrollar una nueva lógica empresarial a través de nuestra API. Estos métodos estarán disponibles para todas las ediciones de forma inmediata.
Disponible desde: 22 de octubre del 2009
Para obtener más información sobre los nuevos métodos de la API, consulte la Guía de la API
Otros cambios
Además, incorporaremos estos pequeños cambios:
- Captura de un máximo de 200 registros por solicitud de API
- Nuevo formato de respuesta que se puede aplicar a todos los métodos de la API (tanto existentes como nuevos)
- Captura de registros con los campos especificados utilizando el parámetro selectColumns
- También actualizamos la Guía de la API y lanzamos los Foros oficiales de desarrolladores