Arquivos, reações e listas de tarefas da equipe

Fotos, vídeos, arquivos e outras mensagens

Um grupo de curso recebe fotos de cadernos, PDFs e mensagens de voz. Um clube compartilha músicas e stickers. Uma equipe troca contatos e enquetes. O Combot tem configurações para cada tipo de mensagem.

Comece por uma tarefa prática: “pedir uma descrição curta junto de um vídeo longo” ou “mostrar um lembrete depois de um PDF”. Depois escolha o tipo de mensagem e suas opções.

Números normalmente aceitam limites mínimos e máximos; valores aceitam inclusões e exclusões. Se o Telegram não informar uma propriedade, como o tamanho do arquivo, isso não significa que o tamanho seja zero. Experimente com os arquivos que os membros realmente usam.

Foto

Situação: um grupo de fotografia discute imagens, mas às vezes os participantes esquecem as orientações de publicação.

Você pode verificar:

• Tamanho do arquivo: por exemplo, responder a fotos grandes com dicas de envio. O tamanho vem da maior versão da foto disponível ao bot; as unidades são bytes, KB ou MB.
• Álbum/grupo de mídia: por exemplo, lembrar de legendar uma coleção quando a foto pertence a um grupo de mídias.
• Live Photo: distinguir esse formato de imagens comuns.
• Spoiler: por exemplo, tratar separadamente fotos ocultas em uma discussão de cinema.

O texto abaixo da foto é configurado como legenda. Um álbum pode chegar ao bot como várias mensagens; o lembrete não tem garantia de aparecer só uma vez para a coleção inteira.

Vídeo

Situação: os alunos enviam gravações de apresentações. Para vídeos com mais de cinco minutos, você quer pedir uma descrição breve.

Escolha Video e a duração desejada. Você pode usar segundos, minutos ou horas.

Outras opções incluem tamanho, tipo e nome do arquivo, participação em álbum e spoiler. O nome pode identificar arquivos marcados como “apresentação”; o tamanho pode motivar um pedido para compartilhar um vídeo muito grande por link.

Informe o tipo como uma extensão, por exemplo .mp4, ou um identificador como video/mp4 — o tipo MIME. Isso descreve o formato; não avalia a qualidade da gravação.

Animação

Situação: um grupo de trabalho tem um tópico para GIFs. Quando uma animação correspondente aparece em outro tópico escolhido, o bot pede que seja enviada ao lugar certo.

Você pode verificar tamanho, duração, tipo e nome do arquivo e spoiler. Por exemplo, identificar animações muito grandes.

Se alguém envia o mesmo arquivo como documento, uma regra de animação não substitui a de documento: a forma de envio importa.

Áudio

Situação: os membros de um clube de música compartilham gravações, e você pede que informem artista e título.

Verifique se esses campos existem e o que contêm. Por exemplo, peça que a pessoa identifique uma gravação sem título. Também há tamanho, duração, tipo, nome do arquivo e participação em álbum — úteis para distinguir gravações longas e curtas.

O bot lê os dados anexados ao arquivo de áudio. Não identifica o artista ouvindo a música.

Documento

Situação: os alunos entregam atividades em PDF. Depois do arquivo, o bot lembra de informar o número da aula e uma pergunta para quem vai corrigir.

Escolha .pdf ou application/pdf como tipo. Acrescente condições de tamanho, nome ou álbum se necessário. Por exemplo, trate separadamente nomes que contenham “portfólio”.

A regra reconhece um documento do tipo certo. Não lê a atividade nem confirma que um professor a corrigiu.

Sticker

Situação: a comunidade tem seu próprio pacote de stickers, e você quer lembrar quais pacotes são permitidos em certas conversas.

Informe o nome ou o link do pacote. Você pode selecionar pacotes específicos ou excluí-los da regra.

Outras propriedades também estão disponíveis:

• Tamanho: por exemplo, selecionar stickers por um limite de tamanho.
• Tipo: sticker comum, máscara ou sticker de emoji personalizado.
• Animação e vídeo: por exemplo, distinguir stickers em movimento. O tipo Regular, sozinho, não significa imagem estática.
• Animação premium: propriedade específica desses stickers.
• Emoji associado: presença e valor. Por exemplo, reconhecer um sticker associado a 👍.
• IDs de emoji personalizados: selecionar um emoji específico.

Mensagem de voz

Situação: o suporte recebe uma mensagem de voz de sete minutos. A equipe não consegue entender rapidamente o que aconteceu.

