¿Qué puede hacer la API REST de Deskwoot?

La API REST de Deskwoot te da acceso por código a tus datos de soporte. Así puedes leer y crear conversaciones, gestionar contactos, enviar y obtener mensajes, y conectar Deskwoot con tus propias herramientas y scripts. Es una función de Enterprise, y cada solicitud se autentica con un token que creas en Configuración > Tokens de API.

¿Qué puedes hacer con la API?

La API REST cubre los elementos con los que trabajas todos los días en tu helpdesk. Con los permisos adecuados en el token puedes:

• Conversaciones: listar, leer, crear y actualizar conversaciones, y cambiar su estado o asignación.
• Mensajes: obtener los mensajes de una conversación y publicar nuevas respuestas o notas privadas.
• Contactos: leer, crear y actualizar a las personas que te escriben, incluidos sus atributos.
• Tickets: crear un ticket a partir de los mensajes de una conversación, leer y cambiar tickets, responder al cliente desde un ticket en la conversación de la que salió, resolver un chat y guardarlo como ticket, y listar las categorías de tickets. Los tickets vienen con Enterprise; un administrador puede desactivarlos en Configuración > Tickets. Las listas, los conteos y los informes dejan fuera los tickets a menos que los pidas con type, así que las integraciones que creaste antes de los tickets no notan ningún cambio.
• Informes: cada número de la página Informes (volumen, tiempos de primera respuesta y de resolución, CSAT) por agente, equipo, bandeja de entrada, canal, etiqueta, estado, prioridad, día o semana, con filtros que puedes combinar y cualquier rango de fechas, además de cada conversación y cada respuesta CSAT como filas o en CSV.

Por eso la API encaja bien para sincronizar tickets con un sistema interno, crear un panel a tu medida, automatizar actualizaciones de rutina o enviar datos de conversaciones a otra herramienta.

¿Qué plan incluye la API REST?

La API REST es una función de Enterprise, y los tokens de API solo se pueden crear con un plan Enterprise de pago. La prueba gratis de 7 días con la que empieza cada cuenta nueva no incluye tokens de API, así que la API REST no funciona durante la prueba. Si tienes un plan inferior y necesitas acceso a la API, tendrás que pasarte a Enterprise.

¿Cómo obtengo un token?

Los tokens se crean y se gestionan en Configuración > Tokens de API. Dale a cada token un nombre claro, concede solo los permisos que necesita la integración y cópialo en cuanto se genere, porque es posible que el valor completo no se vuelva a mostrar. Consulta la guía de tokens de API para ver todos los pasos, incluida la URL base y cómo enviar el token en el encabezado de autorización.

¿Y si quiero un agente de IA en lugar de escribir código?

Si lo que buscas es que un agente de IA externo maneje el helpdesk en vez de escribir tu propia integración, el servidor MCP puede encajar mejor. Ofrece un conjunto definido de herramientas a un agente que habla MCP, a través de un token de bot con permisos limitados. Igual que la API REST, es una función de Enterprise. Durante la prueba gratis de 7 días un agente puede conectarse, pero solo responde whoami; todas las demás herramientas necesitan un plan Enterprise de pago.

Preguntas frecuentes