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.

  1. No painel, abra Minha conta (seu nome, no rodapé do menu) e toque em Vincular Telegram.
  2. Toque em Abrir Telegram e, no bot, em Iniciar. O bot confirma que ficou vinculado.
  3. Para desvincular, escreva /sair ao 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

AvisoQuando chega
Tarefa atribuídaAlguém atribuiu uma tarefa a você
Trabalho sem donoHá uma tarefa de fila que seu equipe pode pegar
LembreteFalta pouco para um atendimento (aviso prévio da equipe)
Relatório diárioResumo do seu dia
MudançasUma tarefa sua foi cancelada ou mudou
Despesa para aprovarSó 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

ComandoO que faz
/startVincula sua conta (com o link de Minha conta)
/nextSua 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
/next5Suas próximas 5 tarefas, com Iniciar ou Ver para escolher a ordem
/livresTarefas sem responsável que você pode assumir, com Assumir
/hojeMostra seu dia, por negócio
/despesaLança uma despesa: escreva («gastei 5000 em insumos») ou envie a foto do comprovante
/sairDesvincula seu Telegram
/ajudaLembra 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.

  1. 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.
  2. 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.
  3. Mostra a despesa com o valor, a categoria e o dia, e você confirma com Confirmar (ou Mudar a categoria ou Cancelar).
  4. 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.

  1. Um Dono ou Gerente com o Telegram já vinculado adiciona o bot da equipe ao grupo.
  2. No grupo, escreve /vincular e toca Confirmar (se administra vários negócios, escolhe qual). Só quem pediu pode confirmar.
  3. Opcional, em um grupo com tópicos: dentro de um tópico, /topico e 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 grupoO que faz
/vincularVincula o grupo ao negócio (com confirmação)
/topicoEscolhe qual zona ou equipe publica neste tópico
/desvincularDeixa 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.