> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cimaos.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Dictado y mejora con IA

> Dicta tus notas con la voz y mejora el texto con inteligencia artificial en fichas clínicas, citas y formularios.

<Note>
  CIMAOS incluye dictado de voz e mejora de texto con inteligencia artificial en los campos de texto largo de la app. Habla en lugar de escribir, y deja que la IA limpie ortografía, acentos y estructura para que tus notas queden ordenadas y fáciles de leer.
</Note>

## Cómo funciona

En los campos donde está disponible, verás dos botones a la derecha del título del campo:

| Botón                     | Qué hace                                                                                                         |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| 🎤 **Micrófono**          | Graba tu voz y la transcribe en texto. Después de transcribir, mejora el texto automáticamente con IA            |
| ✨ **Estrella (Sparkles)** | Toma el texto que ya escribiste y lo mejora con IA: corrige ortografía, ordena en párrafos y resalta datos clave |

<Info>
  Cada operación de dictado (transcripción + mejora) consume **2 créditos**. Cada mejora manual de texto consume **1 crédito**. Tu clínica recibe **200 créditos gratuitos** al crear la cuenta.
</Info>

***

## Dónde está disponible

El dictado y la mejora con IA están integrados en estos campos:

### Ficha del paciente

| Campo                       | Tipo                                       |
| --------------------------- | ------------------------------------------ |
| **Alergias**                | Lista de sustancias o reacciones alérgicas |
| **Condiciones médicas**     | Diagnósticos del paciente                  |
| **Medicamentos actuales**   | Medicamentos con dosis y frecuencia        |
| **Intervenciones pasadas**  | Tratamientos previos                       |
| **Observaciones generales** | Prosa breve sobre el paciente              |

### Atención clínica

| Campo                 | Dónde                                                |
| --------------------- | ---------------------------------------------------- |
| **Evolución clínica** | Al agregar una evolución desde la ficha del paciente |
| **Nota de imagen**    | Al subir una imagen al paciente                      |
| **Receta**            | Al crear una receta médica                           |
| **Recordatorio**      | Al programar un recordatorio                         |
| **Pago**              | Al registrar un pago manual                          |

### Calendario

| Campo                     | Dónde                                                    |
| ------------------------- | -------------------------------------------------------- |
| **Observaciones de cita** | Al agendar, cancelar o marcar como "no asistió" una cita |

***

## Cómo dictar

<Steps>
  <Step title="Haz clic en el botón de micrófono">
    El botón está a la derecha del título del campo. Si no tienes saldo suficiente, el botón aparece gris y al hacer clic muestra un aviso para recargar créditos.
  </Step>

  <Step title="Permite el acceso al micrófono">
    La primera vez, tu navegador te pedirá permiso para usar el micrófono. Acepta para poder dictar.
  </Step>

  <Step title="Habla con normalidad">
    Verás un contador en rojo con el tiempo grabado. Habla claro y a un ritmo normal. Tienes hasta **2 minutos** por dictado.
  </Step>

  <Step title="Detén la grabación">
    Haz clic en el botón cuadrado para detener. Si te equivocas, haz clic en la **X** para cancelar (no se gastan créditos).
  </Step>

  <Step title="Espera el procesamiento">
    Verás los estados: **Subiendo… → Transcribiendo… → Mejorando…**. Al terminar, el texto aparece en el campo, ya formateado en párrafos y con datos resaltados en negrita.
  </Step>
</Steps>

<Tip>
  Si la grabación dura menos de 1 segundo, el sistema avisa que es muy corta y no gasta créditos. Mantén el botón presionado al menos un par de segundos antes de hablar.
</Tip>

***

## Cómo mejorar texto que ya escribiste

<Steps>
  <Step title="Escribe o pega el texto">
    Escribe la nota como te salga: con abreviaturas, sin acentos o todo en una línea. La IA lo ordena después.
  </Step>

  <Step title="Haz clic en el botón de estrella">
    El botón ✨ a la derecha del título. Verás el estado **Mejorando…** mientras se procesa.
  </Step>

  <Step title="Revisa el resultado">
    El texto se reemplaza con la versión mejorada: con ortografía correcta, dividido en párrafos y con los datos clave en negrita.
  </Step>
</Steps>

