Guia de Tom 🤖

Tom és un bot de Telegram per gestionar els esdeveniments de la teva organització: crear-los, compartir-los i apuntar-s'hi sense fulls de càlcul.

Primers passos

Escriu a @tom_elbotper privat i accepta la política de privacitat. Tom comprovarà a quins grups pertanys i et connectarà automàticament. A partir d'aquí, /inici et mostra el menú principal.

Afegir el teu grup

Perquè un grup de Telegram pugui fer servir Tom calen dues coses:

1. Que el grup sigui un supergrup

Els grups normals canvien d'identificador en convertir-se i ho trenquen tot, així que Tom només treballa amb supergrups. Abans d'afegir el bot: a la configuració del grup, activa la visibilitat de l'historial del xat (després pots tornar-la a amagar). Això converteix el grup en supergrup.

2. Aprovació

Afegeix el bot al grup com a membre. Els administradors de Tom rebran una notificació i n'aprovaran l'accés. Un cop aprovat, els admins del grup ja poden crear esdeveniments.

El nom, la descripció i la privacitat del grup s'editen des de /grups, clicant el teu propi grup.

Crear un esdeveniment

Només els admins de grup poden crear esdeveniments (i, si el grup ho permet, la resta de membres poden proposar-ne, pendents d'aprovació). Assegura't d'haver connectat els teus grups amb /connectar_grups.

Des de /inici → Crear un esdeveniment, tens dues maneres:

1. Plantilla ràpida: copia el missatge que t'envia Tom, canvia els valors i envia-l'hi. Pots incloure qualsevol dels camps de sota, tots en un sol missatge.

2. Pas a pas: envia qualsevol missatge sense el símbol = i Tom et preguntarà camp a camp.

Camps disponibles

• name — nom (màx. 255 caràcters, accepta Markdown V2).
• description— descripció (màx. 1000 caràcters, Markdown V2). Si l'esdeveniment és de pagament, indica-hi el mètode (bizum, enllaç…).
• locationText — lloc (obligatori, text lliure fins a 500 caràcters).
• locationLink — enllaç de mapa o web (opcional). URL amb o sense https://. Per saltar-lo: 0, no o -.
• maxPax — aforament màxim. 0= sense límit. Quan s'omple, la resta va a la llista d'espera.
• price — preu. Decimals amb punt. 0 = gratuït o donatiu voluntari.
• paymentType — NONE (gratuït), DONATION (el preu és el donatiu mínim; amb 0, donatiu voluntari), ECONOMIC_ACTIVITY (pagament amb preu fix, no pot ser 0) o EXTERNAL(el pagament no és per a l'organització; Tom no envia missatges de pagament).
• startDate / endDate — inici i fi. Totes les hores són hora de Barcelona. Formats: data dd-mm, dd-mm-aa o dd-mm-aaaa (separadors -, / o .); hora en 24h HH o HHmm (opcionalment amb :). Exemples: 11-01 10, 22-01-2026 1803.
• signUpStartDate — quan obren les inscripcions. 0 = ara mateix. Mateixos formats de data.
• allowsLateJoin — true/false: si es pot arribar (i apuntar-se) després que comenci.
• isPrivate — true/false: si la llista d'assistents és visible per a la resta.
• eventType — GROUP (només el grup organitzador), GLOBAL (tots els grups de la xarxa) o PUBLIC (qualsevol persona que parli amb el bot).
• group— id del grup organitzador (Tom te'l mostra amb botons; si en tens dubtes, escriu a [email protected]).
• isRecurring — true/false: si es repeteix. Amb true calen també: recurrenceRule (diari, setmanal o mensual), recurrenceEndDate (fins quan; 0 = sense fi) i signUpDateRule (OFFSET, mateix desfasament que la plantilla, o FIRST_OF_MONTH, inscripcions el dia 1 de cada mes).

Els valors com GROUP o NONEs'escriuen amb majúscules, tal com es mostren.

Exemple: esdeveniment de pagament

name=Taller de ceràmica
description=Pagament per bizum: 123 456 789
locationText=Centre Cívic Sarrià
locationLink=maps.google.com/?q=Centre+Civic+Sarria
maxPax=12
price=10
paymentType=ECONOMIC_ACTIVITY
startDate=14-05 0900
endDate=14-05 1900
signUpStartDate=0
group=1
isPrivate=false
eventType=GLOBAL
isRecurring=false

Exemple: esdeveniment recurrent setmanal

name=Entrenament setmanal
description=Cada dilluns al poliesportiu
locationText=Poliesportiu Municipal
locationLink=0
maxPax=20
price=0
paymentType=NONE
startDate=10-02-2026 1900
endDate=10-02-2026 2100
signUpStartDate=03-02-2026 0900
group=1
isPrivate=false
eventType=GROUP
isRecurring=true
signUpDateRule=OFFSET
recurrenceRule=setmanal
recurrenceEndDate=30-06-2026 2100

Esdeveniments recurrents

La plantilla (el que crees amb isRecurring=true) no apareix a la llista: només és la configuració. Tom crea automàticament les instàncies— esdeveniments normals on la gent s'apunta — amb un mes d'antelació, fins a recurrenceEndDate. Des de Recurrents (plantilla)al menú d'esdeveniments pots generar les properes instàncies manualment amb Generar instàncies.

Cicle de vida

Qui organitza pot editar, cancel·lar (abans que acabi; s'avisa els inscrits, amb motiu opcional) i, quan l'esdeveniment ja ha passat, finalitzar-lo: Tom guarda només dades agregades i anònimes (quanta gent hi va anar) i esborra les dades personals. Si no ho fas tu, Tom ho fa automàticament tres setmanes després del final, amb avís el dia abans.

Comandes

/inici            Menú principal
/comandes         Comandes disponibles
/grups            Llista de grups
/esdeveniments    Llista d'esdeveniments
/pagat            Confirmar el pagament d'un esdeveniment
/connectar_grups  Connectar i actualitzar els teus grups
/esborrar_me      Esborrar el teu usuari de la base de dades
/treu_bot         Retirar el bot del grup (dins del grup)

Format Markdown V2

Els camps name i description accepten el Markdown V2 de Telegram: *negreta*, _cursiva_, ~ratllat~ i [enllaços](https://exemple.com).

Dubtes?

Escriu-nos a [email protected].