09 · El baobab en el bolsillo: el bot XMPP

No siempre se puede abrir el sitio. Pero casi siempre se puede mandar un mensaje.

Qué es

XMPP es una manera libre de intercambiar mensajes, como un WhatsApp que no tiene dueño: cada comunidad puede tener su propio XMPP — en la mucua, que el protocolo llama "servidor" (preferimos mucua: cuidado, no explotación) —, y estos conversan entre sí. Baobáxia tiene un bot — un contacto que responde — para publicar y buscar saberes conversando: manda una foto, se vuelve un saber; escribe "buscar jongo", te responde con lo que encontró.

Funciona bien con conexión débil: un mensaje es pequeño, y la aplicación lo manda cuando vuelve la conexión.

Qué necesitas

1. Una aplicación XMPP. En Android, Conversations o Monocles; en el iPhone, Monal o Siskin; en la computadora, Dino o Gajim.
2. Una cuenta XMPP. Pregunta a quien cuida la mucua. En muchas mucuas tu cuenta de Baobáxia ya vale en XMPP: la dirección es tu-usuario@direccion-de-la-mucua y la contraseña es la misma.
3. La dirección del bot — algo como baobaxia-bot@direccion-de-la-mucua. Agrégala como contacto y manda ayuda.

Si el bot lo pide, entra con login <usuario> <contraseña>. En las mucuas donde la cuenta XMPP es la misma que la de Baobáxia, ya sabe quién eres.

Los comandos

El bot entiende portugués, inglés, español e italiano — los comandos también (buscar, search, cerca…). Responde en el idioma de tu aplicación; para cambiarlo, idioma es (o pt, en, it).

🌳 Baobáxia Bot

🔐 login <usuario> <contraseña> | logout | ping
📋 estado | galaxias (lista c/ uuid) | galaxia <nombre|uuid|nº>
📤 publicar | articulo <título> | url <url> | youtube <url>
✅ enviar (confirma) | 🛑 cancelar
🔍 buscar <término>  (en el detalle: editar título/descripción/tags, etc.)
⚙️ titulo | descripcion | tags | calidad | uuid (saber existente)
🗺️ territorio (elige entre los existentes) | 📍 ubicacion <lat>,<lon>
📋 extra <campo> <valor> (metadatos: idioma, derechos, etc.)
📬 compartir <jid> (envía el saber actual a otra persona)
🌐 idioma <pt|en|es|it>

💡 Envía una foto/archivo → se vuelve medio.
💡 Para artículo: `articulo <título>` → envía el texto → `enviar`.
💡 Comparte tu ubicación en la app → será la ubicación del saber.
💡 Texto suelto = búsqueda (no publica nada).

Publicar una foto

Manda la foto. Si viene con leyenda, la leyenda se vuelve el título; si no, el bot pregunta. La respuesta trae el enlace del saber — en tu idioma.

> [📷 fogueira.jpg]
📝 ¿Cuál es el título? (`-` para usar *fogueira*, `cancelar` para abortar)

> Fogata en la mucua
✅ Publicado: *Fogata en la mucua*
🔗 http://abdias.local/es-ES/saber/a54da5c8-…
📌 `a54da5c8-…` (envía más para añadir a este saber)

¿Mandaste más fotos enseguida? Entran en el mismo saber. Para empezar otro, cancelar y manda de nuevo.

Antes de mandar, puedes preparar: tags fiesta, fogata, territorio (el bot lista los territorios para elegir), ubicacion -22.9,-47.06 — o comparte tu posición desde la aplicación. Los videos se convierten para que se reproduzcan bien en el sitio; calidad elige el tamaño.

También se puede publicar desde un enlace: url <dirección> descarga el archivo, y youtube <dirección> descarga el video.

Escribir un artículo

> articulo Semillas que viajan
📝 *Semillas que viajan*
Envía el texto del artículo:

> Las semillas del baobab cruzan el mar dentro del fruto.
📝 *Semillas que viajan*

Las semillas del baobab cruzan el mar dentro del fruto.

🏷️ (sin tags)
Envía *enviar* para publicar, o *cancelar* para descartar.

> enviar
✅ Artículo publicado: *Semillas que viajan*
🔗 http://abdias.local/es-ES/saber/b121a83b-…

El texto puede tener markdown (**negrita**, listas…), como en el sitio.

Buscar y editar

Cualquier texto suelto es una búsqueda. Responde con el número para ver el saber y las acciones:

> buscar semillas
🔍 2 resultado(s) para 'semillas':
1. Semillas que viajan [artigo]
2. 08 · Las semillas: federación [artigo]

> 1
📌 *Semillas que viajan*
   nature: artigo
   🔗 http://abdias.local/es-ES/saber/b121a83b-…

⚙️ *Editar este saber* — cada comando GUARDA al instante:
   • `titulo <nuevo título>`
   • `descripcion <nueva descripción>`
   • `tags <a, b, c>`  (o `tags limpiar`)
   • `territorio`  ·  `ubicacion <lat>,<lon>`
   • `agregar` (enviar archivos)  ·  `compartir <jid>`
   • `borrar`  ·  `cancelar` (salir)

> tags baobab, semillas
✅ tags guardadas: baobab, semillas

> descripcion Una historia de viaje.
✅ Guardado — descripción: Una historia de viaje.

> salir
🛑 Ok, saliendo del saber.

Solo editas lo que también puedes editar en el sitio: tus saberes, aquellos de los que eres editora, o todo, si administras.

Saberes en varios idiomas

El bot muestra cada saber en el idioma de la conversación, y dice qué versiones tiene:

📌 *Taller: Baobáxia en el celular*
   nature: evento
   idiomas: English · Español ◀ · Italiano · Português

Si no hay versión en tu idioma, lo avisa y muestra la que existe. Entonces, titulo … y descripcion … escriben la versión en tu idioma, al lado de las otras — no se borra nada. Y lo que publicas por el bot nace en el idioma de la conversación, como en el sitio con Escribiendo en.

Compartir

compartir <dirección-xmpp> manda el saber actual a otra persona, con el enlace. Bueno para avisar: "mira la foto de la fiesta que subí".

Para conversar en la rueda

• ¿Quién de la comunidad publica más desde el celular? Una tarde de taller con el bot ayuda a todos a empezar.
• ¿Qué conversaciones del grupo de mensajes de la comunidad deberían volverse saberes guardados?