# Novedades Fuente: https://wire.ia.br/documentation/es/ajuda/novidades > Qué cambió en cada versión. Los cambios que afectan a la API aparecen aquí primero. ## 0.7 · octubre de 2026 [#07--octubre-de-2026] ### Idiomas [#idiomas] * **Paper en tres idiomas.** Português (Brasil), English y Español, en la página de inicio, la app, las páginas legales, los mensajes del servidor y esta documentación. * **Detección de idioma.** La app sugiere el idioma de tu navegador y recuerda tu elección, por cuenta y por dispositivo. Cámbialo en **Configuración → Apariencia → Idioma**. * **Formatos regionales.** Las fechas, los números, el primer día de la semana y el reloj de 12 o 24 horas siguen tu región. La app puede detectar tu país a partir de tu conexión, sin guardarlo en el servidor. * **Otros idiomas con la traducción del navegador.** Para cualquier otro idioma, el traductor automático de tu navegador funciona sobre la interfaz. Tus notas, los títulos de las páginas y el editor están marcados para que nunca se traduzcan ni se alteren. * **Fechas en las notas.** Palabras como "mañana", "la semana que viene" y los días de la semana se entienden en los tres idiomas. ### API [#api] * Los mensajes de error siguen el encabezado `Accept-Language` (`pt-BR`, `en` o `es`). Los nombres de los campos no cambian. * Nuevo endpoint `GET /api/locale`, público, que devuelve el idioma detectado y los formatos regionales. ## 0.6 · octubre de 2026 [#06--octubre-de-2026] ### En la app [#en-la-app] * **Carpetas.** Crea carpetas y carpetas dentro de carpetas. En Google Drive, pasan a ser carpetas de verdad. * **Importar `.md`.** Arrastra notas sueltas, carpetas o `.zip` a la barra lateral, a una carpeta o dentro de una página. Las imágenes que citan vienen incluidas. * **Modo lectura.** El botón Leer en lo alto de la página, o Ctrl Shift L. Paper recuerda la elección de cada página. * **Compartir por enlace.** Con vencimiento, modo en vivo y versiones en texto plano (`.md` y `.json`) para IAs. * **Menú de la página.** Icono, duplicar, mover y copiar enlace interno. * **Plantillas** para páginas vacías: reunión, proyecto, tareas, lectura, estudio y semana. * **Guías** en lugar de las páginas de ejemplo en cuentas nuevas. * **Sincronización estable.** La conexión con Google queda guardada en el dispositivo y se renueva sola. Basta conectar una vez por dispositivo. ### API [#api-1] * Primera versión de la [API personal](/es/api/visao-geral): bóvedas, páginas, búsqueda, adjuntos y agenda. * [Modo desarrollador](/es/api/modo-desenvolvedor) y [tokens de acceso](/es/api/tokens), con el token seguro para IA. * [Términos de la API](/es/termos/termos-da-api), versión del 2 de octubre de 2026. * Mapa de la documentación para agentes en [`/documentation/agents/raw.json`](https://wire.ia.br/documentation/agents/raw.json). ### Moderación [#moderación] * Páginas de [soporte](https://wire.ia.br/es/soporte/) y de [apelación](https://wire.ia.br/es/apelacion/). ## 0.5 · septiembre de 2026 [#05--septiembre-de-2026] * Grupos con edición en vivo y cifrado de extremo a extremo, amistades por ID o invitación. * Páginas protegidas con contraseña, adjuntos, tablas, tableros, cronogramas y gráficos. * Bóvedas separadas y un mapa de ideas más simple. --- # Soporte Fuente: https://wire.ia.br/documentation/es/ajuda/suporte > Cómo hablar con Paper y qué enviar para que la respuesta llegue más rápido. El formulario de soporte está en [wire.ia.br/es/soporte](https://wire.ia.br/es/soporte/). No hace falta haber iniciado sesión. Si prefieres el correo, escribe a [contato.brennoleon@gmail.com](mailto:contato.brennoleon@gmail.com). Las respuestas llegan en español, inglés o portugués. ## Asuntos [#asuntos] | Asunto | Para qué | | ---------------------------------- | ---------------------------------------------------------- | | Duda sobre cómo usarlo | Algo que esta documentación no respondió | | Algo no funciona | Errores, sincronización detenida, un botón que no responde | | Mi cuenta y mis datos (privacidad) | Pedir copia, corrección o eliminación de tus datos | | API y tokens de acceso | Dudas sobre la API, límites, casos de uso | | Denunciar una nota publicada | Enlace público con contenido que viola los términos | | Otro asunto | Sugerencias y el resto | ## Para que la respuesta llegue más rápido [#para-que-la-respuesta-llegue-más-rápido] * Di el dispositivo y el navegador (por ejemplo, "Android, Chrome"). * Para problemas, cuenta el paso a paso hasta el error y copia el mensaje que apareció. * Para la API, envía el código de respuesta y el mensaje de error. **Nunca envíes el token.** Los 8 caracteres del medio (`paper_k3m9x2ab_…`) bastan para encontrar el token. ## Cuenta baneada [#cuenta-baneada] Usa la [apelación](https://wire.ia.br/es/apelacion/). Mira [Baneo y apelación](/es/termos/banimento-e-apelacao). ## Antes de escribir [#antes-de-escribir] * ¿La sincronización pidió conectarte? Mira [Sincronizar con Google Drive](/es/guia/sincronizar). * ¿La API respondió un error? Mira [Errores](/es/api/erros). --- # Agenda Fuente: https://wire.ia.br/documentation/es/api/agenda > Leer, crear y borrar eventos en la agenda "Paper" de Google Calendar. La API solo toca la agenda llamada **Paper**, que la propia app crea en el Google Calendar de la persona. Sus otras agendas quedan fuera de alcance. Antes de usarla: 1. La persona conecta Google Calendar en **Configuración → Integraciones**. 2. En **Configuración → Desarrollador**, toca **Habilitar la agenda "Paper" para la API**. 3. El token necesita el permiso de agenda. Los tokens seguros no acceden a la agenda. Sin los dos primeros pasos, la API responde `409`. ## Listar eventos [#listar-eventos] ```http GET /calendar/events?from=2026-10-01&to=2026-10-31 ``` `from` y `to` aceptan una fecha o una fecha y hora en ISO 8601. Sin `from`, empieza ahora. Sin `to`, llega hasta 30 días después de `from`. Devuelve hasta 250 eventos, en orden de inicio. ```json [ { "id": "k9d8f7g6h5j4", "titulo": "Dentista", "descricao": null, "inicio": { "dateTime": "2026-10-06T14:00:00-03:00", "timeZone": "America/Sao_Paulo" }, "fim": { "dateTime": "2026-10-06T15:00:00-03:00", "timeZone": "America/Sao_Paulo" } } ] ``` Los eventos de día completo vienen con `{ "date": "2026-10-06" }` en `inicio` y `fim`. ## Crear un evento [#crear-un-evento] ```http POST /calendar/events Content-Type: application/json ``` ```json { "title": "Entregar informe", "date": "2026-10-08", "time": "09:30", "durationMinutes": 45, "description": "Versión final, con los gráficos.", "timeZone": "America/Argentina/Buenos_Aires" } ``` | Campo | Obligatorio | Reglas | | ----------------- | ----------- | ---------------------------------------------------------- | | `title` | No | Hasta 300 caracteres. Vacío pasa a "Evento". | | `date` | Sí | `AAAA-MM-DD`. | | `time` | No | `HH:MM`, 24 horas. Sin hora, el evento es de día completo. | | `durationMinutes` | No | De 5 a 1440. Por defecto: 60. | | `description` | No | Hasta 4000 caracteres. | | `timeZone` | No | Zona horaria IANA. Por defecto: `America/Sao_Paulo`. | Respuesta: `{ "id": "…" }`. Necesita el permiso **Leer y crear eventos**. ## Borrar un evento [#borrar-un-evento] ```http DELETE /calendar/events/{id} ``` Solo borra eventos de la agenda "Paper". Necesita el permiso **Leer y crear eventos**. ## Sentido común [#sentido-común] Crea eventos que la persona pidió o que vienen de sus notas. No llenes la agenda con recordatorios repetidos ni uses la agenda como cola de tareas de un sistema. --- # Agentes de IA Fuente: https://wire.ia.br/documentation/es/api/agentes-de-ia > Reglas y guion para que una IA use el cuaderno de alguien con cuidado. Esta página habla directamente con los agentes de IA. Si eres una persona que configura un agente, envíale el texto del botón **Copiar instrucciones para la IA** y el enlace del mapa: ```txt https://wire.ia.br/documentation/agents/raw.json ``` ## Guion [#guion] **Confirma a quién atiendes.** Llama a `GET /api/v1/me` con `Authorization` y `X-Paper-Account`. Si la cuenta no coincide, detente y avisa a la persona. **Mira qué puedes hacer.** La respuesta de `/me` trae el tipo de token y los permisos. `GET /vaults` muestra las bóvedas que alcanzas. Si el id de la bóveda empieza con `copia-`, trabajas en una copia y la persona revisa todo después. **Lee antes de escribir.** Lista las páginas, lee las que importan para el pedido. Guarda la lista en memoria durante la tarea en vez de pedirla de nuevo en cada paso. **Cambia lo mínimo.** Prefiere `append` a reescribir la página entera. Al reescribir, conserva lo que la persona escribió y el formato de los bloques (mira [Formato de las páginas](/es/api/formato-das-paginas)). **Cuenta lo que hiciste.** Al final, dile a la persona qué páginas creaste, cambiaste o mandaste a la papelera, con los títulos. ## Haz [#haz] * Respeta los permisos. `403` significa no: no intentes otro camino. * Trata las páginas protegidas (`423`) como cerradas. No le pidas la contraseña a la persona ni intentes adivinar el contenido. * Ante un `429`, detente, espera y vuelve a un ritmo menor. Mira [Límites](/es/api/limites). * Escribe en un español claro, como escribe la persona. Usa los bloques de Paper cuando ayuden: tareas con `@fecha`, tablas, tableros. * Crea una carpeta para lo que produzcas, si la persona no dijo dónde ponerlo. * Envía `Accept-Language` con el idioma de la persona, para que los mensajes de error lleguen en un idioma que lea. ## No hagas [#no-hagas] * No uses el cuaderno como tu memoria a largo plazo, base de datos, cola de tareas o registro de ejecución. * No envíes archivos para alojarlos en otro lugar. * No consultes en bucle para saber si algo cambió. Una revisión por minuto, como máximo. * No copies el contenido del cuaderno fuera de la conversación con la persona sin que lo pida. * No muestres el token en respuestas, registros ni archivos. * No borres en masa. Para más de 10 páginas a la vez, pide confirmación. Romper estas reglas lleva al baneo permanente de la cuenta de la persona que te confió el token. Los términos completos están en [Términos de la API](/es/termos/termos-da-api). ## Instrucciones de ejemplo [#instrucciones-de-ejemplo] ```txt Tienes acceso a mi cuaderno de Paper mediante la API personal. Token (envíalo en el encabezado Authorization: Bearer): paper_… Mi cuenta: 3f2a… (envíala también en el encabezado X-Paper-Account) Base de la API: https://wire.ia.br/api/v1 Lee primero el mapa de la documentación: https://wire.ia.br/documentation/agents/raw.json Respeta los límites y los términos de uso de la API descritos ahí. Usa el cuaderno como cuaderno, no como base de datos. ``` ## Herramientas para el agente [#herramientas-para-el-agente] Si tu agente acepta herramientas definidas por ti, estas cinco cubren casi todo: | Herramienta | Solicitud | | ----------------------------------------------- | ------------------------------------------------ | | `listar_paginas(boveda)` | `GET /vaults/{boveda}/pages` | | `leer_pagina(boveda, id)` | `GET /vaults/{boveda}/pages/{id}?format=md` | | `buscar(boveda, texto)` | `GET /vaults/{boveda}/search?q=` | | `crear_pagina(boveda, titulo, texto, carpeta?)` | `POST /vaults/{boveda}/pages` | | `agregar(boveda, id, texto)` | `PATCH /vaults/{boveda}/pages/{id}` con `append` | Ejemplos listos en [Ejemplos](/es/api/exemplos). --- # Adjuntos Fuente: https://wire.ia.br/documentation/es/api/anexos > Enviar imágenes y archivos que forman parte de las notas. ```http POST /vaults/{boveda}/files?name={archivo.ext} Content-Type: image/png (cuerpo: los bytes del archivo) ``` El archivo va a la carpeta **Adjuntos** (`Anexos`) de la bóveda, en el Google Drive de la persona. La respuesta trae el Markdown listo para poner en una página: ```json { "ref": "a3f9c21b7e-grafico.png", "markdown": "![grafico.png](Anexos/a3f9c21b7e-grafico.png)" } ``` Las imágenes vuelven como `![nombre](Anexos/ref)`. Los otros archivos vuelven como un enlace `[📎 nombre](Anexos/ref)`. ## Ejemplo [#ejemplo] ```bash curl -X POST "https://wire.ia.br/api/v1/vaults/principal/files?name=grafico.png" \ -H "Authorization: Bearer $PAPER_TOKEN" \ -H "X-Paper-Account: $PAPER_CUENTA" \ -H "Content-Type: image/png" \ --data-binary @grafico.png ``` Después, agrega el Markdown a una página: ```bash curl -X PATCH "https://wire.ia.br/api/v1/vaults/principal/pages/pa1k2m3n4o5p" \ -H "Authorization: Bearer $PAPER_TOKEN" \ -H "Content-Type: application/json" \ -d '{"append": "![grafico.png](Anexos/a3f9c21b7e-grafico.png)"}' ``` ## Reglas [#reglas] | Regla | Valor | | -------------- | ------------------------------------------------------------------- | | Permiso | Token normal con "Enviar archivos" y **Leer y editar** en la bóveda | | Tamaño máximo | 10 MB por archivo | | Cantidad | 30 envíos por día, por token | | Copias para IA | No reciben archivos | ## Para qué sirve, y para qué no [#para-qué-sirve-y-para-qué-no] Los adjuntos existen para las notas de la persona: la foto de la pizarra de la reunión, el PDF que comenta una página, el gráfico que un script generó para un informe. No uses Paper para alojar imágenes o archivos que otros sitios, apps o personas van a descargar. Eso incluye usar enlaces publicados como CDN. El abuso de alojamiento lleva a un baneo permanente. Mira [Uso justo](/es/termos/uso-justo). El alojamiento de imágenes en la nube para el plan de pago es una función futura y todavía no existe. --- # Autenticación Fuente: https://wire.ia.br/documentation/es/api/autenticacao > El encabezado del token, la confirmación de cuenta con el ID y el idioma de las respuestas. Toda solicitud lleva el token en el encabezado `Authorization`: ```http GET /api/v1/vaults HTTP/1.1 Host: wire.ia.br Authorization: Bearer paper_k3m9x2ab_Q7wLc2… X-Paper-Account: 3f2a9c…(ID de la cuenta, 32 caracteres) Accept-Language: es ``` ## Confirmación de cuenta [#confirmación-de-cuenta] El encabezado `X-Paper-Account` es opcional y recomendado. Lleva el ID de la cuenta dueña del token, que aparece en **Configuración → Desarrollador** y en **Configuración → Perfil**. Si el ID no coincide con el dueño del token, la solicitud falla con `403`, sin tocar nada. Esto evita que un agente use, por error, el token de otra persona que quedó en un historial, en un archivo viejo o en la conversación equivocada. Los agentes de IA siempre deben enviar este encabezado. ## Idioma de las respuestas [#idioma-de-las-respuestas] Los mensajes de error vienen en el idioma de `Accept-Language`: `pt-BR` (por defecto), `en` o `es`. Los nombres de los campos del JSON no cambian. ## Qué se revisa en cada solicitud [#qué-se-revisa-en-cada-solicitud] 1. El formato del token. 2. Si el token existe, no fue revocado y no venció (`401` si falla). 3. Si la cuenta existe, no está baneada, tiene el modo desarrollador activado y aceptó los términos actuales de la API (`403` si falla). 4. Si `X-Paper-Account` coincide con la cuenta (`403` si falla). 5. Los límites por minuto y por día (`429` si se pasa). Mira [Límites](/es/api/limites). 6. Si el token tiene permiso para la bóveda, la agenda o los adjuntos de la solicitud (`403` si falta). ## Buenas prácticas [#buenas-prácticas] * Usa siempre `https://`. Una solicitud a `http://` se redirige, pero el token ya viajó sin protección. * No envíes el token como parámetro de URL. Aparece en registros e historiales. * Guarda el token fuera del código: variable de entorno, gestor de secretos o bóveda de contraseñas. --- # Búsqueda Fuente: https://wire.ia.br/documentation/es/api/busca > Buscar páginas por título y texto dentro de una bóveda. ```http GET /vaults/{boveda}/search?q={texto} ``` Busca en el título y en el texto de las páginas de la bóveda. Devuelve hasta 50 resultados. El texto de la búsqueda puede tener hasta 100 caracteres. ```bash curl "https://wire.ia.br/api/v1/vaults/principal/search?q=presupuesto" \ -H "Authorization: Bearer $PAPER_TOKEN" \ -H "X-Paper-Account: $PAPER_CUENTA" ``` ## Respuesta con token normal [#respuesta-con-token-normal] La búsqueda corre en el Google Drive de la persona y devuelve las páginas encontradas: ```json [ { "id": "pa1k2m3n4o5p", "title": "Reunión del lunes", "kind": "pagina", "updatedAt": "2026-10-01T14:03:11.000Z" } ] ``` Para leer el texto, pide la página con `GET /vaults/{boveda}/pages/{id}`. ## Respuesta con token seguro [#respuesta-con-token-seguro] En la copia para IA, cada resultado ya trae un fragmento alrededor de lo que se encontró: ```json [ { "id": "pa1k2m3n4o5p", "title": "Reunión del lunes", "trecho": "…revisar el presupuesto antes de la reunión con…" } ] ``` ## Consejos [#consejos] * Codifica el texto en la URL (`encodeURIComponent` en JavaScript, `urllib.parse.quote` en Python). * Para recorrer toda la bóveda, lista las páginas una vez y guarda el resultado. No hagas una búsqueda por página. * Las páginas protegidas nunca muestran contenido. Con el permiso "Mostrar solo el título", pueden aparecer en los resultados por su título. --- # Bóvedas y páginas Fuente: https://wire.ia.br/documentation/es/api/cofres-e-paginas > Listar bóvedas, listar y leer páginas, crear, editar y mandar a la papelera. Todas las rutas empiezan en `https://wire.ia.br/api/v1`. Los ejemplos usan `$PAPER_TOKEN` y `$PAPER_CUENTA` como variables de entorno. ## Listar bóvedas [#listar-bóvedas] ```http GET /vaults ``` Devuelve solo las bóvedas que alcanza el token. Con un token normal, solo aparecen las bóvedas sincronizadas con Google Drive. Con un token seguro, aparece solo su copia. ```json [ { "id": "principal", "nome": "Mi cuaderno", "acesso": "editar", "copia": false }, { "id": "cmg2k1x9a4tz", "nome": "Trabajo", "acesso": "ler", "copia": false } ] ``` La bóveda principal siempre tiene el id `principal`. Las copias para IA tienen ids con el formato `copia-` seguido de 16 caracteres. ## Listar páginas [#listar-páginas] ```http GET /vaults/{boveda}/pages GET /vaults/{boveda}/pages?parent={id} GET /vaults/{boveda}/pages?parent= ``` Sin `parent`, devuelve todas las páginas y carpetas de la bóveda. Con `parent={id}`, solo las que están dentro de esa página o carpeta. Con `parent=` vacío, solo las de la raíz. ```json [ { "id": "pa1k2m3n4o5p", "title": "Reunión del lunes", "parentId": null, "kind": "pagina", "updatedAt": "2026-10-01T14:03:11.000Z" }, { "id": "pb7q8r9s0t1u", "title": "Proyectos", "parentId": null, "kind": "pasta", "updatedAt": "2026-09-28T10:00:00.000Z" } ] ``` | Campo | Qué es | | ----------- | ---------------------------------------------------------------------------------------- | | `id` | Id de la página. Es el mismo en la app, en Drive y en la API. | | `title` | Título. | | `parentId` | Página o carpeta donde está. `null` en la raíz. | | `kind` | `pagina` (tiene texto) o `pasta` (carpeta, solo agrupa). | | `updatedAt` | Último cambio, en ISO 8601. | | `locked` | `true` en páginas protegidas. Solo aparecen en la lista si el token puede ver su título. | ## Leer una página [#leer-una-página] ```http GET /vaults/{boveda}/pages/{id} GET /vaults/{boveda}/pages/{id}?format=md ``` ```json { "id": "pa1k2m3n4o5p", "title": "Reunión del lunes", "parentId": null, "kind": "pagina", "updatedAt": "2026-10-01T14:03:11.000Z", "markdown": "## Orden del día\n\n- [ ] Revisar presupuesto @2026-10-06 10:00\n- [x] Enviar acta", "props": { "tags": "trabajo" } } ``` Con `?format=md`, la respuesta es solo el texto en Markdown (`text/markdown`), empezando por el título. Sirve para pegarlo directo en una IA. `props` trae las propiedades del frontmatter de la página. El formato del Markdown está en [Formato de las páginas](/es/api/formato-das-paginas). Una página protegida con contraseña siempre responde `423`. ## Crear una página o carpeta [#crear-una-página-o-carpeta] ```http POST /vaults/{boveda}/pages Content-Type: application/json ``` ```json { "title": "Ideas para el fin de semana", "markdown": "- Caminata el sábado\n- [ ] Comprar pan", "parentId": "pb7q8r9s0t1u", "kind": "pagina" } ``` | Campo | Obligatorio | Reglas | | ---------- | ----------- | ------------------------------------------------ | | `title` | No | Hasta 200 caracteres. Vacío pasa a "Sin título". | | `markdown` | No | Hasta 1 MB. Se ignora en carpetas. | | `parentId` | No | Id de una página o carpeta de la misma bóveda. | | `kind` | No | `pagina` (por defecto) o `pasta`. | Respuesta: ```json { "id": "pc2v3w4x5y6z", "title": "Ideas para el fin de semana", "kind": "pagina" } ``` Necesita el permiso **Leer y editar** en la bóveda. La página aparece en la app de la persona en la siguiente sincronización. ## Editar una página [#editar-una-página] ```http PATCH /vaults/{boveda}/pages/{id} Content-Type: application/json ``` Envía uno o más de estos campos: | Campo | Qué hace | | ---------- | ------------------------------------------------------ | | `title` | Cambia el título. | | `markdown` | Reemplaza todo el texto. | | `append` | Agrega texto al final, después de una línea en blanco. | ```json { "append": "## Actualización\n\nSe aprobó el presupuesto." } ``` Prefiere `append` siempre que puedas. No borra nada de lo que la persona escribió mientras tu programa trabajaba. Las carpetas no tienen texto: un `PATCH` en una carpeta con `markdown` o `append` responde `400`. ## Mandar a la papelera [#mandar-a-la-papelera] ```http DELETE /vaults/{boveda}/pages/{id} ``` ```json { "ok": true, "lixeira": true } ``` La página va a la papelera del Google Drive de la persona, y se puede recuperar desde ahí. En copias para IA, la página queda marcada como borrada hasta que la persona la revise. ## Cuándo ve la app los cambios [#cuándo-ve-la-app-los-cambios] Con un token normal, el cambio va directo a Google Drive. La app de la persona lo trae en la siguiente sincronización, que ocurre al abrir la app, al volver a la pestaña y cada cierto tiempo. Si la persona tocó la misma página en su dispositivo al mismo tiempo, no se pierde nada: una de las versiones pasa a ser una copia "(otra versión)". --- # Copias para IA Fuente: https://wire.ia.br/documentation/es/api/copias-para-ia > Cómo funciona el token seguro, la copia aislada de una bóveda y la revisión de los cambios. El token seguro existe para que entregues una bóveda a una IA sin arriesgar el original. La IA trabaja en una copia; tú decides qué vuelve. ## Cómo funciona [#cómo-funciona] **Creas el token seguro** en Configuración → Desarrollador y eliges una bóveda. La app envía al servidor una copia del texto de las páginas de esa bóveda. Las páginas protegidas con contraseña quedan fuera. **La IA usa la API con normalidad.** `GET /vaults` muestra una sola bóveda, con un id de `copia-` y 16 caracteres. Lista, lee, busca, crea, edita y borra páginas en esa copia. **Tú revisas.** En **Copias para IA**, la app muestra cuántos cambios están esperando. **Revisar cambios** lista cada página nueva, editada o borrada, con el texto que dejó la IA. **Eliges qué traer.** Con la bóveda original abierta en la app, marca los cambios que quieres y toca **Traer a la bóveda**. Entran en tu dispositivo y suben a Drive en la siguiente sincronización. Ctrl Z los deshace. **Descartar seleccionados** saca los cambios de la lista sin tocar tu bóveda. ## Para quien programa la IA [#para-quien-programa-la-ia] No cambia nada en la forma de llamar a la API. Usa el id de la copia donde iría el id de la bóveda: ```bash BOVEDA=$(curl -s https://wire.ia.br/api/v1/vaults \ -H "Authorization: Bearer $PAPER_TOKEN" | jq -r '.[0].id') curl "https://wire.ia.br/api/v1/vaults/$BOVEDA/pages" \ -H "Authorization: Bearer $PAPER_TOKEN" ``` Diferencias respecto al token normal: * La búsqueda devuelve un fragmento del texto con cada resultado. * No envía archivos ni toca la agenda (`403` o `400`). * La copia admite hasta 6000 páginas. La bóveda original debe tener hasta 20 MB de texto para copiarse. * Los cambios que la persona haga en la bóveda original después de la copia no aparecen para la IA. Para darle la versión nueva, la persona crea otro token seguro. ## Qué queda guardado [#qué-queda-guardado] La copia queda en el servidor de Paper, en texto abierto, mientras exista el token. Se borra cuando la persona revoca el token o desactiva el modo desarrollador. Revisar no borra la copia: la IA puede seguir trabajando en ella. Esto está en la [política de privacidad](https://wire.ia.br/es/privacidad/). ## Díselo a la IA [#díselo-a-la-ia] Si la IA sabe que trabaja en una copia, se siente más libre para reorganizar y tú te quedas con la última palabra. El botón **Copiar instrucciones para la IA**, que aparece cuando creas el token, ya arma un texto con el token, el ID de la cuenta, la base de la API y el enlace al [mapa de la documentación](https://wire.ia.br/documentation/agents/raw.json). --- # Errores Fuente: https://wire.ia.br/documentation/es/api/erros > Los códigos de respuesta y qué hacer con cada uno. Todo error vuelve en JSON, con un mensaje que se puede mostrar a la persona. El mensaje viene en el idioma del encabezado `Accept-Language` (`pt-BR`, `en` o `es`; portugués si falta): ```json { "error": "Este token solo puede leer esta bóveda." } ``` | Código | Cuándo ocurre | Qué hacer | | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | | `400` | Falta un campo o el formato es incorrecto | Corrige la solicitud. El mensaje dice qué. | | `401` | Token ausente, mal formado, inválido, revocado o vencido | Pídele un token nuevo a la persona. No reintentes con el mismo. | | `403` | Sin permiso para la bóveda, la agenda o los adjuntos; cuenta distinta de la indicada en `X-Paper-Account`; modo desarrollador desactivado; cuenta baneada | No insistas. Avisa a la persona de lo que falta. | | `404` | Bóveda o página no encontradas | Revisa los ids con `GET /vaults` y `GET /vaults/{boveda}/pages`. Las bóvedas deben estar sincronizadas con Google Drive. | | `409` | Google o la agenda no se habilitaron para la API, o la persona revocó el acceso en Google | La persona debe abrir la app y habilitarlo de nuevo en Configuración → Desarrollador. | | `413` | Archivo o texto demasiado grande | Divídelo o redúcelo. Mira [Límites](/es/api/limites). | | `423` | Página protegida con contraseña | Deja la página en paz. Ningún token la abre. | | `429` | Límite de solicitudes o de envíos | Espera y vuelve a intentar, con intervalos crecientes. | | `500` | Un error de nuestro lado | Vuelve a intentar en unos minutos. Si se repite, avisa a [soporte](https://wire.ia.br/es/soporte/). | | `502` | Google Drive o Google Calendar fallaron | Vuelve a intentar más tarde. | | `503` | Servicio en mantenimiento | Vuelve a intentar más tarde. | ## Reintentar [#reintentar] Solo vale la pena reintentar en `429`, `500`, `502` y `503`. Usa intervalos crecientes y un tope de intentos. Los demás códigos no cambian solos. --- # Ejemplos Fuente: https://wire.ia.br/documentation/es/api/exemplos > Código listo en curl, JavaScript y Python, desde la primera solicitud hasta una automatización completa. Todos los ejemplos leen el token y el ID de la cuenta de variables de entorno: ```bash export PAPER_TOKEN="paper_…" export PAPER_CUENTA="3f2a…" ``` ## Un cliente mínimo [#un-cliente-mínimo] ```js // Node 18+ o navegador. Sin dependencias. const BASE = 'https://wire.ia.br/api/v1'; async function paper(path, { method = 'GET', body, intentos = 4 } = {}) { for (let i = 0; ; i++) { const res = await fetch(BASE + path, { method, headers: { Authorization: `Bearer ${process.env.PAPER_TOKEN}`, 'X-Paper-Account': process.env.PAPER_CUENTA, 'Accept-Language': 'es', ...(body ? { 'Content-Type': 'application/json' } : {}), }, body: body ? JSON.stringify(body) : undefined, }); if (res.ok) return res.status === 204 ? null : res.json(); const { error } = await res.json().catch(() => ({ error: res.statusText })); const vale = [429, 500, 502, 503].includes(res.status) && i < intentos; if (!vale) throw new Error(`${res.status}: ${error}`); await new Promise((r) => setTimeout(r, 2000 * 2 ** i)); } } const yo = await paper('/me'); console.log(`Conectado como ${yo.conta.nome}, token ${yo.token.tipo}`); ``` ```python # Python 3.9+. Necesita: pip install requests import os, time, requests BASE = "https://wire.ia.br/api/v1" SESION = requests.Session() SESION.headers.update({ "Authorization": f"Bearer {os.environ['PAPER_TOKEN']}", "X-Paper-Account": os.environ["PAPER_CUENTA"], "Accept-Language": "es", }) def paper(ruta, metodo="GET", json=None, intentos=4): for i in range(intentos + 1): res = SESION.request(metodo, BASE + ruta, json=json, timeout=30) if res.ok: return res.json() if res.content else None if res.status_code not in (429, 500, 502, 503) or i == intentos: raise RuntimeError(f"{res.status_code}: {res.json().get('error')}") time.sleep(2 * 2 ** i) yo = paper("/me") print(f"Conectado como {yo['conta']['nome']}, token {yo['token']['tipo']}") ``` ```bash paper() { curl -sS "https://wire.ia.br/api/v1$1" \ -H "Authorization: Bearer $PAPER_TOKEN" \ -H "X-Paper-Account: $PAPER_CUENTA" \ -H "Accept-Language: es" \ -H "Content-Type: application/json" "${@:2}" } paper /me paper /vaults ``` ## Crear la página del día [#crear-la-página-del-día] Crea una página con la fecha de hoy en una carpeta "Diario del script", si todavía no existe. ```js const hoy = new Date().toISOString().slice(0, 10); const paginas = await paper('/vaults/principal/pages'); let carpeta = paginas.find((p) => p.kind === 'pasta' && p.title === 'Diario del script'); if (!carpeta) { carpeta = await paper('/vaults/principal/pages', { method: 'POST', body: { title: 'Diario del script', kind: 'pasta' }, }); } if (!paginas.some((p) => p.parentId === carpeta.id && p.title === hoy)) { await paper('/vaults/principal/pages', { method: 'POST', body: { title: hoy, parentId: carpeta.id, markdown: `## Para hoy\n\n- [ ] \n\n## Notas\n`, }, }); } ``` ```python from datetime import date hoy = date.today().isoformat() paginas = paper("/vaults/principal/pages") carpeta = next((p for p in paginas if p["kind"] == "pasta" and p["title"] == "Diario del script"), None) if carpeta is None: carpeta = paper("/vaults/principal/pages", "POST", {"title": "Diario del script", "kind": "pasta"}) if not any(p["parentId"] == carpeta["id"] and p["title"] == hoy for p in paginas): paper("/vaults/principal/pages", "POST", { "title": hoy, "parentId": carpeta["id"], "markdown": "## Para hoy\n\n- [ ] \n\n## Notas\n", }) ``` ## Agregar a una página [#agregar-a-una-página] ```bash paper /vaults/principal/pages/pa1k2m3n4o5p -X PATCH \ -d '{"append": "- [ ] Llamar al proveedor @2026-10-07 10:00"}' ``` ## Leer todo el contenido de una carpeta para una IA [#leer-todo-el-contenido-de-una-carpeta-para-una-ia] ```python def texto_de_la_carpeta(boveda, carpeta_id): partes = [] for p in paper(f"/vaults/{boveda}/pages?parent={carpeta_id}"): if p["kind"] == "pagina" and not p.get("locked"): pagina = paper(f"/vaults/{boveda}/pages/{p['id']}") partes.append(f"# {pagina['title']}\n\n{pagina['markdown']}") return "\n\n---\n\n".join(partes) ``` Las carpetas con muchas páginas gastan una solicitud por página. Para 60 páginas o más, reparte las lecturas a lo largo de unos minutos. ## Crear un evento a partir de una tarea [#crear-un-evento-a-partir-de-una-tarea] ```js await paper('/calendar/events', { method: 'POST', body: { title: 'Llamar al proveedor', date: '2026-10-07', time: '10:00', durationMinutes: 15 }, }); ``` ## Enviar una imagen y ponerla en una página [#enviar-una-imagen-y-ponerla-en-una-página] ```bash RESPUESTA=$(curl -sS -X POST "https://wire.ia.br/api/v1/vaults/principal/files?name=grafico.png" \ -H "Authorization: Bearer $PAPER_TOKEN" \ -H "X-Paper-Account: $PAPER_CUENTA" \ -H "Content-Type: image/png" \ --data-binary @grafico.png) MD=$(echo "$RESPUESTA" | jq -r .markdown) paper /vaults/principal/pages/pa1k2m3n4o5p -X PATCH -d "$(jq -n --arg md "$MD" '{append: $md}')" ``` ## Una herramienta para un agente (Claude, OpenAI y otros) [#una-herramienta-para-un-agente-claude-openai-y-otros] Una definición de herramienta en formato JSON Schema, que la mayoría de los modelos acepta: ```json { "name": "paper_agregar", "description": "Agrega texto en Markdown al final de una página del cuaderno Paper de la persona.", "input_schema": { "type": "object", "properties": { "boveda": { "type": "string", "description": "Id de la bóveda, de GET /vaults" }, "pagina": { "type": "string", "description": "Id de la página, de GET /vaults/{boveda}/pages" }, "texto": { "type": "string", "description": "Markdown a agregar" } }, "required": ["boveda", "pagina", "texto"] } } ``` Al ejecutar, llama a `PATCH /vaults/{boveda}/pages/{pagina}` con `{"append": texto}`. --- # Formato de las páginas Fuente: https://wire.ia.br/documentation/es/api/formato-das-paginas > El Markdown que la API lee y escribe, con tablas, tableros, cronogramas, gráficos, fechas y enlaces. Cada página es Markdown común, legible en cualquier editor. Los bloques que el Markdown no tiene pasan a ser bloques de código con nombres propios, y la app los vuelve a convertir en bloques interactivos. Los nombres de los bloques y las palabras clave (`paper-kanban`, `tipo`, `título`, `[!nota]`) son iguales en todos los idiomas, porque forman parte del formato del archivo. ## Básico [#básico] ````md ## Título de sección Texto con **negrita**, *cursiva*, ~~tachado~~ y `código`. - Lista 1. Lista numerada - [ ] Tarea abierta - [x] Tarea hecha > Cita > [!nota] > Destacado (callout) ```js console.log('bloque de código') ``` --- ```` ## Enlaces, fechas y adjuntos [#enlaces-fechas-y-adjuntos] | Escribe | Pasa a ser | | ----------------------------------------- | ---------------------------------------------------------- | | `[[Nombre de la página]]` | Enlace a otra página de la bóveda | | `[[Nombre de la página\|texto]]` | Enlace con otro texto | | `@2026-10-06` | Fecha. En una tarea, aparece en la Agenda de la app | | `@2026-10-06 14:30` | Fecha con hora | | `![foto.png](Anexos/a3f9c21b7e-foto.png)` | Imagen enviada por la [API de adjuntos](/es/api/anexos) | | `#etiqueta` | Etiqueta, que aparece en los filtros de búsqueda de la app | Las fechas en el archivo siempre son `AAAA-MM-DD`, sea cual sea el idioma de la app. ## Tabla [#tabla] Una tabla de Markdown normal. Un comentario opcional antes de ella guarda el tipo de cada columna (`texto`, `numero`, `data`, `check`, `opcao`): ```md | Tarea | Plazo | Hecha | | --- | --- | --- | | Presupuesto | 2026-10-06 | sim | ``` ## Tablero (Kanban) [#tablero-kanban] Cada `##` es una columna; cada elemento es una tarjeta. ````md ```paper-kanban ## Por hacer - [ ] Revisar contrato ## En curso - [ ] Escribir informe ## Hecho - [x] Agendar reunión ``` ```` ## Cronograma [#cronograma] Una etapa por línea: inicio, fin y nombre. ````md ```paper-cronograma - [x] 2026-10-01 → 2026-10-05 · Planificar - [ ] 2026-10-04 → 2026-10-15 · Hacer - [ ] 2026-10-14 → 2026-10-20 · Revisar ``` ```` `->` y `até` también funcionan en lugar de `→`. ## Gráfico [#gráfico] Tipo (`barras`, `linhas` líneas, `area`, `pizza` circular), un título opcional y una tablita separada por `;`. La primera línea da los nombres de las series. ````md ```paper-grafico tipo: barras título: Gastos del trimestre Mes; Mercado; Transporte Jul; 820; 210 Ago; 790; 180 Sep; 845; 230 ``` ```` ## Frontmatter [#frontmatter] Las propiedades de la página quedan en un bloque `---` al comienzo del archivo. La API devuelve esas propiedades en `props`, y no necesitas enviar el frontmatter al crear o editar: envía solo el texto. ## Páginas protegidas [#páginas-protegidas] En el archivo `.md`, una página con contraseña pasa a ser un bloque cifrado que solo la app abre con la contraseña. La API no lee ni escribe esas páginas (`423`). --- # Límites Fuente: https://wire.ia.br/documentation/es/api/limites > Cuántas solicitudes, cuántos archivos y de qué tamaño. | Límite | Valor | Vale para | | ------------------------------ | ----- | ---------------------------------------- | | Solicitudes por minuto | 60 | Cada token | | Solicitudes por día | 5000 | Cada token, se reinicia a medianoche UTC | | Envíos de archivos por día | 30 | Cada token | | Tamaño de un archivo | 10 MB | Cada envío | | Texto de una página | 1 MB | `markdown` y `append` | | Cuerpo de una solicitud JSON | 2 MB | Cada solicitud | | Tokens activos | 20 | Cada cuenta | | Texto de una bóveda para copia | 20 MB | Token seguro | | Páginas en una copia | 6000 | Token seguro | | Resultados de búsqueda | 50 | Cada búsqueda | | Eventos por listado | 250 | Agenda | Los límites también aparecen en `GET /me`, en el campo `limites`. ## Cuando te pasas del límite [#cuando-te-pasas-del-límite] La API responde `429` con un mensaje que dice qué límite se alcanzó. El mensaje sigue `Accept-Language`: ```json { "error": "Límite de 60 solicitudes por minuto. Espera un poco." } ``` Espera y vuelve a intentar, con intervalos crecientes: 2 segundos, luego 4, 8, 16. Si es el límite del día, detente hasta el día siguiente. ## Uso normal [#uso-normal] Un uso normal, como un asistente que organiza notas o un script que crea la página del día, queda muy por debajo de estos números. Esquivar los límites con varios tokens o varias cuentas viola los términos y lleva al baneo. Mira [Uso justo](/es/termos/uso-justo). Si tienes un caso real que necesita más, escribe a [soporte](https://wire.ia.br/es/soporte/) eligiendo el asunto **API y tokens de acceso**. --- # Modo desarrollador Fuente: https://wire.ia.br/documentation/es/api/modo-desenvolvedor > El interruptor que habilita tokens, envío de archivos, cambios en la agenda y automatizaciones remotas. La app sigue igual con el modo desarrollador activado. Solo habilita los tokens de acceso. Sin él, ningún token funciona, ni los que ya existen. ## Activar [#activar] Abre **Configuración → Desarrollador**. Lee los [términos de uso de la API](/es/termos/termos-da-api), marca la casilla de aceptación y toca **Activar el modo desarrollador**. Copia el ID de tu cuenta, que aparece arriba. Va en el encabezado `X-Paper-Account` y confirma que el token es tuyo. Mira [Autenticación](/es/api/autenticacao). ## Habilitar Google para la API [#habilitar-google-para-la-api] Los tokens normales leen y escriben en las bóvedas reales por tu Google Drive. Para eso, el servidor necesita guardar tu conexión con Google. * **Google Drive para la API**: conecta Google en **Sincronización** y toca **Habilitar la conexión de este dispositivo para la API**. * **Agenda para la API**: conecta Google Calendar en **Integraciones** y toca **Habilitar la agenda "Paper" para la API**. El servidor actúa en tu Drive y en tu agenda solo cuando se usa un token tuyo. Los tokens seguros no necesitan nada de esto. ## Qué habilita el modo [#qué-habilita-el-modo] | Función | Sin el modo | Con el modo | | ------------------------------------------------------- | ------------ | -------------------------------- | | Tokens de acceso | No funcionan | Hasta 20 activos | | Leer y escribir páginas desde un programa | No | Donde el token lo permita | | Enviar archivos por la API | No | Hasta 30 por día, 10 MB cada uno | | Crear y borrar eventos en la agenda "Paper" | No | Si el token lo permite | | Automatizaciones remotas (scripts, servidores, agentes) | No | Sí | ## Cuando cambian los términos [#cuando-cambian-los-términos] Si los términos de la API tienen una versión nueva, tus tokens se pausan hasta que la aceptes en **Configuración → Desarrollador**. La API responde `403` con un mensaje que lo explica. ## Desactivar [#desactivar] **Desactivar el modo desarrollador** revoca todos los tokens al instante, borra las copias para IA y borra la conexión con Google guardada en el servidor. Tus notas no cambian. ## Cuenta baneada [#cuenta-baneada] Si la cuenta es baneada por violar los términos, todos los tokens se revocan, los enlaces publicados se retiran y la conexión con Google guardada en el servidor se borra. Mira [Baneo y apelación](/es/termos/banimento-e-apelacao). --- # Tokens de acceso Fuente: https://wire.ia.br/documentation/es/api/tokens > Los dos tipos de token, los permisos de cada uno y cómo guardarlos y revocarlos. Un token es una clave que le entregas a un programa. Tiene este formato: ```txt paper_k3m9x2ab_Q7wLc2…(40 caracteres) ``` * `paper_` marca que es un token de Paper. Las herramientas que buscan secretos filtrados reconocen ese comienzo. * Los 8 caracteres del medio identifican el token. Aparecen en la lista de tokens, para que sepas cuál es cuál. * Los 40 del final son el secreto. El servidor guarda solo un resumen (hash), así que ni Paper puede mostrar el token de nuevo. Si lo pierdes, revócalo y crea otro. ## Los dos tipos [#los-dos-tipos] | | Seguro (para IA) | Normal | | -------------------------------------- | --------------------------------------- | ------------------------------------ | | Para qué | Darle una bóveda a una IA para trabajar | Tus automatizaciones | | Qué alcanza | Una copia aislada de una bóveda | Las bóvedas reales, por Google Drive | | Cambios | Esperan tu revisión | Valen al instante | | Agenda y archivos | No | Si lo permites | | Necesita Google habilitado para la API | No | Sí | Ante la duda, usa el **seguro**. Si la IA se equivoca, la bóveda real sigue intacta. ## Permisos [#permisos] Al crear un token normal, eliges: | Permiso | Opciones | | ------------------ | --------------------------------------------------------------- | | Cada bóveda | Sin acceso, Leer, Leer y editar | | Páginas protegidas | Ocultar (el token ni sabe que existen) o Mostrar solo el título | | Agenda "Paper" | Sin acceso, Leer eventos, Leer y crear eventos | | Enviar archivos | Sí o no | | Validez | 7 días, 30 días, 90 días o sin vencimiento | Incluso con "Mostrar solo el título", el contenido de las páginas protegidas nunca sale: la solicitud responde `423`. El token seguro tiene permisos fijos: lee y edita solo su propia copia. ## Ver cómo aparece el token para la API [#ver-cómo-aparece-el-token-para-la-api] ```bash curl https://wire.ia.br/api/v1/me -H "Authorization: Bearer $PAPER_TOKEN" ``` ```json { "conta": { "id": "3f2a…(32 caracteres)", "nome": "Ana" }, "token": { "id": "k3m9x2ab", "nome": "Script de tareas", "tipo": "normal", "permissoes": { "vaults": { "principal": "editar", "cmg2k1x9a4tz": "ler" }, "protegidas": "ocultar", "agenda": "ler", "anexos": false }, "venceEm": "2026-11-01T12:00:00.000Z" }, "limites": { "perMinute": 60, "perDay": 5000, "uploadsPerDay": 30, "uploadBytes": 10485760, "pageBytes": 1048576 }, "documentacao": "https://wire.ia.br/documentation/agents/raw.json" } ``` Los nombres y valores de los campos están en portugués: `tipo` es `seguro` o `normal`; el acceso a una bóveda es `ler` (leer) o `editar`; `protegidas` es `ocultar` o `titulo` (solo el título); `agenda` es `nenhum` (ninguno), `ler` o `editar`. ## Guárdalo con cuidado [#guárdalo-con-cuidado] * Guárdalo en una variable de entorno o en un gestor de contraseñas. Nunca en código público, capturas de pantalla ni mensajes en grupos. * Un token por programa. Así, revocar uno no tumba a los otros. * Da solo los permisos que el programa necesita. ## Revocar [#revocar] En **Configuración → Desarrollador → Tokens activos**, toca **Revocar**. El token deja de funcionar en la siguiente solicitud. La lista también muestra cuándo se usó cada token por última vez y cuántas veces. Un token filtrado y usado para abuso lleva al baneo de la cuenta dueña. Si sospechas una filtración, revócalo antes que cualquier otra cosa. --- # Visión general de la API Fuente: https://wire.ia.br/documentation/es/api/visao-geral > Qué hace la API personal, para quién es y el camino más corto hasta la primera solicitud. La API personal deja que un programa o un agente de IA lea y escriba en el cuaderno de **una persona**, con un token que esa persona creó y puede revocar en cualquier momento. No existe API para leer datos de otras cuentas, ni acceso de terceros sin un token. ```txt Base: https://wire.ia.br/api/v1 Formato: JSON (UTF-8). Archivos: cuerpo binario. Autenticación: Authorization: Bearer paper_… Idioma de los errores: Accept-Language: es (o pt-BR, en) ``` Los nombres de los campos de la API están en portugués (`conta`, `titulo`, `permissoes`…), iguales para todos los idiomas. Los mensajes de error siguen `Accept-Language`. ## El camino más corto [#el-camino-más-corto] **Activa el modo desarrollador** en Configuración → Desarrollador y acepta los [términos de la API](/es/termos/termos-da-api). Mira [Modo desarrollador](/es/api/modo-desenvolvedor). **Crea un token.** Elige el tipo (seguro para IA, normal para automatizaciones), las bóvedas y lo que puede hacer. Mira [Tokens](/es/api/tokens). **Haz la primera solicitud:** ```bash curl https://wire.ia.br/api/v1/me \ -H "Authorization: Bearer $PAPER_TOKEN" \ -H "X-Paper-Account: $PAPER_CUENTA" \ -H "Accept-Language: es" ``` La respuesta muestra la cuenta, los permisos del token y los límites. ## Qué se puede hacer [#qué-se-puede-hacer] | Área | Endpoints | Página | | ----------------- | ------------------------------------------------------------------------------------------------ | --------------------------------------------- | | Cuenta | `GET /me` | [Autenticación](/es/api/autenticacao) | | Bóvedas y páginas | `GET /vaults`, `GET/POST /vaults/{boveda}/pages`, `GET/PATCH/DELETE /vaults/{boveda}/pages/{id}` | [Bóvedas y páginas](/es/api/cofres-e-paginas) | | Búsqueda | `GET /vaults/{boveda}/search?q=` | [Búsqueda](/es/api/busca) | | Archivos | `POST /vaults/{boveda}/files?name=` | [Adjuntos](/es/api/anexos) | | Agenda | `GET/POST /calendar/events`, `DELETE /calendar/events/{id}` | [Agenda](/es/api/agenda) | ## Dónde viven los datos [#dónde-viven-los-datos] Las notas personales no quedan en el servidor de Paper. Quedan en el dispositivo de la persona y en su Google Drive. Por eso: * **Token normal**: el servidor lee y escribe en el Google Drive de la persona en el momento de la solicitud, usando la conexión que ella habilitó para la API. Solo aparecen las bóvedas sincronizadas con Drive. * **Token seguro**: el servidor guarda una copia aislada de una bóveda, creada cuando la persona hizo el token. La IA trabaja en esa copia, y la persona decide qué llevar a la bóveda real. Mira [Copias para IA](/es/api/copias-para-ia). ## Lo que ningún token hace [#lo-que-ningún-token-hace] * Abrir páginas protegidas con contraseña (`423`). * Leer grupos, que están cifrados de extremo a extremo. * Tocar la cuenta, las sesiones, las amistades o la configuración. ## Para agentes de IA [#para-agentes-de-ia] El mapa completo de la documentación, con reglas y endpoints, está en [`/documentation/agents/raw.json`](https://wire.ia.br/documentation/agents/raw.json). Antes de actuar, lee [Agentes de IA](/es/api/agentes-de-ia). --- # Bóvedas, carpetas y páginas Fuente: https://wire.ia.br/documentation/es/guia/cofres-pastas-e-paginas > Tres formas de organizar, de la más grande a la más pequeña. ## Bóvedas [#bóvedas] Una bóveda es un cuaderno entero y separado de los demás: páginas, búsqueda, mapa y agenda propios. Úsala para separar mundos que no se mezclan, como trabajo y vida personal. * Cambia de bóveda desde arriba de la barra lateral. * Cada bóveda se sincroniza en una carpeta propia dentro de la carpeta Paper de tu Google Drive. * Todo cuaderno empieza con la bóveda **principal**. ## Carpetas [#carpetas] Las carpetas guardan páginas y otras carpetas. Una carpeta no tiene texto: al abrirla, muestra lo que tiene dentro, con botones para crear página, crear carpeta e importar archivos `.md` ahí mismo. * **Crear**: botón de carpeta arriba de la barra lateral, o **Nueva carpeta** dentro de otra carpeta. Una carpeta nueva abre con el nombre seleccionado: solo tienes que escribir encima. * **Mover**: arrastra en la barra lateral, o usa **Mover** en el menú de la página. * **En Google Drive**: cada carpeta de Paper se vuelve una carpeta de verdad, con los archivos de las páginas dentro. ## Páginas dentro de páginas [#páginas-dentro-de-páginas] Una página también puede tener páginas dentro, como capítulos. La diferencia con la carpeta es que la página madre tiene texto propio. | Quiero… | Usa | | ------------------------------- | ------------------------- | | Separar trabajo y vida personal | Bóvedas | | Agrupar varias páginas por tema | Carpeta | | Un documento con capítulos | Página con páginas dentro | ## Favoritas, Bandeja de entrada y Diario [#favoritas-bandeja-de-entrada-y-diario] * Las **favoritas** quedan arriba de la barra lateral. Usa la estrella arriba de la página. * La **Bandeja de entrada** recibe lo que anotas rápido con Ctrl Shift Espacio. * **Hoy** abre la página del día, dentro de la carpeta Diario. --- # Empieza aquí Fuente: https://wire.ia.br/documentation/es/guia/comece-por-aqui > Tus primeros diez minutos en Paper, paso a paso y sin términos técnicos. Cuando creas la cuenta, el cuaderno ya viene con la página **Empieza aquí** y una carpeta **Guías**. Repiten lo que está en esta página, dentro de la propia app. Puedes borrarlas cuando quieras: las guías siguen en **Configuración → Acerca de → Guías**. ### Escribe [#escribe] Haz clic en cualquier línea y escribe. Enter crea una línea nueva. No hay botón de guardar: Paper guarda solo, en este dispositivo, incluso sin internet. ### Elige el tipo de línea con la barra / [#elige-el-tipo-de-línea-con-la-barra-] En una línea vacía, escribe `/` y elige: título, lista, tarea, cita, destacado, tabla, tablero, cronograma, gráfico, imagen o archivo. ### Enlaza una página con otra [#enlaza-una-página-con-otra] Escribe `[[` y el nombre de una página. El enlace acompaña a la página cuando le cambias el nombre. Al final de cada página aparece dónde fue mencionada. ### Agrega fechas [#agrega-fechas] Escribe `@` y una fecha, como `@mañana 14h`. La línea aparece en la **Agenda** el día correcto. Paper entiende fechas en español, portugués e inglés. ### Organiza en carpetas [#organiza-en-carpetas] En la barra lateral, el botón de carpeta crea una carpeta nueva. Arrastra páginas dentro de ella. Puede haber carpetas dentro de carpetas. ### Llévalo a otros dispositivos [#llévalo-a-otros-dispositivos] En **Configuración → Sincronización**, conecta Google Drive una vez. Cada página se vuelve un archivo en la carpeta Paper de tu Drive, y el celular y la computadora quedan iguales. Mira [Sincronizar con Google Drive](/es/guia/sincronizar). ## Atajos que valen la pena [#atajos-que-valen-la-pena] | Atajo | Qué hace | | ------------------ | ------------------------------------------------- | | Ctrl K | Buscar cualquier cosa | | Ctrl Z | Deshacer, hasta borrar una página | | Ctrl Shift Espacio | Nota rápida, sin elegir página | | Ctrl Shift L | Alternar entre leer y editar | | Esc | Seleccionar el bloque; Shift ↑↓ selecciona varios | En Mac, cambia Ctrl por Cmd. ## Notas rápidas [#notas-rápidas] Ctrl Shift Espacio abre una cajita para anotar sin pensar dónde guardar. Todo cae en la **Bandeja de entrada** y lo organizas después. ## Tu idioma [#tu-idioma] La app habla español, portugués e inglés. Cámbialo en **Configuración → Apariencia → Idioma y región**: la elección vale para todos tus dispositivos. Fechas, horas y números siguen tu región. ## Próximos pasos [#próximos-pasos] * [Escribir y leer](/es/guia/escrever-e-ler): los bloques, el modo lectura y las plantillas de página. * [Bóvedas, carpetas y páginas](/es/guia/cofres-pastas-e-paginas): cómo separar trabajo, estudio y vida personal. * [Privacidad y seguridad](/es/guia/privacidade-e-seguranca): páginas con contraseña y lo que Paper puede ver. --- # Compartir una página Fuente: https://wire.ia.br/documentation/es/guia/compartilhar > Enlaces públicos de lectura, con versión en texto plano para IAs y programas. El botón **Compartir** arriba de la página crea un enlace a ella. Quien abre el enlace ve solo esa página, en modo lectura, sin necesitar cuenta. ## Opciones [#opciones] * **Validez**: 1 día, 7 días, 30 días o sin plazo. * **En vivo**: el enlace acompaña tus cambios unos segundos después. Desactivado, el enlace muestra la página como estaba al publicar, y la actualizas cuando quieras. * **Retirar**: el enlace deja de funcionar al instante. Todos los enlaces publicados están en **Configuración → Enlaces publicados**. ## Texto plano para IAs y programas [#texto-plano-para-ias-y-programas] Todo enlace tiene dos versiones sin diseño, buenas para pegar en una IA o leer desde un programa: | Dirección | Qué devuelve | | ---------------------------------- | ----------------------------------------------------------------------- | | `https://wire.ia.br/s/codigo` | La página para personas | | `https://wire.ia.br/s/codigo.md` | Solo el Markdown | | `https://wire.ia.br/s/codigo.json` | Título, texto plano, Markdown, bloques, idioma y fecha de actualización | La ventana de compartir tiene botones para copiar cada versión. La página mantiene el idioma en que fue escrita. Lo que la rodea (barra de arriba, fecha, pie) aparece en el idioma de quien visita. ## Lo que no se puede compartir [#lo-que-no-se-puede-compartir] * **Páginas protegidas con contraseña.** Quita la contraseña antes, si de verdad quieres publicar. * **Contenido ilegal, spam o datos personales de otras personas.** Los enlaces así se retiran y la cuenta es baneada. Mira los [términos](/es/termos/uso-justo). ## Lo que queda en el servidor [#lo-que-queda-en-el-servidor] El texto de una página compartida queda guardado en el servidor de Paper, sin cifrado, mientras el enlace exista. Es el precio de que cualquiera pueda abrirla. Cuando la retiras o vence el plazo, la copia se borra. Los enlaces no aparecen en Google ni en otros buscadores. ## Denunciar una página [#denunciar-una-página] ¿Encontraste un enlace de Paper con contenido que viola los términos? Usa el enlace **Denunciar** al pie de la página publicada, o abre el [soporte](https://wire.ia.br/es/soporte/) y elige el asunto **Denunciar una nota publicada**. --- # Escribir y leer Fuente: https://wire.ia.br/documentation/es/guia/escrever-e-ler > Bloques, modo edición, modo lectura, plantillas y el menú de cada página. ## Bloques [#bloques] Cada línea de una página es un bloque. La barra `/` en una línea vacía muestra todos los tipos: | Bloque | Para qué | | --------------------- | --------------------------------------------------------------------------------- | | Texto, títulos | Lo básico. `#`, `##` y `###` al principio de la línea también se vuelven títulos. | | Lista, lista numerada | `-` o `1.` al principio de la línea. | | Tarea | `[ ]` al principio de la línea. Aparece en la Agenda si tiene fecha. | | Cita y destacado | Para llamar la atención sobre un fragmento. | | Código | Texto con espaciado fijo, con color según el lenguaje. | | Tabla | Columnas con tipo (texto, número, fecha, casilla, opción) y suma al pie. | | Tablero | Columnas con tarjetas que arrastras, como un Kanban. | | Cronograma | Etapas con inicio y fin en una línea de tiempo. | | Gráfico | Barras, líneas, área o torta, a partir de una tablita. | | Imagen y archivo | Arrastra desde la computadora a la página. | Arrastrar un archivo `.md` o `.txt` dentro de una página trae su texto como bloques. Los otros archivos se vuelven adjuntos. La barra `/` entiende nombres de bloques en español, portugués e inglés: `/tabla`, `/tabela` y `/table` funcionan. ## Modo edición y modo lectura [#modo-edición-y-modo-lectura] El botón **Leer** arriba de la página activa el modo lectura. En él, ningún clic cambia el texto: bueno para consultar en el celular, presentar en una reunión o revisar sin miedo. Las tareas y los tableros también quedan trabados. * **Ctrl Shift L** alterna entre leer y editar. * Paper recuerda la elección de cada página. * Para abrir todo en modo lectura por defecto: **Configuración → Editor → Abrir páginas en modo lectura**. ## Plantillas [#plantillas] Una página vacía muestra plantillas listas: reunión, proyecto, lista de tareas, lectura de libro, estudio y plan de la semana. Haz clic en una para empezar con la estructura armada. ## Menú de la página [#menú-de-la-página] Los tres puntos arriba de la página abren el menú: * **Ícono**: elige un emoji que aparece en la barra lateral y arriba del título. * **Duplicar**: crea una copia justo abajo. * **Mover**: lleva la página a otra carpeta o dentro de otra página. * **Copiar enlace interno**: copia el `[[enlace]]` para pegar en otra página. * **Compartir**: crea un enlace público. Mira [Compartir](/es/guia/compartilhar). Al lado de la fecha de edición, la página muestra cuántas palabras tiene y cuánto tiempo lleva leerla. ## Descargar una página [#descargar-una-página] El botón de exportar arriba de la página descarga solo esa página, en `.md`, PDF o Word. --- # Grupos y amigos Fuente: https://wire.ia.br/documentation/es/guia/grupos > Notas en equipo, cifradas de extremo a extremo, con edición al mismo tiempo. El cuaderno personal y los grupos quedan separados. Lo tuyo sigue siendo solo tuyo; lo del grupo queda en el espacio del grupo. Cambia entre ellos con el selector de arriba de la barra lateral, el mismo de las bóvedas. **Nuevo grupo** está al final de esa lista. ## Amigos [#amigos] Cada cuenta tiene un ID de 32 caracteres, en **Configuración → Perfil**. Para agregar a alguien: * **Por ID**: la persona te pasa su ID y le envías una solicitud. * **Por invitación**: crea un enlace en **Configuración → Amigos**, con plazo y número de usos. Quien abre el enlace se vuelve tu amigo. En **Amigos** eliges quién puede enviarte solicitudes (cualquiera o solo por enlace) y bloqueas a quien quieras. ## Grupos [#grupos] Un grupo es un espacio de páginas compartido. Todos en el grupo ven las mismas páginas y editan al mismo tiempo, viendo quién está en cada página. | Rol | Qué puede hacer | | ---------- | ---------------------------------------------------- | | Dueño | Todo, incluso borrar el grupo | | Administra | Invitar, quitar y cambiar roles de quien está debajo | | Edita | Crear y editar páginas | | Solo lee | Solo leer | Los grupos necesitan internet, ya que la edición es en vivo. El cuaderno personal funciona sin internet. ## Cifrado de extremo a extremo [#cifrado-de-extremo-a-extremo] El contenido de los grupos se cifra en el dispositivo antes de salir. El servidor de Paper reenvía y guarda solo datos revueltos, sin la clave para abrirlos. Por eso: * Ningún token de acceso lee grupos. * Si todos en el grupo pierden la clave, nadie recupera el contenido, ni Paper. ## Sin chat [#sin-chat] Paper no tiene chat. El foco es escribir juntos: para acordar algo sobre una página, escríbelo en la página misma. --- # Importar archivos .md Fuente: https://wire.ia.br/documentation/es/guia/importar > Trae notas en Markdown, carpetas enteras y archivos .zip. Paper lee Markdown común. Puedes traer una nota suelta, una carpeta llena de notas o un `.zip` exportado de otra app. ## Formas de importar [#formas-de-importar] Arrastra archivos `.md` desde tu computadora a la barra lateral. Si los sueltas sobre una carpeta, entran en ella. Si los sueltas dentro de una página abierta, el texto entra como bloques en ese punto. Abre una carpeta y usa **Importar .md aquí**. Los archivos elegidos entran dentro de ella. **Configuración → Importar y exportar → Importar**. Acepta archivos `.md` y `.txt`, carpetas enteras y `.zip`, incluso un `.zip` dentro de otro `.zip`. Antes de importar, Paper muestra cuántas páginas y adjuntos van a entrar. ## Qué viene junto [#qué-viene-junto] * **Carpetas y subcarpetas** se vuelven carpetas de Paper, en el mismo orden. * **Frontmatter** (el bloque `---` de arriba) se vuelve propiedades de la página. * **Enlaces** `[[Página]]` y enlaces Markdown entre archivos se vuelven enlaces de Paper. * **Imágenes y adjuntos** citados en las notas, como `![[foto.png]]` o `![](foto.png)`, vienen juntos. Los archivos que ninguna nota cita quedan fuera. * **Tareas, tablas, callouts y bloques de código** siguen iguales. Cada adjunto puede tener hasta 25 MB. ## Exportar [#exportar] En **Configuración → Importar y exportar**, la opción **Exportar la bóveda entera** genera un `.zip` con todas las páginas en `.md`, organizadas en carpetas. Es el mismo formato que va a Google Drive. Para descargar una sola página, usa el botón de exportar de arriba (`.md`, PDF o Word). --- # Privacidad y seguridad Fuente: https://wire.ia.br/documentation/es/guia/privacidade-e-seguranca > Dónde quedan las notas, qué ve el servidor y cómo cerrar una página. ## Dónde queda cada cosa [#dónde-queda-cada-cosa] | Qué | Dónde | ¿El servidor de Paper lo lee? | | ----------------------------------- | -------------------------------------- | ------------------------------------------ | | Notas personales | En el dispositivo y en tu Google Drive | No | | Páginas protegidas con contraseña | Cifradas, en el dispositivo y en Drive | No, ni con la contraseña equivocada | | Grupos | Cifrados en el servidor | No, solo los reenvía | | Enlaces publicados | En el servidor, en texto abierto | Sí, para mostrarlos a quien abre el enlace | | Copias para IA (token seguro) | En el servidor, en texto abierto | Sí, mientras la copia exista | | Cuenta, idioma, amistades, sesiones | En el servidor | Sí | ## Páginas protegidas [#páginas-protegidas] El candado arriba de una página cierra el contenido con una contraseña tuya. La página se cifra en el dispositivo con una clave sacada de la contraseña y una sal aleatoria, así que: * Ni Paper puede abrirla sin la contraseña. Guárdala bien: no hay recuperación. * Ningún token de acceso abre páginas protegidas. La API responde `423`. * Las páginas protegidas no se pueden publicar por enlace. ## Tokens de acceso [#tokens-de-acceso] Un token solo hace lo que marcaste al crearlo: qué bóvedas, leer o editar, agenda y adjuntos. Lo revocas en **Configuración → Desarrollador**, y se detiene al instante. Detalles en [Tokens](/es/api/tokens). ## Sesiones [#sesiones] En **Configuración → Cuenta y seguridad** ves los dispositivos conectados y cierras los que no reconozcas. ## Traducción automática [#traducción-automática] Si usas la traducción automática del navegador (para idiomas que Paper no habla de forma nativa), Paper marca tus notas y los títulos de las páginas para que el traductor los deje afuera. Solo se traducen los botones y menús de la app. ## Más [#más] * [Política de Privacidad](https://wire.ia.br/es/privacidad/) * [Términos de Uso](https://wire.ia.br/es/terminos/) * [Cookies y almacenamiento local](https://wire.ia.br/es/cookies/) --- # Sincronizar con Google Drive Fuente: https://wire.ia.br/documentation/es/guia/sincronizar > Conéctalo una vez por dispositivo y Paper mantiene iguales el celular y la computadora. Paper guarda todo primero en el dispositivo. La sincronización copia cada página a la carpeta **Paper** de tu Google Drive y trae de vuelta lo que cambió en otro dispositivo. ## Conectar [#conectar] Abre **Configuración → Sincronización** y toca **Conectar Google en este dispositivo**. Se abre una ventana de Google. Elige la cuenta y acepta. Paper pide acceso solo a los archivos que él mismo crea en Drive y a una agenda propia llamada Paper. No ve el resto de tu Drive ni tus otras agendas. Listo. La conexión queda guardada en este dispositivo y no vence sola. Repítelo una vez en cada dispositivo que uses. ## Cómo queda en Drive [#cómo-queda-en-drive] ```txt Paper/ ← bóveda principal Empieza aquí.md Guías/ Si vienes de Obsidian.md Anexos/ a1b2c3d4e5-foto.png Paper · Trabajo/ ← otra bóveda ... ``` La bóveda principal queda en la carpeta **Paper**, y cada otra bóveda tiene la suya, **Paper · nombre de la bóveda**. Cada carpeta de Paper se vuelve una carpeta de Drive, y cada página se vuelve un archivo `.md` que cualquier editor abre. Los adjuntos van a la subcarpeta `Anexos` (el nombre es el mismo en todos los idiomas, para que los enlaces sigan funcionando). Si la misma página cambia en dos dispositivos antes de sincronizar, queda la versión del dispositivo que sincronizó último, y la otra se vuelve una copia "(otra versión)". Nada se pierde. ## Si aparece "Falta conectar" [#si-aparece-falta-conectar] Google puede cortar el acceso si cambias la contraseña de tu cuenta de Google, quitas Paper en [myaccount.google.com/permissions](https://myaccount.google.com/permissions) o pasas muchos meses sin usarlo. En esos casos, toca **Conectar** de nuevo. Nada se pierde: lo que escribiste mientras tanto sigue en el dispositivo y sube en cuanto vuelva la conexión. Sin internet, Paper sigue guardando en el dispositivo y vuelve a intentar sincronizar solo cuando vuelve la conexión. ## Desconectar [#desconectar] En **Configuración → Integraciones**, **Desconectar Google** borra la conexión de este dispositivo y avisa a Google para cancelar el acceso. Los archivos que ya están en tu Drive siguen ahí. ## Quién guarda la conexión [#quién-guarda-la-conexión] La clave que mantiene la conexión queda en tu dispositivo, sellada: solo el servidor de Paper puede abrirla, y solo en el momento de renovar el acceso. El servidor no guarda esa clave, a menos que actives el [modo desarrollador](/es/api/modo-desenvolvedor) y autorices a la API a usar tu Drive. --- # Si vienes de otra app Fuente: https://wire.ia.br/documentation/es/guia/vindo-de-outros-apps > Para quien usaba Obsidian o Notion. Cómo traer las notas y dónde quedó cada cosa. Si vienes de una bóveda de Markdown, casi todo funciona igual. ### Traer la bóveda [#traer-la-bóveda] 1. **Configuración → Importar y exportar → Importar**. 2. Elige la carpeta de la bóveda o un `.zip` de ella. Carpetas, subcarpetas, enlaces, frontmatter, callouts, tareas, tablas e imágenes vienen juntos. 3. Si prefieres mantenerla separada, crea antes una bóveda nueva desde arriba de la barra lateral e importa ahí. ### Dónde quedó cada cosa [#dónde-quedó-cada-cosa] | Usabas | En Paper | | ------------------------------------------------------- | ---------------------------------------------------------------- | | Bóveda | Bóveda, que se cambia arriba de la barra lateral | | `[[Enlace]]`, `[[Enlace\|alias]]`, `[[Enlace#sección]]` | Iguales, y acompañan cuando cambias el nombre | | Backlinks | "Mencionada en", al final de la página, con menciones sin enlace | | Graph view | Mapa de ideas, con el modo "alrededor de una página" | | Daily notes | Botón Hoy, una página por día dentro de Diario | | Command palette | Ctrl K, con filtros como `#etiqueta` y tareas abiertas | | Callouts `> [!nota]` | Bloque Destacado, y el `.md` sigue con `> [!nota]` | | Plugin de Kanban | Bloque Tablero, nativo | | Sync | Google Drive gratis, o grupos con edición en vivo | ### Lo que todavía no hay [#lo-que-todavía-no-hay] * Canvas y consultas que juntan varias páginas. * Plugins de terceros. Para automatizaciones, usa los [tokens de acceso](/es/api/tokens). Si vienes de un workspace con páginas y bases de datos, este es el camino más corto. ### Traer las páginas [#traer-las-páginas] 1. En la app de donde vienes, exporta el workspace como **Markdown & CSV**. 2. En Paper: **Configuración → Importar y exportar → Importar**, y elige el `.zip`. Puede ser un `.zip` dentro de otro `.zip`. 3. Los códigos de 32 letras al final de los nombres desaparecen solos, y los enlaces entre páginas se vuelven `[[enlaces]]`. ### Dónde quedó cada cosa [#dónde-quedó-cada-cosa-1] | Usabas | En Paper | | -------------------- | ------------------------------------------------------------------ | | Páginas y subpáginas | Iguales, y ahora también carpetas de verdad | | `/` para bloques | Igual: `/` abre la lista de bloques | | Tabla simple | Bloque Tabla, con tipos de columna y suma | | Board | Bloque Tablero | | Timeline | Bloque Cronograma | | `@fecha` | `@fecha` se vuelve fecha en la Agenda | | Teamspace | Grupos, cifrados de extremo a extremo, con edición al mismo tiempo | | Share to web | Botón Compartir, con versión en texto plano para IAs | | Asistente de IA | Tokens de acceso: tu IA lee y escribe solo donde tú lo permitas | ### La diferencia principal [#la-diferencia-principal] Tus notas personales no quedan en un servidor de Paper. Quedan en tu dispositivo y, si lo conectas, en tu Google Drive, en archivos `.md` que cualquier editor abre. ### Lo que todavía no hay [#lo-que-todavía-no-hay-1] * Bases de datos que juntan varias páginas. * Los archivos `.csv` exportados quedan fuera por ahora. --- # Documentación de Paper Fuente: https://wire.ia.br/documentation/es > Cómo usar el cuaderno, conectar otros dispositivos y dar acceso a programas y agentes de IA con tokens. Paper es un cuaderno de notas. Escribes, organizas en bóvedas y carpetas, enlazas una página con otra y llevas todo a otros dispositivos por tu Google Drive. Las notas personales quedan en tu dispositivo y en tu Drive, en archivos `.md` que cualquier editor abre. Esta documentación tiene dos partes. La **guía** es para quien usa la app. La **API personal** es para quien quiere que un programa o una IA lea y escriba en el cuaderno, solo donde la persona lo permita. ## Para agentes de IA [#para-agentes-de-ia] Si eres un agente de IA, empieza por el mapa en JSON. Lista cada página de esta documentación, la dirección de la versión en texto plano y las reglas de uso (claves en portugués, con traducciones al inglés y al español de cada página): ```txt https://wire.ia.br/documentation/agents/raw.json ``` Toda página de aquí tiene el botón **Ver en texto plano**, que abre el Markdown limpio de la página. La documentación entera en español en un solo archivo está en [`/documentation/llms-full.es.txt`](https://wire.ia.br/documentation/llms-full.es.txt), y el índice de todos los idiomas en [`/documentation/llms.txt`](https://wire.ia.br/documentation/llms.txt). ## Idiomas [#idiomas] Paper habla portugués, inglés y español, en la app y en esta documentación. Para cualquier otro idioma, la traducción automática del navegador funciona bien a partir de la versión en inglés. ## Las reglas en una frase [#las-reglas-en-una-frase] Paper es un lugar seguro para pensar y anotar. Úsalo como cuaderno, no como base de datos ni como alojamiento de archivos. Quien viola los [términos de la API](/es/termos/termos-da-api) pierde la cuenta para siempre, y solo una [apelación](/es/termos/banimento-e-apelacao) aceptada lo revierte. --- # Baneo y apelación Fuente: https://wire.ia.br/documentation/es/termos/banimento-e-apelacao > Cuándo se banea una cuenta, qué pasa con ella y cómo pedir una revisión. ## Cuándo baneamos [#cuándo-baneamos] Baneamos cuentas que violan los [términos de uso](https://wire.ia.br/es/terminos/) o los [términos de la API](/es/termos/termos-da-api). Los casos más comunes: * Usar Paper como base de datos o alojamiento de archivos. * Esquivar los límites de la API con varios tokens o varias cuentas. * Spam, estafas o contenido ilegal en enlaces publicados. * Intentar irrumpir, tumbar o explotar fallas del servicio. ## Qué pasa [#qué-pasa] El baneo es permanente y corta el acceso al instante: * La cuenta ya no entra. Quien intenta entrar va a la página de apelación. * Todas las sesiones se cierran. * Todos los tokens se revocan y las copias para IA se borran. * Todos los enlaces publicados quedan fuera de línea. * La conexión con Google guardada en el servidor se borra. * La cuenta pierde el acceso a los grupos. Su contenido sigue con los demás miembros. ## Qué sigue siendo tuyo [#qué-sigue-siendo-tuyo] Tus notas personales quedan en tu navegador y en tu Google Drive, en archivos `.md`. El baneo no borra nada de eso, y puedes abrir esos archivos en cualquier editor. ## Apelación [#apelación] El baneo no se levanta solo. La única forma de revertirlo es una apelación aceptada. Abre [wire.ia.br/es/apelacion](https://wire.ia.br/es/apelacion/). Deja un contacto para la respuesta, el ID de la cuenta (32 caracteres, en Configuración → Perfil, si lo sabes) y explica qué pasó. Una persona lee cada apelación y responde por el contacto que dejaste, en hasta 15 días. Una apelación por caso. Enviar varias no acelera la respuesta. ## Denunciar [#denunciar] ¿Viste un enlace de Paper con contenido que viola los términos? Usa el enlace **Denunciar** en el pie de la página publicada, o [soporte](https://wire.ia.br/es/soporte/) con el asunto **Denunciar una nota publicada**. --- # Términos de uso de la API Fuente: https://wire.ia.br/documentation/es/termos/termos-da-api > Las reglas que aceptas al activar el modo desarrollador. Versión del 2 de octubre de 2026. Estos términos valen para los tokens de acceso y para la API personal de Paper. Completan los [términos de uso](https://wire.ia.br/es/terminos/) y la [política de privacidad](https://wire.ia.br/es/privacidad/) de la app. Aceptas esta versión al activar el modo desarrollador. El texto en portugués es el original. Estas versiones en inglés y español se ofrecen para tu comodidad, y si hay alguna diferencia, prevalece la versión en portugués. ## 1. Para qué existe la API [#1-para-qué-existe-la-api] La API deja que programas y agentes de IA te ayuden en tu propio cuaderno: leer, organizar, escribir, crear tareas y eventos. Atiende a una persona a la vez, la dueña del token. ## 2. Tu responsabilidad [#2-tu-responsabilidad] * El token es tuyo. Todo lo que se haga con él cuenta como hecho por tu cuenta, incluso por una IA o un programa de otra persona a quien le diste el token. * Guarda el token con cuidado y revócalo al instante si sospechas una filtración. * Revisa los permisos antes de entregar un token. Da solo lo necesario. ## 3. Permitido [#3-permitido] * Leer, crear y editar notas donde el token tiene permiso. * Organizar, resumir, revisar y convertir apuntes en tareas, fechas y eventos. * Enviar archivos que forman parte de tus notas, dentro de los [límites](/es/api/limites). * Automatizar tus propias rutinas, como la página del día o un resumen semanal. ## 4. Prohibido [#4-prohibido] * Usar Paper como base de datos, cola, caché, registro o almacenamiento de otro sistema. * Alojar imágenes o archivos para que otros sitios, apps o personas los descarguen, incluso mediante enlaces publicados. * Esquivar los límites con varios tokens, varias cuentas o solicitudes en ráfaga. * Consultar sin parar para detectar cambios (más de una revisión por minuto). * Publicar o enviar spam, contenido ilegal, contenido abusivo o datos personales de otras personas sin autorización. * Intentar abrir páginas protegidas, leer datos de otras cuentas, probar fallas de seguridad sin autorización o sobrecargar el servicio. * Revender el acceso u ofrecer la API de Paper como servicio a terceros. ## 5. Consecuencia [#5-consecuencia] Violar la sección 4 lleva al **baneo permanente** de la cuenta: tokens revocados, enlaces publicados fuera de línea y acceso terminado. El baneo no se levanta solo. Solo una [apelación](/es/termos/banimento-e-apelacao) aceptada lo revierte. Tus notas personales siguen en tu dispositivo y en tu Google Drive incluso después de un baneo: Paper no borra archivos de tu Drive. ## 6. Disponibilidad [#6-disponibilidad] La API puede cambiar, tener mantenimiento o quedar fuera de línea. Los cambios que rompan programas se avisarán en [Novedades](/es/ajuda/novidades) con anticipación, cuando sea posible. Los límites pueden cambiar para proteger el servicio. ## 7. Cambios en estos términos [#7-cambios-en-estos-términos] Cuando estos términos cambien, la app pide una nueva aceptación antes de habilitar los tokens de nuevo. ## 8. Contacto [#8-contacto] Paper y la API son ofrecidos por Israel de Jesus Silva, persona física, en Brasil. Dudas sobre estos términos: [contato.brennoleon@gmail.com](mailto:contato.brennoleon@gmail.com) o [soporte](https://wire.ia.br/es/soporte/), asunto **API y tokens de acceso**. --- # Uso justo Fuente: https://wire.ia.br/documentation/es/termos/uso-justo > Paper es un cuaderno. Qué significa eso en la práctica. Paper es un lugar seguro para pensar, anotar y organizar la vida. Fue hecho para usarse como cuaderno, por personas, con la ayuda de programas e IAs cuando ellas quieran. ## Uso de cuaderno [#uso-de-cuaderno] * Notas, listas, diarios, estudios, proyectos, actas, borradores. * Imágenes y archivos que forman parte de esas notas. * Automatizaciones que ayudan a la persona: crear la página del día, juntar tareas, resumir la semana. ## Uso que no cabe [#uso-que-no-cabe] * **Base de datos.** Guardar miles de registros de un sistema, datos de sensores, registros o respuestas de otros servicios. * **Alojamiento de archivos.** Subir imágenes para usarlas en otros sitios, apps o tiendas, o distribuir archivos mediante enlaces publicados. * **Cola o integración entre sistemas.** Usar páginas como mensajes entre programas. * **Cuentas en serie.** Crear varias cuentas o tokens para sumar límites. Estos usos pesan sobre el servicio de todos y llevan a un baneo permanente. Mira [Baneo y apelación](/es/termos/banimento-e-apelacao). ## Imágenes en la nube [#imágenes-en-la-nube] Hoy, las imágenes de tus notas quedan en tu dispositivo y en tu Google Drive. El alojamiento de imágenes en la nube de Paper, para el plan de pago, es una función futura y todavía no existe. ## Ante la duda [#ante-la-duda] Si no sabes si un uso cabe, pregunta antes por [soporte](https://wire.ia.br/es/soporte/).