La API de tickets de Zenvia Customer Cloud permite acceder a los datos de los tickets generados en tu operación de forma automatizada. Con ella, puedes consultar información sobre las atenciones de soporte, como estado, fechas, canal de origen, agente responsable, entre otros detalles.
En este artículo, conoce los principales conceptos, cómo funciona la estructura de los tickets y cómo utilizar la API de consulta.
📄 Documentación técnica de la API |
Funcionalidades disponibles
Con la API de consulta de tickets, puedes:
- Listar tickets: Consulta todos los tickets según filtros como estado, fecha, canal, agente, entre otros.
- Buscar ticket específico: Consulta los detalles completos de un ticket a partir de su identificador (ID).
- Obtener datos operativos: Utiliza la información de los tickets para reportes, análisis o integración con otros sistemas.
💡 Consejo: Utiliza esta API para consultar tickets existentes e integrar esta información a tus propios sistemas, como dashboards, CRMs o herramientas internas de análisis.
Autenticación
El acceso a la API se realiza mediante un Token de autenticación, garantizando la seguridad en las consultas.
Si aún no tienes un token, consulta nuestro artículo: Tokens y webhooks para usar en las APIs.
Principales conceptos
Antes de comenzar a utilizar la API de tickets, es importante entender algunos conceptos que forman parte del funcionamiento de los tickets en Zenvia Customer Cloud.
Concepto | Descripción |
Ticket | Registro de una atención, con datos como cliente, canal, estado e interacciones. |
ID del Ticket | Identificador único del ticket, utilizado para consultar detalles específicos vía API. |
Estado | Fase en la que se encuentra el ticket (Abierto, En progreso, Resuelto, etc.). |
Canal | Origen de la interacción (Chat, Correo electrónico o Agente). |
Atributos | Datos asociados al ticket, como nombre del cliente, categoría, prioridad y agente. |
¿Cuándo utilizar esta API?
- Para generar reportes personalizados de tickets.
- Para realizar el seguimiento de atenciones en tiempo real desde tus propios sistemas.
- Para cruzar datos de atención con otros sistemas internos (CRM, ERP, BI, etc.).
- Para monitoreo de tickets y seguimiento de métricas operativas.