La API de Updesk para integraciones
Cómo conectar otro sistema a tu mesa: qué permite la API, cómo se crea una llave, qué alcance tiene y cómo cuidarla.
La API permite que otro sistema trabaje con tu mesa sin pasar por la pantalla: un monitoreo que abre un ticket cuando salta una alerta, un asistente telefónico que registra la llamada o el sistema de un cliente que reporta sus incidencias. La referencia completa, con todos los endpoints y ejemplos, está en la referencia de la API.
Qué permite
- Consultar lo que acepta la mesa: estados, tipos, prioridades, categorías, equipos, campos y el catálogo de servicios.
- Crear tickets, también a nombre de un solicitante que solo tiene teléfono.
- Consultar un ticket y buscar por teléfono o por la referencia del sistema externo.
- Dejar notas internas, responder al cliente y adjuntar archivos.
- Cambiar el estado, la prioridad y los campos de un ticket, y escalarlo a la cola de otro equipo.
- Buscar contactos y empresas.
- Ponerse al día con los tickets que cambiaron desde la última consulta.
Lo que ninguna llave puede hacer
Ninguna llave puede asignarle un ticket a una persona ni borrarlo. Quién atiende un ticket lo deciden las personas de la mesa.
Crear una llave
- 1Entra a Llaves de API, en Configuración.
- 2Pulsa Nueva llave y ponle un Nombre que identifique al sistema que la va a usar, por ejemplo «Asistente telefónico».
- 3En Acotar a una empresa, deja toda la mesa o elige una empresa. Si la acotas, la llave solo ve y crea tickets de esa empresa, sin importar lo que pida.
- 4Ajusta Llamadas/min (60 por defecto, hasta 600) y Vence en (días) (365 por defecto; si lo dejas vacío, no vence).
- 5En Qué puede hacer, marca solo los permisos que ese sistema necesita.
- 6Pulsa Crear llave, cópiala con Copiar y guárdala en un lugar seguro. Después pulsa Ya la guardé.
La llave se muestra una sola vez
Updesk no la guarda legible y no hay forma de recuperarla. En la lista queda solo su comienzo, para reconocerla. Si se pierde, revócala y crea otra.
Los permisos
| Permiso | Qué permite | Marcado al crear |
|---|---|---|
| Leer el catálogo | Ver los servicios y los valores válidos de la mesa. | Sí |
| Crear tickets | Registrar tickets nuevos. | Sí |
| Dejar notas internas | Escribir notas que lee un agente, no el cliente. | Sí |
| Leer tickets | Consultar el estado y buscar por teléfono o referencia. | No |
| Adjuntar archivos | Subir archivos a un ticket. | No |
| Responder al cliente | Escribirle al solicitante: el texto le llega por correo. | No |
| Modificar tickets | Cambiar estado y prioridad. Incluye poder cerrar. | No |
| Escalar tickets | Pasar un ticket a la cola de otro equipo, con un motivo. | No |
| Leer contactos | Buscar personas y empresas. Muestra teléfonos y correos. | No |
Los cuatro últimos van marcados con un aviso en la pantalla: le escriben al cliente, pueden cerrar o mover tickets, o muestran datos de contacto. Actívalos solo cuando la integración de verdad lo necesite.
Cómo se autentica
Cada llamada lleva la llave en el encabezado Authorization, con la forma Bearer seguida de la llave, que siempre empieza con usk_live_. No hay usuario ni contraseña. La mesa y la empresa salen de la llave, nunca de lo que envía el sistema.
- Sin llave o con una llave que no existe, la API responde 401.
- Si la llave existe pero no tiene el permiso, venció o fue revocada, responde 403.
- Si se pasa del límite de llamadas por minuto, responde 429 e indica cuántos segundos esperar.
Todo lo que hace una llave queda en el Historial del ticket con el nombre de la llave, así que siempre se puede saber qué integración hizo cada cambio.
Cuidados de seguridad
- No compartas la llave por correo ni por chat, y no la dejes escrita en documentos compartidos. Quien la tenga puede actuar sobre tu mesa con los permisos que le diste.
- Crea una llave por sistema, con un nombre que se reconozca. Así puedes revocar una sin cortar las demás.
- Si es el sistema de un cliente, acótala a su empresa.
- Dale solo los permisos necesarios. Para una integración automática, prefiere las notas internas antes que las respuestas al cliente: si se equivoca, el error lo lee alguien de la mesa y no el cliente.
- Ponle vencimiento y revisa de vez en cuando el último uso que muestra la lista.
- Si una llave se filtró o ya no se usa, revócala con el ícono de la papelera. El sistema que la use deja de entrar de inmediato, y la llave queda en la lista como Revocada.
Avisar a otro sistema cuando algo cambia
La API no envía avisos por su cuenta. Si quieres que Updesk le avise a otro sistema, crea una regla en Automatizaciones con la acción Avisar a un sistema externo. Así decides tú en qué casos se avisa.
También te puede servir
¿No era lo que buscabas? Busca en el Manual de Updesk o revisa las preguntas frecuentes.
¿Quieres probarlo?
Recorre una mesa de demostración con datos de ejemplo, sin registrarte. O crea tu cuenta: 14 días del plan completo, sin tarjeta de crédito.