Defina uma duração mínima de dois minutos e a resposta: “Descreva brevemente sua dúvida por texto para podermos ajudar mais rápido”. Você também pode verificar tamanho e tipo do arquivo.

O Combot verifica a duração, não o sentido da fala. Uma busca por frases não transcreve mensagens de voz.

Mensagem de vídeo

Situação: as pessoas enviam respostas em vídeos redondos. Para respostas longas, você quer sugerir um vídeo comum.

Escolha Video note e a duração desejada. Também é possível verificar o tamanho. Mensagens de vídeo e vídeos comuns são opções separadas; escolha a necessária.

Contato

Situação: os organizadores compartilham cartões de contato. Um telefone conhecido pode acionar informações sobre quais assuntos tratar com aquela pessoa.

As propriedades incluem telefone ou código de país, ID do Telegram, nome, sobrenome e se o contato pertence ao grupo.

A verificação é sobre a pessoa do cartão. Se Anna envia o contato de Ilya, o telefone de Ilya não passa a ser o de Anna.

Um cartão pode não ter ID do Telegram. Por isso, “o contato não é membro” nem sempre prova que o bot identificou a pessoa e conferiu sua participação: cartões sem ID conhecido também podem cair nessa categoria.

Localização e estabelecimento

Situação: um grupo de trilhas compartilha pontos de encontro. Para um ponto dentro de uma área escolhida, o bot pode enviar informações do local.

Defina a área por latitude, longitude e raio em metros. Isso verifica o ponto enviado; não rastreia a pessoa.

Também é possível selecionar localização em tempo real, duração em segundos, direção em graus e raio de alerta de proximidade. Por exemplo, distinguir um trajeto ao vivo de um ponto enviado uma única vez.

Para um estabelecimento compartilhado, há endereço e, quando informados, ID ou tipo do Foursquare ou Google Place. Por exemplo, identificar o cartão de um local específico.

Compartilhar uma localização não prova que a pessoa esteja lá. O bot não ganha acesso contínuo à posição dela.

Enquete

Situação: um clube do livro vota na próxima leitura, enquanto um curso publica quizzes. Regras separadas podem tratar cada caso de modo diferente.

Estas configurações estão disponíveis:

• Tipo e participação: enquete comum ou quiz, anonimato, múltiplas respostas, alteração de voto, participação só de membros e estado encerrado. Por exemplo, enviar orientações de discussão depois de um novo quiz.
• Números e tempo: quantidade de opções, total de votos, período de votação em segundos e horário de encerramento. Por exemplo, identificar enquetes com muitas opções.
• Texto: pergunta, opção de resposta, explicação e descrição. Por exemplo, reconhecer uma pergunta com “Próximo livro”.
• Formatação: na pergunta, explicação e descrição; anexos na explicação e descrição. Por exemplo, distinguir quizzes com materiais extras.
• Campos adicionais: restrições por códigos de país, quando informadas, e IDs das respostas corretas. Aqui, 0 é a primeira opção, não ausência de resposta.

Se o campo de encerramento pedir um timestamp Unix, informe a marca de tempo em segundos, não “faltam 30 minutos”. A configuração é útil para quem já trabalha com esse formato.

A regra verifica os dados da enquete no evento recebido. Não há um gatilho separado para cada voto, e alguns campos podem faltar.

Dados e outros emojis de jogo

Situação: os membros jogam 🎲 no Bate-papo do clube. Um resultado específico pode gerar uma resposta divertida.

Escolha o emoji e o resultado. 🎲 e 🎯 têm valores possíveis diferentes, então confira o jogo escolhido. Outra jogada pode gerar a mesma resposta novamente.

Jogo

Situação: alguém compartilha um jogo do Telegram, e o bot lembra em qual tópico falar sobre ele.

Você pode verificar título e descrição do jogo. Isso não é o resultado de uma partida: a regra não descobre quem ganhou nem quem bateu um recorde.

Mídia paga

Situação: um grupo temático compartilha publicações pagas. Você quer responder com um lembrete das regras de postagem.

Verifique o preço em Estrelas do Telegram, a quantidade de itens e o tipo: foto, vídeo, live photo ou prévia bloqueada. Por exemplo, trate separadamente posts com vários itens.

Outras opções incluem prévia bloqueada, tamanho, duração, tipo e nome do arquivo, capa do vídeo, início do vídeo em segundos e dados de qualidade disponíveis. Use propriedades existentes para o tipo de mídia. Uma foto paga, por exemplo, pode não ter tipo MIME.

Essas configurações não compram a publicação, não gastam Estrelas, não desbloqueiam arquivos nem verificam se um membro pagou por eles.

