# MaintainX

> Cierra órdenes de trabajo con mano de obra y refacciones, crea órdenes y solicitudes desde una foto, registra lecturas de medidores y revisa el inventario de refacciones en MaintainX por mensaje o nota de voz. Beta; requiere el plan Premium o Enterprise de MaintainX.

Estado: Beta

Fuente: https://asktack.com/es/docs/integrations/maintainx/

**Beta.** Ya funciona y lo seguimos probando con los primeros usuarios. Si algo se ve mal, avísanos en tu chat.

Pensado para técnicos de mantenimiento y supervisores que registran el trabajo **después de hacerlo**: manda una nota de voz o un mensaje en tu descanso y el asistente llena MaintainX. Las notas de voz se transcriben primero, así que los números de parte y los tiempos dichos en voz alta ("un seis dos cero cinco", "cuarenta minutos") llegan como 6205 y 40 min.

## Lo que puede hacer el asistente

| Tú escribes | Lo que pasa en MaintainX |
|---|---|
| 🎤 "Terminé la orden 1182, 30 minutos, usé un rodamiento 6205" | Cierra la orden 1182 con 30 minutos de mano de obra y un rodamiento 6205, que se descuenta del inventario. La respuesta te dice cuántos quedan. |
| "Revisa el Conveyor 3 otra vez en 30 días" | Crea una orden preventiva en el Conveyor 3 para dentro de 30 días |
| *(foto)* "Fuga de aceite en la prensa 4, pide mantenimiento" | Le manda a mantenimiento una solicitud de trabajo con la foto |
| "Crea una orden para el montacargas 2, frenos suaves, urgente, asígnasela a Mike" | Crea una orden de prioridad alta en el Montacargas 2, asignada a Mike |
| "En la orden 1182: ya llegó la refacción" | Publica la actualización en la orden 1182 |
| *(fotos)* "Agrégalas a la orden 1182" | Adjunta las fotos a la orden 1182 |
| "El montacargas 2 marca 1520 horas" | Registra la lectura en el horómetro del Montacargas 2 y te dice la anterior |
| "¿Cuántos rodamientos 6205 quedan?" | Te dice cuántos hay en inventario, el mínimo y dónde están |
| "¿Qué órdenes tengo abiertas?" / "¿Hay algo vencido?" | Te da tus órdenes abiertas (o vencidas), las más próximas primero |

Todo se hace de una vez, y te llega una respuesta corta con lo que se hizo. Escribe **deshaz eso** en los próximos 10 minutos para revertir lo último:

- Una orden o solicitud nueva se borra (con sus fotos).
- Una orden cerrada se vuelve a abrir y su lista de refacciones queda como estaba. El registro de mano de obra se queda, porque MaintainX no deja que las integraciones borren registros de tiempo; el asistente deja una nota en la orden explicándolo.
- Las fotos agregadas a una orden se quitan.
- Las actualizaciones (comentarios) y las lecturas de medidores no se pueden deshacer: MaintainX no deja que una integración las borre.

Las consultas no cambian nada. Mira [Confirmaciones y deshacer](https://asktack.com/es/docs/confirmations-and-undo/) para saber cuándo pregunta antes de todos modos.

Mira la [lista completa de lo que puede hacer el asistente en MaintainX](https://asktack.com/es/docs/actions/maintainx/), con ejemplos de mensajes, la llamada a la API detrás de cada acción y cuáles te preguntan antes o se pueden deshacer.

## Requisitos

- **El plan Premium o Enterprise de MaintainX.** MaintainX solo incluye acceso a la API en esos planes ([referencia de la API de MaintainX](https://api.getmaintainx.com/v1/docs)). En otro plan, MaintainX rechaza la clave y la página para conectar te lo dice. Una prueba de Premium sirve para probar.
- Un **administrador** de MaintainX crea la clave de API. La clave funciona como la persona que la creó, así que solo puede hacer lo que su rol en MaintainX permite.
- El **dueño o un administrador** de Tack pega la clave. Es una conexión de la empresa: una sola conexión que el dueño o el administrador comparte con el equipo.

## Cómo conectarlo

1. En MaintainX, abre **Settings → Organization Settings → Integrations → API Keys** y elige **+ New Key**.
2. Ponle un nombre (por ejemplo "Tack"). Si aparece **Key usage**, elige **REST API**. Deja apagado **Allow this token to be used on all my organizations**.
3. Elige **Generate Key** y cópiala. MaintainX la muestra una sola vez ([MaintainX: generar una clave de API](https://help.getmaintainx.com/build/getting-started)).
4. En tu chat, escribe "conecta MaintainX", o toca **Conectar** en la pestaña **Conexiones** de tu [panel de cuenta](https://asktack.com/es/docs/account-dashboard/). El asistente te manda un enlace seguro.
5. Abre el enlace y pega la clave. La revisamos con MaintainX antes de guardarla, y se guarda cifrada. Nunca va en el chat.
6. El asistente lee tus ubicaciones, equipos, refacciones, personas y medidores para que "Conveyor 3", "el rodamiento 6205" o "Mike" encuentren el registro correcto.
7. En **Conexiones**, elige quién de tu equipo puede usar MaintainX en **Quién puede usarla**.

El enlace sirve una vez y vence en 15 minutos. Si alguien del equipo pide MaintainX antes de que esté conectado, el asistente le dice que el dueño o un administrador lo tiene que conectar.

**Si la página para conectar dice que la clave fue rechazada:**

- *Tu plan no incluye acceso a la API*: la organización necesita Premium o Enterprise.
- *La clave sirve para varias organizaciones*: crea una clave nueva con "use on all my organizations" apagado, en la organización que usa tu equipo.
- *MaintainX no aceptó la clave*: se copió mal o la borraron. Crea una nueva.

## ¿Cuáles órdenes son "mías"?

"Mis órdenes abiertas" y "asígnamela" te buscan entre los usuarios de MaintainX por el correo de tu perfil de Tack y luego por tu nombre completo. Si ninguno coincide, el asistente te pregunta quién eres en MaintainX.

## ¿No puedes conectarlo tú?

[Agenda una llamada de 15 minutos](https://asktack.com/es/docs/getting-help/setup-call/) y lo conectamos contigo.

## Desconectar y quitar el acceso

- **En el sitio de Tack (dueños y administradores):** ve a **Conexiones**, abre **Administrar conexión** junto a MaintainX y toca **Desconectar**. Borramos la clave guardada de inmediato.
- **Por mensaje (dueños y administradores):** escribe **desconecta MaintainX** y di **sí** cuando el asistente te pregunte.
- **En MaintainX:** MaintainX no deja que una app cancele su propia clave, así que borra también la clave en **Settings → Integrations → API Keys**. El asistente te manda ese enlace cuando desconectas. Cuando la clave ya no existe, la siguiente solicitud lo nota y la conexión queda desconectada.

Las órdenes, solicitudes, fotos y lecturas que creó el asistente se quedan en MaintainX.

## Límites y problemas conocidos

- Todo se hace como el usuario de MaintainX que creó la clave, así que las órdenes y comentarios nuevos aparecen creados por esa persona.
- MaintainX acepta como máximo **10 lecturas al día en un medidor manual** por su API. Después de eso, el asistente te dice que la registres en la app.
- MaintainX permite 100 solicitudes por minuto por clave. Muchas fotos de una vez pueden llegar al límite; el asistente vuelve a intentar.
- Órdenes de compra, procedimientos y listas de verificación, tiempo fuera de servicio, y aprobar o rechazar solicitudes todavía no se hacen por mensaje.

_Revisado contra la referencia de la API de MaintainX el 25 de octubre de 2026._