# MaintainX: lo que puede hacer el asistente

> Todo lo que el asistente puede hacer en MaintainX por mensaje: 9 acciones, con ejemplos de mensajes, la llamada a la API de MaintainX detrás de cada una y cuáles te preguntan antes o se pueden deshacer.

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

En MaintainX, el asistente puede crear una orden de trabajo, cerrar una orden de trabajo, agregar una actualización, agregar fotos a una orden, mandar una solicitud de trabajo, registrar una lectura, buscar un equipo, revisar inventario de una refacción y ver órdenes abiertas. Se lo pides por mensaje, con tus propias palabras.

**Estado:** Beta. Cómo conectarlo, permisos y límites: [MaintainX](https://asktack.com/es/docs/integrations/maintainx/).

| Lo que hace | ¿Pregunta antes? | Deshacer |
|---|---|---|
| Crear una orden de trabajo | Si tiene dudas | 10 minutos |
| Cerrar una orden de trabajo | Si tiene dudas | 10 minutos |
| Agregar una actualización | Si tiene dudas | No |
| Agregar fotos a una orden | Si tiene dudas | 10 minutos |
| Mandar una solicitud de trabajo | Si tiene dudas | 10 minutos |
| Registrar una lectura | Si tiene dudas | No |
| Buscar un equipo | No | – |
| Revisar inventario de una refacción | No | – |
| Ver órdenes abiertas | No | – |

Las reglas para preguntar antes y deshacer son las mismas en todas las herramientas: mira [Confirmaciones y deshacer](https://asktack.com/es/docs/confirmations-and-undo/).

## Crear una orden de trabajo

Crea una orden de trabajo con título, equipo y ubicación, prioridad, a quién se asigna y fecha límite, con las fotos que mandaste adjuntas. También agenda una revisión preventiva ("revisa el Conveyor 3 en 30 días").

- **¿Pregunta antes de hacerlo?** Normalmente no. Te pregunta antes si no está seguro de lo que quisiste decir, si un nombre no coincide exacto o si son más de 5 registros a la vez.
- **¿Se puede deshacer?** Sí. Escribe "deshaz eso" en los próximos 10 minutos.
- **Llamada a la API de MaintainX:** `POST /v1/workorders`
- **Nombre de la acción:** `maintainx.create_work_order`

**Ejemplos de mensajes:**

- "crea una orden de trabajo para el montacargas 2, frenos suaves, urgente"
- "[foto] orden para la prensa 4: fuga de aceite, asígnasela a Mike para el viernes"

## Cerrar una orden de trabajo

Cierra la orden con tu tiempo de mano de obra, las refacciones que usaste (se descuentan del inventario y te dice cuántas quedan) y una nota de cierre. Si el equipo no tiene una orden abierta, registra el trabajo como orden nueva y la cierra.

- **¿Pregunta antes de hacerlo?** Normalmente no. Te pregunta antes si no está seguro de lo que quisiste decir, si un nombre no coincide exacto o si son más de 5 registros a la vez.
- **¿Se puede deshacer?** Sí. Escribe "deshaz eso" en los próximos 10 minutos.
- **Llamada a la API de MaintainX:** `PATCH /v1/workorders/{id}/status`
- **Nombre de la acción:** `maintainx.close_work_order`

**Ejemplos de mensajes:**

- "terminé la orden 1182, 30 minutos, usé un rodamiento 6205"
- "cambié la banda del conveyor 3, una hora y media, usé dos bandas B42"

## Agregar una actualización

Publica tu actualización en una orden de trabajo existente: avance, lo que encontraste, lo que estás esperando.

- **¿Pregunta antes de hacerlo?** Normalmente no. Te pregunta antes si no está seguro de lo que quisiste decir, si un nombre no coincide exacto o si son más de 5 registros a la vez.
- **¿Se puede deshacer?** No. Cámbialo o bórralo en la herramienta misma.
- **Llamada a la API de MaintainX:** `POST /v1/workorders/{id}/comments`
- **Nombre de la acción:** `maintainx.add_comment`

**Ejemplos de mensajes:**

- "en la orden 1182: ya llegó la refacción"
- "nota en la orden del conveyor 3: la banda también está desgastada"

## Agregar fotos a una orden

Adjunta las fotos que mandaste a una orden de trabajo existente.

- **¿Pregunta antes de hacerlo?** Normalmente no. Te pregunta antes si no está seguro de lo que quisiste decir, si un nombre no coincide exacto o si son más de 5 registros a la vez.
- **¿Se puede deshacer?** Sí. Escribe "deshaz eso" en los próximos 10 minutos.
- **Llamada a la API de MaintainX:** `PUT /v1/workorders/{id}/attachments/{filename}`
- **Nombre de la acción:** `maintainx.add_photos`

**Ejemplos de mensajes:**

- "[foto] agrégala a la orden 1182"
- "[2 fotos] súbelas a la orden del conveyor 3"

## Mandar una solicitud de trabajo

Le manda a mantenimiento una solicitud para revisar: el problema, el equipo o el área, la prioridad y las fotos que mandaste.

- **¿Pregunta antes de hacerlo?** Normalmente no. Te pregunta antes si no está seguro de lo que quisiste decir, si un nombre no coincide exacto o si son más de 5 registros a la vez.
- **¿Se puede deshacer?** Sí. Escribe "deshaz eso" en los próximos 10 minutos.
- **Llamada a la API de MaintainX:** `POST /v1/workrequests`
- **Nombre de la acción:** `maintainx.create_work_request`

**Ejemplos de mensajes:**

- "[foto] mándale una solicitud a mantenimiento: fuga de aceite en la prensa 4"
- "el montacargas 2 falló la revisión, frenos suaves, pide mantenimiento"

## Registrar una lectura

Registra una lectura (horas, millas, presión, temperatura) en el medidor de un equipo y te dice cuál fue la anterior.

- **¿Pregunta antes de hacerlo?** Normalmente no. Te pregunta antes si no está seguro de lo que quisiste decir, si un nombre no coincide exacto o si son más de 5 registros a la vez.
- **¿Se puede deshacer?** No. Cámbialo o bórralo en la herramienta misma.
- **Llamada a la API de MaintainX:** `POST /v1/meterreadings`
- **Nombre de la acción:** `maintainx.log_meter_reading`

**Ejemplos de mensajes:**

- "el montacargas 2 ya marca 1520 horas, regístralo"
- "el compresor 1 marca 8,412 horas"

## Buscar un equipo

Te dice dónde está un equipo, si está en servicio o parado, y sus órdenes de trabajo abiertas.

- **¿Pregunta antes de hacerlo?** No. Solo consulta información.
- **¿Se puede deshacer?** No hace falta: no cambia nada.
- **Llamada a la API de MaintainX:** `GET /v1/assets/{id}`
- **Nombre de la acción:** `maintainx.find_asset`

**Ejemplos de mensajes:**

- "¿qué órdenes abiertas tiene la prensa 4?"
- "¿el montacargas 2 está parado?"

## Revisar inventario de una refacción

Busca una refacción por nombre o número de parte y te dice cuántas hay en inventario, el mínimo y dónde están.

- **¿Pregunta antes de hacerlo?** No. Solo consulta información.
- **¿Se puede deshacer?** No hace falta: no cambia nada.
- **Llamada a la API de MaintainX:** `GET /v1/parts/{id}`
- **Nombre de la acción:** `maintainx.find_part`

**Ejemplos de mensajes:**

- "¿cuántos rodamientos 6205 quedan?"
- "¿tenemos bandas B42 en inventario?"

## Ver órdenes abiertas

Te da tus órdenes de trabajo abiertas (o las de alguien más, o las de todo el equipo), o solo las vencidas o las de hoy, las más próximas primero.

- **¿Pregunta antes de hacerlo?** No. Solo consulta información.
- **¿Se puede deshacer?** No hace falta: no cambia nada.
- **Llamada a la API de MaintainX:** `GET /v1/workorders?assignees={id}&statuses=OPEN&statuses=IN_PROGRESS&statuses=ON_HOLD`
- **Nombre de la acción:** `maintainx.list_work_orders`

**Ejemplos de mensajes:**

- "¿qué órdenes tengo abiertas?"
- "¿hay órdenes vencidas en MaintainX?"

---

*Esta lista se genera del código que ejecuta cada acción, así que siempre está al día.*