Telegram da equipe
Receba avisos de trabalho no Telegram, pegue tarefas com um toque e abra seu dia no Mini App "Meu dia".
Atualizado:
O Telegram da equipe é a forma mais rápida de cada pessoa do negócio saber o que é com ela: uma tarefa atribuída, um trabalho sem dono, um lembrete ou o resumo do dia. Usa-se pelo celular, sem instalar nada além do Telegram.
Existe um único bot da Fiuit para todas as equipes. Não é o bot do seu negócio: esse é o que conversa com seus clientes (Telegram de clientes). Os dois são independentes e não se misturam.
Vincular seu Telegram
O vínculo é por pessoa, não por negócio: você faz uma vez e vale para todos os negócios aos quais tem acesso.
- No painel, abra Minha conta (seu nome, no rodapé do menu) e toque em Vincular Telegram.
- Toque em Abrir Telegram e, no bot, em Iniciar. O bot confirma que ficou vinculado.
- Para desvincular, escreva
/sairao bot ou desvincule em Minha conta.
O link de vínculo é de uso único e vence em 15 minutos. Se venceu, gere outro. Se você não vê a opção Vincular Telegram, o bot da equipe ainda não está ativado no seu ambiente: avise-nos.
Adicionar alguém novo pelo Telegram
Se a pessoa não está na equipe e você não tem o número, convide pelo Telegram: em Meu negócio → Equipe e recursos → Adicionar → Convidar, escolha Canal: Telegram, escreva o nome e salve. Mostramos um link uma única vez para copiar ou compartilhar: ao abri-lo no Telegram e tocar em Iniciar, a pessoa entra na equipe e fica vinculada. Funciona uma vez e vence em 48 horas. Só para a equipe operacional; os outros papéis são convidados por e-mail. O WhatsApp continua sendo o canal padrão.
O link é usado pela primeira conta do Telegram que o abrir, então compartilhe só com essa pessoa. Quando alguém o usa, avisamos você com o nome da conta do Telegram, que também aparece na linha e na ficha dela em Pessoas; se não for quem você esperava, desative-a. Se o link foi compartilhado demais antes de ser usado, cancele-o: em Convites pendentes, Cancelar convite.
Quais avisos você recebe
| Aviso | Quando chega |
|---|---|
| Tarefa atribuída | Alguém atribuiu uma tarefa a você |
| Trabalho sem dono | Há uma tarefa de fila que seu equipe pode pegar |
| Lembrete | Falta pouco para um atendimento (aviso prévio da equipe) |
| Relatório diário | Resumo do seu dia |
| Mudanças | Uma tarefa sua foi cancelada ou mudou |
| Despesa para aprovar | Só Dono e Gerente: alguém da equipe lançou uma despesa que espera a sua aprovação (valor e categoria; nunca a nota) |
Os avisos trazem botões para agir sem abrir o painel:
- Abrir abre o Mini App direto naquela tarefa. Numa despesa para aprovar, abre Finanças → Movimentações, onde fica Despesas para aprovar.
- Pegar e Concluir executam a ação com as suas permissões, igual ao painel. Se outra pessoa pegou o trabalho antes, o bot avisa que já foi pego.
- Os avisos nunca incluem dados de outro negócio.
Os lembretes, o relatório diário e o aviso à equipe saem dos seus lembretes e regras. Se você ativa um, a equipe o recebe por este canal.
Escolha como recebê-los
Em Minha conta → Preferências de avisos você define:
- Canal preferido: automático, Telegram, WhatsApp ou e-mail. No automático, Telegram se você o tem vinculado; se não, WhatsApp (com seu vínculo verificado) e, se também não, e-mail.
- O que silenciar: atribuídas, sem dono, lembretes, relatório diário, mudanças ou (Dono e Gerente) despesas para aprovar.
Se o Telegram não consegue entregar um aviso (por exemplo, você bloqueou o bot), o aviso cai para o próximo canal.
Comandos
| Comando | O que faz |
|---|---|
/start | Vincula sua conta (com o link de Minha conta) |
/next | Sua próxima tarefa com todo o detalhe: cliente, pedido, endereço, Google Maps e Waze, e os botões da etapa. Ao concluir mostra a seguinte |
/next5 | Suas próximas 5 tarefas, com Iniciar ou Ver para escolher a ordem |
/livres | Tarefas sem responsável que você pode assumir, com Assumir |
/hoje | Mostra seu dia, por negócio |
/despesa | Lança uma despesa: escreva («gastei 5000 em insumos») ou envie a foto do comprovante |
/sair | Desvincula seu Telegram |
/ajuda | Lembra como assumir uma tarefa, avançar de etapa, compartilhar sua localização em tempo real e os comandos |
Sua próxima tarefa com /next
/next mostra uma tarefa só: a que você já tem em andamento ou, se não houver, a próxima pelo horário de hoje (o atrasado primeiro; o que não tem horário, no final). Você toca Iniciar, A caminho ou Concluir (os nomes são os das etapas do seu negócio) e o bot manda a seguinte sozinho, até não restar nenhuma.
Se para avançar faltam dados (uma foto, um campo obrigatório, o pagamento ou sua localização), o cartão diz o que falta e Abrir leva à tarefa no Mini App. Cancelar ou marcar que o cliente não estava também se faz pelo Mini App. Os botões só fazem o que o seu papel permite, e um botão antigo de uma tarefa que já mudou não a avança: mostra como ela está agora.
Lançar uma despesa
Escreva para o bot «gastei 5000 em insumos» (ou «paguei 80 de gasolina ontem», ou só «despesa 50 gasolina»), use /despesa ou envie a foto do comprovante, com ou sem texto. A foto fica como comprovante da despesa; o bot não lê o comprovante, então se você não escreveu o valor ele pergunta quanto foi.
- Se o valor não for entendido (por exemplo, dois números ou decimais em guaranis), pergunta quanto foi no total. Sempre na moeda do seu negócio, sem conversão.
- Se não reconhecer a categoria, você escolhe uma com um botão. Se você trabalha em vários negócios, primeiro escolhe em qual.
- Mostra a despesa com o valor, a categoria e o dia, e você confirma com Confirmar (ou Mudar a categoria ou Cancelar).
- Se o valor for alto para o seu negócio (a partir do dobro do que ele paga por mês do plano), pede uma segunda confirmação. Se já houver uma despesa igual nesse dia, o cartão avisa para você não lançar duas vezes.
Tocar Confirmar duas vezes não lança duas despesas. O que a Equipe lança fica pendente de aprovação até o Dono ou um Gerente aprovar (eles recebem o aviso Despesa para aprovar); o do Dono e do Gerente soma na hora. Os papéis que não lançam despesas recebem um aviso e nada é lançado.
Mini App "Meu dia"
O botão de menu do bot (à esquerda do campo de texto) abre Meu dia: o painel em formato compacto dentro do Telegram, sem pedir senha. Mostra o mesmo que você veria no painel conforme seu papel: Hoje e Trabalho (com "Minhas" por padrão para a equipe operacional) e um seletor de negócio se você tem vários.
- A sessão dura 60 minutos e só acessa Hoje, Trabalho e as tarefas. Não dá acesso a chaves de API, equipe, canais nem webhooks.
- Ela se encerra sozinha se você desvincula o Telegram ou se é removido do negócio.
Grupo da equipe
Além dos avisos pessoais, o negócio pode ter um grupo do Telegram da equipe onde as tarefas sem responsável são publicadas com o botão Assumir. Ganha quem tocar primeiro: se duas pessoas tocam ao mesmo tempo, só uma fica atribuída e a outra vê que já foi assumida.
- Um Dono ou Gerente com o Telegram já vinculado adiciona o bot da equipe ao grupo.
- No grupo, escreve
/vinculare toca Confirmar (se administra vários negócios, escolhe qual). Só quem pediu pode confirmar. - Opcional, em um grupo com tópicos: dentro de um tópico,
/topicoe escolha a zona ou o equipe de trabalho cujas tarefas vão para lá. As demais vão para o tópico geral.
| Comando do grupo | O que faz |
|---|---|
/vincular | Vincula o grupo ao negócio (com confirmação) |
/topico | Escolhe qual zona ou equipe publica neste tópico |
/desvincular | Deixa de publicar tarefas no grupo |
- Só podem Assumir as pessoas do negócio com o Telegram vinculado e permissão para assumir tarefas (e, se forem da equipe operacional, dentro do seu equipe e zona). Para os demais o bot não responde.
- A publicação mostra só o serviço, o horário e a zona: nunca o cliente, o endereço nem o telefone. Quando alguém assume, a mensagem diz quem e perde o botão.
- Há um grupo por negócio e um negócio por grupo. Dá para ver e desvincular em Meu negócio → Equipe e recursos → ficha da pessoa; também se corta se você remover o bot do grupo.
- O bot publica no máximo 20 mensagens por minuto no grupo; o resto espera na fila.
- Ao substituir o grupo ou migrá-lo para supergrupo, as tarefas sem responsável são publicadas novamente no grupo vinculado. Os botões de mensagens anteriores respondem «Este grupo não está mais vinculado» e não atribuem a tarefa.
Limites e segurança
- No privado, o bot só fala com uma pessoa; no grupo da equipe só lê os seus comandos e botões.
- O Telegram admite 1 mensagem por segundo por chat; se há muitos avisos juntos, os seguintes esperam na fila e chegam do mesmo jeito.
- O vínculo e o Mini App são sempre validados no servidor. Um link usado, vencido ou de outra conta responde com a mesma mensagem neutra.
Para saber o que cada pessoa vê e pode fazer, veja Papéis e permissões. Para desenvolvedores: os endpoints GET/DELETE /me/telegram, POST /me/telegram/link e GET/PUT /me/notification-preferences são da conta do usuário (sessão do painel) e não se usam com chaves de API.