<Warning>
  La IA **no inventa información** ni completa terminología médica que no haya escrito. Si algo no se entiende, deja la marca **\[?]** para que lo revises tú.
</Warning>

***

## Qué hace la IA y qué no

| Sí hace                                     | No hace                               |
| ------------------------------------------- | ------------------------------------- |
| Corregir ortografía, acentos y puntuación   | Reformular ideas con sus palabras     |
| Capitalizar nombres y medicamentos          | Inventar datos que no dictaste        |
| Ordenar 3 o más ítems en una lista          | Acortar o resumir el contenido        |
| Resaltar dosis, fechas y nombres en negrita | Traducir términos médicos             |
| Separar la nota en párrafos por tema        | Adivinar palabras que no se entienden |

***

## Si la transcripción falla

Si hay un error de red o el servicio no responde, verás el audio guardado en amarillo con dos opciones:

| Acción         | Cuándo usar                                                  |
| -------------- | ------------------------------------------------------------ |
| **Reintentar** | Para procesar el mismo audio de nuevo sin tener que regrabar |
| **Descartar**  | Si decides no usar la grabación. No se gastan créditos       |

<Info>
  Si te quedas sin créditos durante el dictado, el botón se desactiva y aparece un aviso para recargar. La grabación pendiente se conserva — recarga, vuelve al campo y reintenta.
</Info>

***

## Permisos por Rol

| Funcionalidad                       | Administradores | Profesionales | Asistentes |
| ----------------------------------- | :-------------: | :-----------: | :--------: |
| Usar dictado de voz                 |        Sí       |       Sí      |     Sí     |
| Usar mejora de texto con IA         |        Sí       |       Sí      |     Sí     |
| Ver saldo de créditos en cada botón |        Sí       |       Sí      |     Sí     |
| Recargar créditos                   |        Sí       |       No      |     No     |
| Ver consumo del mes                 |        Sí       |       No      |     No     |

<Info>
  Todos los usuarios pueden usar el dictado y la mejora con IA, pero solo los administradores pueden recargar créditos desde **Configuración** → **Plan** → **IA**.
</Info>

***

## Preguntas Frecuentes

<AccordionGroup>
  <Accordion title="¿Cuántos créditos cuesta cada operación?" icon="coins">
    Un dictado completo (transcripción + mejora) cuesta **2 créditos**. Una mejora manual de texto cuesta **1 crédito**. Cancelar una grabación antes de detenerla **no gasta créditos**.
  </Accordion>

  <Accordion title="¿Cuál es la duración máxima de un dictado?" icon="clock">
    **2 minutos** por dictado. Si necesitas dictar más, divide la nota en varios dictados y la IA mantendrá el formato consistente.
  </Accordion>

  <Accordion title="¿Mi dictado queda guardado en algún lugar?" icon="lock">
    El audio se procesa y descarta. Solo se guarda el texto resultante en la ficha del paciente o en el campo donde dictaste.
  </Accordion>

  <Accordion title="¿Funciona en cualquier navegador?" icon="globe">
    Sí, en navegadores modernos (Chrome, Edge, Safari, Firefox). Necesitas dar permiso al micrófono la primera vez.
  </Accordion>

  <Accordion title="¿Por qué la IA escribe [?] en algunas partes?" icon="circle-question">
    Cuando algo no se entiende o suena ambiguo, la IA escribe **\[?]** en lugar de adivinar. Esto te avisa que debes revisar y completar manualmente esa parte.
  </Accordion>

  <Accordion title="¿Qué pasa si me quedo sin créditos?" icon="ban">
    Los botones aparecen grises. Al hacer clic verás un aviso con el saldo y la opción de **Recargar créditos**, que te lleva a **Configuración** → **Plan** → **IA**.
  </Accordion>
</AccordionGroup>

***

## Ver también

* [Créditos IA](/configuracion/plan/creditos-ia) — Cómo recargar créditos y revisar tu consumo
* [Evoluciones Clínicas](/pacientes/evoluciones) — Donde más se usa el dictado en la atención del día a día
* [Ficha del Paciente](/pacientes/index) — Campos médicos donde dictar al registrar pacientes nuevos

<Check>
  **Siguiente paso:** Si necesitas más créditos para tu equipo, aprende a recargar en [Créditos IA](/configuracion/plan/creditos-ia).
</Check>