Qué expone la API
Qué expone la API de Zoho Desk: tickets, mensajes, adjuntos y eventos
Zoho Desk expone una API REST con OAuth 2.0: la app pide solo los scopes que necesita (tickets, contactos, búsqueda, eventos, mensajería) y el token queda atado a una organización. La base URL depende del centro de datos de tu cuenta, de desk.zoho.com en Estados Unidos a desk.zoho.eu en Europa, y Zoho indica tomarla de la respuesta del token en vez de fijarla a mano (API de Zoho Desk).
El uso se mide en créditos diarios, según la edición y la cantidad de usuarios, y en llamadas simultáneas: la edición Professional parte de 75.000 créditos por día más 500 por usuario, con hasta 15 llamadas al mismo tiempo, y leer un registro consume un crédito, según esa documentación. Para el tiempo real están los webhooks, que Zoho Desk incluye en las ediciones Professional, Enterprise y Ultimate: avisan tickets nuevos, cambios, hilos, adjuntos y mensajes de WhatsApp, llegan firmados con un JWT y la URL que los recibe tiene que contestar dentro de los 5 segundos (webhooks de Zoho Desk).
Los adjuntos también viajan por la API: el aviso de un hilo nuevo incluye sus archivos y la API lista los adjuntos de cada ticket. Con eso, Arconte lee la factura, la orden de compra o el remito, valida los datos contra tu ERP y deja el resultado como comentario privado en el ticket, para que tu equipo lo vea sin abrir el archivo.
| Superficie | Qué hace el agente | Lo que conviene saber |
|---|
| API de tickets y contactos | Crea, actualiza y busca tickets; lee el contacto y la cuenta | Scopes por módulo y créditos diarios por edición |
| API de mensajería | Toma la conversación de WhatsApp, responde y la asigna a una persona | Solo responde conversaciones asignadas a su usuario |
| Webhooks | Se entera de tickets, cambios, hilos, adjuntos y mensajes | En Professional, Enterprise y Ultimate; firma JWT; respuesta en 5 segundos |
| Comentarios y adjuntos | Lee los archivos del ticket y deja comentarios privados | El comentario se marca público o privado al crearlo |
Según la documentación de Zoho Desk; los límites dependen de tu edición y de tus usuarios.
Sobre los límites de la API: los créditos se renuevan cada 24 horas y los que no se usan vencen; si hacen falta más, Zoho permite comprarlos. En las ediciones sin webhooks, los cambios se toman consultando la API, y el volumen del agente se dimensiona con tu equipo.