Para administradores

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

  1. 1Entra a Llaves de API, en Configuración.
  2. 2Pulsa Nueva llave y ponle un Nombre que identifique al sistema que la va a usar, por ejemplo «Asistente telefónico».
  3. 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.
  4. 4Ajusta Llamadas/min (60 por defecto, hasta 600) y Vence en (días) (365 por defecto; si lo dejas vacío, no vence).
  5. 5En Qué puede hacer, marca solo los permisos que ese sistema necesita.
  6. 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

PermisoQué permiteMarcado al crear
Leer el catálogoVer los servicios y los valores válidos de la mesa.Sí
Crear ticketsRegistrar tickets nuevos.Sí
Dejar notas internasEscribir notas que lee un agente, no el cliente.Sí
Leer ticketsConsultar el estado y buscar por teléfono o referencia.No
Adjuntar archivosSubir archivos a un ticket.No
Responder al clienteEscribirle al solicitante: el texto le llega por correo.No
Modificar ticketsCambiar estado y prioridad. Incluye poder cerrar.No
Escalar ticketsPasar un ticket a la cola de otro equipo, con un motivo.No
Leer contactosBuscar 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.

¿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.

La API de Updesk para integraciones · Manual de Updesk