API pública

Desks Professional y superiores

Si estás creando una integración con deskbird, nuestra API pública te permite acceder y gestionar datos como reservas, usuarios, grupos, recursos, programación y mucho más.

👉 Para la documentación técnica completa, visita nuestro Developer Hub:
https://developer.deskbird.com

1. Casos de uso disponibles
2. Endpoints disponibles
3. Primeros pasos
4. Gestión de claves API
5. ¿Necesitas ayuda?

1. Casos de uso disponibles

Con la API de deskbird, puedes conectar los datos de reservas y presencia con tus herramientas de lugar de trabajo existentes para automatizar flujos de trabajo, crear paneles personalizados y reducir el trabajo manual. A continuación tienes algunos ejemplos populares que los clientes usan para crear valor operativo y de experiencia del empleado de forma inmediata.

• Integración con control de acceso: Otorga (y elimina) automáticamente el acceso a edificios o zonas según las reservas de escritorios o salas de reuniones, para que los empleados tengan el acceso correcto en el momento adecuado sin listas manuales.
• Automatización de reservas de plaza de aparcamiento: Libera o haz check-in de reservas automáticamente mediante escaneo de tarjetas o datos de HRIS.
• Cartelería digital y paneles de oficina: Muestra la disponibilidad en directo y "quién está en la oficina hoy" en pantallas o páginas de intranet, facilitando que los equipos planifiquen sus días en la oficina y encuentren espacio rápidamente.
• Limpieza y servicios según demanda: Usa datos reales de uso (por ejemplo, reservas con check-in realizado) para limpiar y dar servicio solo a las áreas que realmente se usaron, ayudando a reducir limpiezas innecesarias y enfocando los esfuerzos donde más importan.
• Información sobre no-shows (Debido a la falta de check-in) o reservas fantasma: Analiza los patrones de reservas frente a check-in para detectar no-shows (Debido a la falta de check-in) y capacidad no utilizada, y usa estos datos para mejorar la planificación de espacios y las reglas de reserva.
• Widgets "Encuentra a mi equipo": Ofrece una vista sencilla de la presencia del equipo en herramientas como tu intranet o plataforma de colaboración, para que los empleados puedan ver cuándo sus compañeros estarán en el sitio.
• Análisis avanzados: Conecta con herramientas BI como PowerBI o Looker para analizar tendencias de utilización y ocupación.

💡 Nota: Estos son solo algunos ejemplos. Si nos cuentas tu configuración y lo que quieres lograr, estaremos encantados de hablar sobre tus necesidades específicas y ayudarte a encontrar el mejor enfoque de integración.

2. Endpoints disponibles

Para ver los esquemas de solicitud/respuesta y ejemplos, consulta el Developer Hub.

Reglas de detección ofimática: el endpoint Lists company network configurations devuelve las reglas de red que tu empresa utiliza para la detección ofimática en inteligencia deskbird, para que puedas conectarlas con tus propias herramientas. Los resultados se pueden filtrar por oficina y se cargan por páginas. Cada regla también muestra con qué otra oficina entra en conflicto, incluyendo la señal y el valor implicados. Una clave API solo devuelve datos de su propia empresa. Si prefieres exportar estas reglas como archivo CSV, consulta Configurar la detección ofimática y la configuración de red para deskbird Dock.

3. Primeros pasos

Toda la documentación técnica, detalles de autenticación y referencias de endpoints están disponibles en nuestro Developer Hub. También encontrarás ejemplos de payloads, códigos de error y guías de integración.

Para crear una clave API, ve a Admin > Empresa: Claves API y haz clic en Generate key (solo los Global Admins pueden generar claves). En la ventana Generate key, introduce un Nombre (nombre del proyecto), selecciona API o SCIM, elige una Expiración (1 año, 2 años, 3 años o No expiration) y luego haz clic en Generate key.

Tu nueva clave aparecerá en la lista, incluyendo una vista previa de la clave y detalles como Creado por, Creado el, Último uso y Expira el.

Puedes eliminar claves usando el icono de papelera; esta acción no se puede deshacer.

💡 Nota: Si tu empresa ya utiliza la sincronización HRIS para el provisionamiento de usuarios, no puedes crear claves SCIM.

4. Gestión de claves API

Los Global Admins pueden gestionar todo el ciclo de vida de las claves API públicas, incluyendo su creación, configuración de expiración y monitorización.

Sin límite de claves API

No hay límite en la cantidad de claves API públicas que puedes generar. Crea tantas como necesites para tus integraciones.

Configuración de expiración

Al generar una clave, puedes establecer su expiración en uno de los siguientes periodos:

• 1 año
• 2 años
• 3 años
• Sin expiración

Emails de recordatorio de expiración

deskbird envía automáticamente emails de recordatorio antes de que una clave API expire:

• 3 meses antes de la expiración
• 2 semanas antes de la expiración

El recordatorio se envía a la persona que creó la clave, siempre que su cuenta siga activa. Si la cuenta del creador ya no está activa, el email se envía a todos los Global Admins.

5. ¿Necesitas ayuda?

¿Tienes un caso de uso específico en mente? ¿No estás seguro de si algo es posible?
👉 Escríbenos a support@deskbird.com. Estaremos encantados de ayudarte a definir la integración.