09 · O baobá no bolso: o bot XMPP

Nem sempre dá para abrir o site. Mas quase sempre dá para mandar uma mensagem.

O que é

XMPP é um jeito livre de trocar mensagens, como um WhatsApp que ninguém é dono: cada comunidade pode ter o seu próprio XMPP — na mucua, que o protocolo chama de "servidor" (a gente prefere mucua: cuidado, não exploração) —, e eles conversam entre si. O Baobáxia tem um bot — um contato que responde — para publicar e buscar saberes pela conversa: mande uma foto, ela vira um saber; escreva "buscar jongo", ele responde com o que achou.

Funciona bem em conexão fraca: uma mensagem é pequena, e o aplicativo manda quando a conexão volta.

Do que você precisa

1. Um aplicativo XMPP. No Android, Conversations ou Monocles; no iPhone, Monal ou Siskin; no computador, Dino ou Gajim.
2. Uma conta XMPP. Pergunte a quem cuida da mucua. Em muitas mucuas a sua conta do Baobáxia já vale no XMPP: o endereço é seu-usuario@endereço-da-mucua e a senha é a mesma.
3. O endereço do bot — algo como baobaxia-bot@endereço-da-mucua. Adicione como contato e mande ajuda.

Se o bot pedir, entre com login <usuário> <senha>. Em mucuas onde a conta XMPP é a mesma do Baobáxia, ele já sabe quem você é.

Os comandos

O bot entende português, inglês, espanhol e italiano — os comandos também (buscar, search, cerca…). Ele responde na língua do seu aplicativo; para mudar, idioma pt (ou en, es, it).

🌳 Baobáxia Bot

🔐 login <user> <senha> | logout | ping
📋 status | galaxias (lista c/ uuid) | galaxia <nome|uuid|nº>
📤 publicar | artigo <título> | url <url> | youtube <url>
✅ enviar (confirma) | 🛑 cancelar
🔍 buscar <termo>  (no detalhe: editar título/descrição/tags, etc.)
⚙️ titulo | descricao | tags | qualidade | uuid (saber existente)
🗺️ territorio (escolhe entre os existentes) | 📍 local <lat>,<lon>
📋 extra <campo> <valor> (metadados: língua, direitos, etc.)
📬 compartilhar <jid> (envia o saber atual a outra pessoa)
🌐 idioma <pt|en|es|it>

💡 Envie uma foto/arquivo → vira mídia.
💡 Para artigo: `artigo <título>` → envie o texto → `enviar`.
💡 Compartilhe sua posição no app → vira a localização do saber.
💡 Texto solto = busca (não publica nada).

Publicar uma foto

Mande a foto. Se ela vier com legenda, a legenda vira o título; se não, o bot pergunta. A resposta traz o link do saber — na sua língua.

> [📷 fogueira.jpg]
📝 Qual o título? (`-` para usar *fogueira*, `cancelar` para abortar)

> Fogueira na mucua
✅ Publicado: *Fogueira na mucua*
🔗 http://abdias.local/pt-BR/saber/ccce5b22-…
📌 `ccce5b22-…` (envie mais para adicionar a este saber)

Mandou mais fotos logo em seguida? Elas entram no mesmo saber. Para começar outro, cancelar e mande de novo.

Antes de mandar, dá para preparar: tags festa, fogueira, territorio (o bot lista os territórios para escolher), local -22.9,-47.06 — ou compartilhe a sua posição pelo aplicativo. Vídeos são convertidos para tocar bem no site; qualidade escolhe o tamanho.

Também dá para publicar de um link: url <endereço> baixa o arquivo, e youtube <endereço> baixa o vídeo.

Escrever um artigo

> artigo Sementes que viajam
📝 *Sementes que viajam*
Envie o texto do artigo:

> As sementes do baobá atravessam o mar dentro do fruto.
📝 *Sementes que viajam*

As sementes do baobá atravessam o mar dentro do fruto.

🏷️ (sem tags)
Envie *enviar* para publicar, ou *cancelar* para descartar.

> enviar
✅ Artigo publicado: *Sementes que viajam*
🔗 http://abdias.local/pt-BR/saber/370cf026-…

O texto pode ter markdown (**negrito**, listas…), como no site.

Buscar e editar

Qualquer texto solto é uma busca. Responda com o número para ver o saber e as ações:

> buscar sementes
🔍 3 resultado(s) para 'sementes':
1. Sementes que viajam [artigo]
2. A farinha do fruto do baobá [artigo]
3. 08 · As sementes: federação [artigo]

> 1
📌 *Sementes que viajam*
   nature: artigo
   🔗 http://abdias.local/pt-BR/saber/370cf026-…

⚙️ *Editar este saber* — cada comando SALVA na hora:
   • `titulo <novo título>`
   • `descricao <nova descrição>`
   • `tags <a, b, c>`  (ou `tags limpar`)
   • `territorio`  ·  `local <lat>,<lon>`
   • `adicionar` (enviar arquivos)  ·  `compartilhar <jid>`
   • `deletar`  ·  `cancelar` (sair)

> tags baobá, sementes
✅ tags salvas: baobá, sementes

> descricao Uma história de viagem.
✅ Salvo — descrição: Uma história de viagem.

> sair
🛑 Ok, saindo do saber.

Você só edita o que pode editar no site também: os seus saberes, ou os de que é editora, ou tudo, se administra.

Saberes em várias línguas

O bot mostra cada saber na língua da conversa, e diz quais versões ele tem:

📌 *Oficina: o Baobáxia no celular*
   nature: evento
   idiomas: English · Español · Italiano · Português ◀

Se não há versão na sua língua, ele avisa e mostra a que existe. Aí, titulo … e descricao … escrevem a versão na sua língua, ao lado das outras — nada se apaga. E o que você publica pelo bot nasce na língua da conversa, como no site com o Escrevendo em.

Compartilhar

compartilhar <endereço-xmpp> manda o saber atual para outra pessoa, com o link. Bom para avisar: "olha a foto da festa que eu subi".

Para conversar na roda

• Quem da comunidade publica mais pelo celular? Uma tarde de oficina com o bot ajuda todo mundo a começar.
• Que conversas do grupo de mensagens da comunidade deveriam virar saberes guardados?