Reações e listas de tarefas da equipe

Nem tudo acontece por mensagens novas. Pessoas mudam reações, e colegas marcam tarefas em uma lista. A automação também pode perceber essas mudanças.

Alguém adiciona, remove ou troca uma reação

Você quer avisar a equipe sobre mudanças pertinentes de reação em uma discussão de trabalho. Primeiro escolha Reação do usuário (reação de usuário), depois a mudança de interesse:

• Adicionada — apareceu uma reação que não existia antes.
• Removida — a pessoa retirou uma reação.
• Para detectar os dois tipos de alteração, deixe as duas opções desmarcadas.

Por exemplo, Ilya troca 👍 por ❤️. A mudança inclui remover 👍 e adicionar ❤️.

O evento funciona quando o Telegram informa a identidade do usuário. Uma reação em nome de canal ou de administrador anônimo não o aciona. Use seu perfil pessoal para testar.

Você pode incluir ou excluir reações específicas. Digite emojis comuns como símbolos e personalizados como IDs numéricos; há uma opção separada para reações pagas.

Um detalhe fica mais claro com um exemplo. Ilya já tem 👍 em uma mensagem. Ele adiciona ❤️ e fica com duas reações. O filtro de 👍 continua vendo esse emoji: verifica o que ficou depois da mudança, não só o que acabou de ser adicionado.

Filtrar uma reação específica exige selecionar Adicionada. Isso não significa “alguém removeu este 👍”: o emoji removido talvez já não esteja no novo conjunto.

Se alguém retira uma reação e a adiciona de novo, a regra pode rodar novamente. A condição, sozinha, não basta para “uma recompensa por uma curtida”. Para um agradecimento pessoal do moderador, use um comando de 11 cenários prontos.

Uma publicação tem a quantidade desejada de reações

Os editores querem acompanhar posts do canal vinculado que tenham, no momento, entre 20 e 30 reações 👍 e ❤️ somadas.

Escolha Contagem de reações (quantidade de reações), selecione os tipos e defina mínimo 20 e máximo 30.

• 12 👍 e 10 ❤️ correspondem: a soma é 22.
• 10 👍 e 8 ❤️ não correspondem: a soma é 18.
• Outras 50 reações de um tipo não selecionado não alteram essa contagem.

Inclua os tipos desejados ou exclua os indesejados. Sem filtro de tipo, usa-se o total. Um limite vazio ou 0 significa “sem limite deste lado”. Dois zeros não significam “exatamente zero reações”.

Não é um aviso único de alcance de meta. O bot recebe a contagem 20 e a regra corresponde. Depois recebe 21 e pode corresponder de novo. Mesmo que você queira ser avisado só uma vez, o intervalo não lembra se já houve notificação.

Uma opção prática é enviar um aviso curto ao canal de logs, apagando a resposta anterior dessa ação de envio. Os avisos são substituídos, mas isso não impede novas execuções.

O evento não traz uma lista de quem reagiu. Não é possível selecionar “a vigésima pessoa a reagir” e dar XP a ela pela contagem total.

Uma lista específica muda

O grupo de trabalho tem uma lista para preparar um webinar: testar o som, montar a apresentação e enviar e-mails. A equipe quer um aviso breve quando alguém concluir uma tarefa.

1. Escolha Tarefas da lista de verificação concluídas (tarefas concluídas). Para itens novos, escolha Tarefas da lista de verificação adicionadas (tarefas adicionadas).
2. Copie o link direto do Telegram para a mensagem com a lista e informe-o na condição de checklist.
3. Adicione uma ação de envio: “Marcaram tarefas como concluídas no plano do webinar. Veja o que ainda falta”.
4. Se quiser, adicione um botão para a mesma lista.

Mudanças em uma lista vizinha não devem mais gerar aviso. O bot compara o link com a própria lista, não com a mensagem de serviço “Tarefas concluídas”.

Links diretos podem apontar para grupos públicos ou privados, inclusive tópicos. Para um link público, o Combot precisa conhecer o nome de usuário correspondente do grupo nos dados recebidos.

Um link com ?comment=… não funciona. Abra a lista no próprio grupo de discussão e copie o link direto da mensagem.

Remova a condição de link para abranger todas as listas correspondentes do grupo ou tópico escolhido. Por exemplo, receba nos logs avisos de todas as novas tarefas da equipe.

Não escreva “Está tudo pronto para o webinar” no evento de tarefas concluídas. Alguém talvez só tenha testado o som; as demais tarefas podem continuar pendentes.