09 · Il baobab in tasca: il bot XMPP

Non sempre si può aprire il sito. Ma quasi sempre si può mandare un messaggio.

Che cos'è

XMPP è un modo libero di scambiarsi messaggi, come un WhatsApp che non è di nessuno: ogni comunità può avere il suo XMPP — sulla mucua, che il protocollo chiama "server" (preferiamo mucua: cura, non sfruttamento) —, e questi parlano tra loro. Baobáxia ha un bot — un contatto che risponde — per pubblicare e cercare saperi chattando: mandi una foto, diventa un sapere; scrivi "cerca jongo", ti risponde con ciò che ha trovato.

Funziona bene con una connessione debole: un messaggio è piccolo, e l'app lo manda quando la connessione torna.

Che cosa ti serve

1. Un'app XMPP. Su Android, Conversations o Monocles; su iPhone, Monal o Siskin; sul computer, Dino o Gajim.
2. Un account XMPP. Chiedi a chi si prende cura della mucua. In molte mucua il tuo account Baobáxia vale già su XMPP: l'indirizzo è tuo-utente@indirizzo-della-mucua e la password è la stessa.
3. L'indirizzo del bot — qualcosa come baobaxia-bot@indirizzo-della-mucua. Aggiungilo come contatto e manda aiuto.

Se il bot lo chiede, accedi con login <utente> <password>. Nelle mucua dove l'account XMPP è lo stesso di Baobáxia, sa già chi sei.

I comandi

Il bot capisce portoghese, inglese, spagnolo e italiano — anche i comandi (buscar, search, cerca…). Risponde nella lingua della tua app; per cambiarla, lingua it (o pt, en, es).

🌳 Baobáxia Bot

🔐 login <utente> <password> | logout | ping
📋 stato | galassie (elenco con uuid) | galassia <nome|uuid|n.>
📤 pubblica | articolo <titolo> | url <url> | youtube <url>
✅ invia (conferma) | 🛑 annulla
🔍 cerca <termine>  (nel dettaglio: modifica titolo/descrizione/tag, ecc.)
⚙️ titolo | descrizione | tags | qualita | uuid (saber esistente)
🗺️ territorio (scegli tra quelli esistenti) | 📍 posizione <lat>,<lon>
📋 extra <campo> <valore> (metadati: lingua, diritti, ecc.)
📬 condividi <jid> (invia il saber attuale a un'altra persona)
🌐 lingua <pt|en|es|it>

💡 Invia una foto/un file → diventa media.
💡 Per un articolo: `articolo <titolo>` → invia il testo → `invia`.
💡 Condividi la tua posizione nell'app → diventa la posizione del saber.
💡 Testo libero = ricerca (non pubblica nulla).

Pubblicare una foto

Manda la foto. Se arriva con una didascalia, la didascalia diventa il titolo; altrimenti il bot lo chiede. La risposta porta il link del sapere — nella tua lingua.

> [📷 fogueira.jpg]
📝 Qual è il titolo? (`-` per usare *fogueira*, `annulla` per interrompere)

> Falò nella mucua
✅ Pubblicato: *Falò nella mucua*
🔗 http://abdias.local/it-IT/saber/0c1e5d77-…
📌 `0c1e5d77-…` (invia altro per aggiungerlo a questo saber)

Hai mandato altre foto subito dopo? Entrano nello stesso sapere. Per cominciarne un altro, annulla e manda di nuovo.

Prima di mandare puoi preparare: tags festa, falò, territorio (il bot elenca i territori tra cui scegliere), posizione -22.9,-47.06 — oppure condividi la tua posizione dall'app. I video vengono convertiti per essere riprodotti bene sul sito; qualita sceglie la dimensione.

Si può anche pubblicare da un link: url <indirizzo> scarica il file, e youtube <indirizzo> scarica il video.

Scrivere un articolo

> articolo Semi che viaggiano
📝 *Semi che viaggiano*
Invia il testo dell'articolo:

> I semi del baobab attraversano il mare dentro il frutto.
📝 *Semi che viaggiano*

I semi del baobab attraversano il mare dentro il frutto.

🏷️ (nessun tag)
Invia *invia* per pubblicare, oppure *annulla* per scartare.

> invia
✅ Articolo pubblicato: *Semi che viaggiano*
🔗 http://abdias.local/it-IT/saber/978e5721-…

Il testo può avere markdown (**grassetto**, elenchi…), come sul sito.

Cercare e modificare

Qualsiasi testo libero è una ricerca. Rispondi con il numero per vedere il sapere e le azioni:

> cerca semi
🔍 6 risultato/i per 'semi':
1. Semi che viaggiano [artigo]
2. Come piantare una piantina di baobab [artigo]
3. 08 · I semi: federazione [artigo]
…

> 1
📌 *Semi che viaggiano*
   nature: artigo
   🔗 http://abdias.local/it-IT/saber/978e5721-…

⚙️ *Modifica questo saber* — ogni comando SALVA subito:
   • `titolo <nuovo titolo>`
   • `descrizione <nuova descrizione>`
   • `tags <a, b, c>`  (o `tags pulisci`)
   • `territorio`  ·  `posizione <lat>,<lon>`
   • `aggiungi` (invia file)  ·  `condividi <jid>`
   • `elimina`  ·  `annulla` (esci)

> tags baobab, semi
✅ tag salvati: baobab, semi

> descrizione Una storia di viaggio.
✅ Salvato — descrizione: Una storia di viaggio.

Modifichi solo ciò che puoi modificare anche sul sito: i tuoi saperi, quelli di cui sei editrice, o tutto, se amministri.

Saperi in più lingue

Il bot mostra ogni sapere nella lingua della conversazione, e dice quali versioni ha:

📌 *Laboratorio: Baobáxia sul telefono*
   nature: evento
   lingue: English · Español · Italiano ◀ · Português

Se non c'è una versione nella tua lingua, lo avvisa e mostra quella che esiste. Allora titolo … e descrizione … scrivono la versione nella tua lingua, accanto alle altre — non si cancella niente. E ciò che pubblichi con il bot nasce nella lingua della conversazione, come sul sito con Scrivendo in.

Condividere

condividi <indirizzo-xmpp> manda il sapere attuale a un'altra persona, con il link. Utile per avvisare: "guarda la foto della festa che ho caricato".

Per parlarne nel cerchio

• Chi nella comunità pubblica di più dal telefono? Un pomeriggio di laboratorio con il bot aiuta tutti a cominciare.
• Quali conversazioni del gruppo di messaggi della comunità dovrebbero diventare saperi conservati?