Telegram del equipo
Recibí avisos de trabajo en Telegram, tomá tareas con un toque y abrí tu jornada en la Mini App "Mi día".
Actualizado:
Telegram del equipo es la forma más rápida de que cada persona del negocio se entere de lo que le toca: una tarea asignada, un trabajo sin tomar, un recordatorio o el resumen del día. Se usa desde el celular, sin instalar nada más que Telegram.
Hay un solo bot de Fiuit para todos los equipos. No es el bot de tu negocio: ese es el que conversa con tus clientes (Telegram de clientes). Los dos son independientes y no se mezclan.
Vincular tu Telegram
El vínculo es por persona, no por negocio: lo hacés una vez y vale para todos los negocios a los que tenés acceso.
- En el panel, abrí Mi cuenta (tu nombre, al pie del menú) y tocá Vincular Telegram.
- Tocá Abrir Telegram y, en el bot, Iniciar. El bot confirma que quedó vinculado.
- Para desvincular, escribí
/saliral bot o desvinculalo desde Mi cuenta.
El enlace de vínculo es de un solo uso y vence a los 15 minutos. Si venció, generá otro. Si no ves la opción Vincular Telegram, el bot del equipo todavía no está activado en tu entorno: avisanos.
Sumar a alguien nuevo por Telegram
Si la persona no está en el equipo y no tenés su número, invitala por Telegram: en Mi negocio → Equipo y recursos → Agregar → Invitar, elegí Canal: Telegram, escribí su nombre y guardá. Te mostramos un enlace una sola vez para copiar o compartir: al abrirlo en Telegram y tocar Iniciar, se suma al equipo y queda vinculada. Sirve una vez y vence a las 48 horas. Solo para el rol Equipo; los demás roles se invitan por email. WhatsApp sigue siendo el canal por defecto.
El enlace lo usa la primera cuenta de Telegram que lo abre, así que compartilo solo con esa persona. Cuando alguien lo usa, te avisamos con el nombre de su cuenta de Telegram, que también ves en su fila de Personas y en su ficha; si no era quien esperabas, desactivala. Si el enlace se compartió de más antes de usarse, anulalo: en Invitaciones pendientes, Anular invitación.
Qué avisos recibís
| Aviso | Cuándo llega |
|---|---|
| Tarea asignada | Alguien te asignó una tarea |
| Trabajo sin tomar | Hay una tarea de cola que tu equipo puede tomar |
| Recordatorio | Falta poco para un turno (aviso previo del equipo) |
| Reporte diario | Resumen de tu jornada |
| Cambios | Una tarea tuya se canceló o cambió |
| Gasto por aprobar | Solo Dueño y Encargado: alguien del equipo cargó un gasto que espera tu aprobación (monto y categoría; nunca la nota) |
Los avisos traen botones para actuar sin abrir el panel:
- Abrir abre la Mini App directamente en esa tarea. En un gasto por aprobar, abre Finanzas → Movimientos, donde está Gastos por aprobar.
- Tomar y Completar ejecutan la acción con tus permisos, igual que en el panel. Si otra persona tomó el trabajo antes, te avisa que ya está tomado.
- Los avisos nunca incluyen datos de otro negocio.
Los recordatorios, el reporte diario y el aviso al equipo salen de tus recordatorios y reglas. Si activás uno, el equipo lo recibe por este canal.
Elegí cómo recibirlos
En Mi cuenta → Preferencias de avisos definís:
- Canal preferido: automático, Telegram, WhatsApp o email. En automático, Telegram si lo tenés vinculado; si no, WhatsApp (con tu vínculo verificado) y, si tampoco, email.
- Qué silenciar: asignadas, sin tomar, recordatorios, reporte diario, cambios o (Dueño y Encargado) gastos por aprobar.
Si Telegram no puede entregar un aviso (por ejemplo, bloqueaste el bot), el aviso cae al siguiente canal.
Comandos
| Comando | Qué hace |
|---|---|
/start | Vincula tu cuenta (con el enlace de Mi cuenta) |
/next | Tu siguiente tarea con todo el detalle: cliente, pedido, dirección, Google Maps y Waze, y los botones de su etapa. Al completarla te muestra la siguiente |
/next5 | Tus próximas 5 tareas, con Iniciar o Ver para elegir el orden |
/libres | Tareas sin asignar que podés tomar, con Tomar |
/hoy | Te muestra tu día, por negocio |
/gasto | Carga un gasto: escribilo («gasté 5000 en insumos») o mandá la foto del ticket |
/salir | Desvincula tu Telegram |
/ayuda | Te recuerda cómo tomar una tarea, avanzar de etapa, compartir tu ubicación en tiempo real y los comandos |
Tu siguiente tarea con /next
/next te muestra una sola tarea: la que ya tenés en curso o, si no hay, la próxima por horario de hoy (lo atrasado primero; lo que no tiene horario, al final). Tocás Iniciar, En camino o Completar (los nombres son los de las etapas de tu negocio) y el bot te manda sola la siguiente, hasta que no queden.
Si para avanzar faltan datos (una foto, un campo obligatorio, el cobro o tu ubicación), la tarjeta te dice qué falta y Abrir te lleva a la tarea en la Mini App. Cancelar o marcar que el cliente no estaba también se hace desde la Mini App. Los botones solo hacen lo que tu rol permite, y un botón viejo de una tarea que ya cambió no la avanza: te muestra cómo está ahora.
Cargar un gasto
Escribile al bot «gasté 5000 en insumos» (o «pagué 80 de nafta ayer», o simplemente «gasto 5000 nafta»), usá /gasto o mandá la foto del ticket, con o sin texto. La foto queda como comprobante del gasto; el bot no lee el ticket, así que si no escribiste el monto te pregunta cuánto fue.
- Si no se entiende el monto (por ejemplo, dos números o decimales en guaraníes), te pregunta cuánto fue en total. Siempre en la moneda de tu negocio, sin conversión.
- Si no reconoce la categoría, elegís una con un botón. Si trabajás en varios negocios, primero elegís en cuál.
- Te muestra el gasto con el monto, la categoría y el día, y lo confirmás con Confirmar (o Cambiar la categoría o Cancelar).
- Si el monto es alto para tu negocio (desde el doble de lo que paga por mes su plan), te pide una segunda confirmación. Si ya hay un gasto igual ese día, la tarjeta te avisa para que no lo cargues dos veces.
Tocar Confirmar dos veces no carga dos gastos. Lo que carga el Equipo queda pendiente de aprobación hasta que lo apruebe el Dueño o un Encargado (les llega el aviso Gasto por aprobar); lo del Dueño y el Encargado suma en el momento. Los roles que no cargan gastos reciben un aviso y no se carga nada.
Mini App "Mi día"
El botón de menú del bot (a la izquierda del campo de texto) abre Mi día: el panel en formato compacto dentro de Telegram, sin pedirte contraseña. Muestra lo mismo que verías en el panel según tu rol: Hoy y Trabajo (con "Mías" por defecto para el personal) y un selector de negocio si tenés varios.
- La sesión dura 60 minutos y solo toca Hoy, Trabajo y las tareas. No da acceso a claves de API, equipo, canales ni webhooks.
- Se corta sola si desvinculás Telegram o si te dan de baja del negocio.
Grupo del equipo
Además de los avisos personales, el negocio puede tener un grupo de Telegram del equipo donde se publican las tareas sin asignar con el botón Tomar. Gana el primero que toca: si dos tocan a la vez, una sola persona queda asignada y la otra ve que ya la tomaron.
- Un Dueño o Encargado con su Telegram ya vinculado agrega al bot del equipo al grupo.
- En el grupo escribe
/vinculary toca Confirmar (si administra varios negocios, elige cuál). Solo quien lo pidió puede confirmar. - Opcional, en un grupo con temas: dentro de un tema,
/temay elegí la zona o el equipo de trabajo cuyas tareas van ahí. Las demás van al tema general.
| Comando del grupo | Qué hace |
|---|---|
/vincular | Vincula el grupo al negocio (con confirmación) |
/tema | Elige qué zona o equipo publica en este tema |
/desvincular | Deja de publicar tareas en el grupo |
- Solo pueden Tomar las personas del negocio con su Telegram vinculado y permiso para tomar tareas (y, si son del personal, dentro de su equipo y zona). Al resto el bot no le responde.
- La publicación muestra solo el servicio, el horario y la zona: nunca el cliente, la dirección ni el teléfono. Cuando alguien la toma, el mensaje dice quién y pierde el botón.
- Hay un grupo por negocio y un negocio por grupo. Se ve y se desvincula en Mi negocio → Equipo y recursos → ficha de la persona; también se corta si sacás al bot del grupo.
- El bot publica como máximo 20 mensajes por minuto en el grupo; lo demás espera en cola.
- Al reemplazar el grupo o migrarlo a supergrupo, las tareas sin asignar se publican de nuevo en el grupo vinculado. Los botones de mensajes anteriores responden «Este grupo ya no está vinculado» y no asignan la tarea.
Límites y seguridad
- En privado, el bot solo habla con una persona; en el grupo del equipo solo lee sus comandos y botones.
- Telegram admite 1 mensaje por segundo por chat; si hay muchos avisos juntos, los siguientes esperan en cola y llegan igual.
- El vínculo y la Mini App se validan siempre en el servidor. Un enlace usado, vencido o de otra cuenta responde con el mismo mensaje neutro.
Para qué ve y qué puede hacer cada persona, mirá Roles y permisos. Para desarrolladores: los endpoints GET/DELETE /me/telegram, POST /me/telegram/link y GET/PUT /me/notification-preferences son de la cuenta del usuario (sesión de panel) y no se usan con claves de API.