Respostas, moderação e recompensas

O que o bot faz quando a regra corresponde

Você já indicou qual pergunta ou evento o bot deve perceber. Agora escolha uma ação em ENTÃO.

Abaixo estão os 14 tipos de ação. As opções disponíveis dependem do evento. Para os exemplos de moderação, primeiro crie um comando no modo de resposta e limite o acesso aos moderadores desejados.

Quem recebe a ação

Voltemos a Anna e Ilya. Anna responde à mensagem de Ilya com um comando. Para advertir Ilya, escolha o usuário da mensagem respondida em Aplicar a, não a autora do comando.

Conforme o evento, o editor oferece:

• Autor do acionador / Chamador de comando — quem escreveu a mensagem ou chamou o comando.
• Usuário respondido — autor da mensagem à qual alguém respondeu.
• Usuário afetado — por exemplo, o membro adicionado ou removido.
• Autor da ação — quem adicionou ou removeu o membro.
• Requerente — quem está pedindo para entrar no grupo.
• Ambos — as duas pessoas disponíveis. Se forem a mesma pessoa, a opção não aplica a ação duas vezes a ela.
• Criador do link de convite — nos pedidos de entrada. É quem consta como criador do convite no catálogo do Combot deste grupo.

Por exemplo, chega um pedido pelo link de Ilya, e você quer dar XP a Ilya. Escolha o criador do link, não o solicitante. Isso recompensa um pedido, não uma entrada concluída. Se precisar confirmar o resultado antes, use um comando de agradecimento depois que um moderador verificar o convite.

O que vale é a pessoa registrada no catálogo do Combot: o criador técnico do link no Telegram pode ser outro. Para dois destinatários diferentes, como solicitante e criador do link, adicione duas ações com alvos explícitos.

Se a pessoa desejada for desconhecida, a ação para ela é ignorada. O bot não deve dar XP ao novato no lugar de um convidador desconhecido. Da mesma forma, uma contagem geral de reações não permite escolher um participante não identificado.

1. Enviar mensagem

Por exemplo: responder a “onde está a gravação” com um link dos materiais e instruções curtas.

Formate o texto e adicione variáveis ou botões. Envie ao grupo de origem ou ao canal de logs configurado. Para destinos e formatação, veja Formate a resposta.

2. Excluir mensagem

Por exemplo: apagar novos stickers de um tópico onde não são permitidos, desde que todos conheçam a regra. Selecione o tópico e o tipo Sticker nas condições e adicione a exclusão.

O bot apaga a mensagem que acionou a regra. Precisa de permissão para excluir mensagens.

Em um comando, essa mensagem é o próprio comando. Se Anna responde /team_warn a Ilya, a ação apaga /team_warn, não a mensagem de Ilya. Apagar o lembrete anterior do bot é outra configuração.

3. Advertir usuário

Por exemplo: Anna vê uma quebra das regras de convivência e responde à pessoa com /team_warn.

A ação adiciona uma advertência — normalmente uma. Ela faz parte do sistema de advertências do grupo. Se o acúmulo gera silêncio ou banimento nas configurações, uma advertência da automação pode aproximar a pessoa dessa consequência.

Confira primeiro as configurações de advertência, não apenas o texto de resposta do bot.

4. Silenciar usuário

Por exemplo: um moderador dá uma pausa de 15 minutos a alguém envolvido em uma discussão usando um comando de resposta preparado.

O silêncio restringe o envio de mensagens. Defina minutos, horas, dias ou semanas. Duração vazia significa silêncio permanente, não “decidir depois”.

Você pode combinar advertência e silêncio quando necessário. Escolha com cuidado: uma pausa curta e uma advertência são consequências separadas.

5. Banir usuário

Por exemplo: um moderador remove uma conta que publica spam e impede seu retorno.

O banimento remove a pessoa e impede nova entrada até expirar ou ser retirado. Defina uma duração para um banimento temporário; sem ela, ele é permanente.

No construtor de restrições, o banimento não pode ser combinado com expulsão ou silêncio como outra forma da mesma restrição.

6. Expulsar usuário

Por exemplo: alguém foi adicionado por engano ao grupo de trabalho, e o moderador quer removê-lo sem bloquear o retorno para sempre.

A expulsão remove o membro uma vez. Ele pode voltar pelas regras normais do grupo, como convite ou pedido de entrada. Para impedir o retorno, escolha banimento.

7. Remover silenciamento

Por exemplo: um moderador decide encerrar a pausa de um membro antes do prazo.

A ação restaura o envio de mensagens dentro das permissões gerais do grupo. Não remove todas as outras restrições nem equivale a passar por um CAPTCHA. Verificações pendentes de novatos são outra questão.

8. Desbanir usuário

Por exemplo: a equipe reconsidera uma decisão após um recurso e quer permitir o retorno da pessoa.

A ação retira a proibição de entrar. Não adiciona a pessoa automaticamente: ela ainda precisa entrar por um meio disponível.

9. Excluir mensagens do usuário

Por exemplo: uma conta publicou vários anúncios antes de ser banida. O moderador quer apagá-los também.

O construtor oferece essa limpeza depois de selecionar banimento ou expulsão. Ela usa mensagens disponíveis ao Combot e respeita os limites do Telegram. Não suponha que o bot consiga apagar todo o histórico de alguém em anos de conversa.

10. Remover advertência

Por exemplo: uma advertência foi aplicada por engano. Um moderador remove uma por meio de uma regra preparada.

A quantidade de advertências diminui em uma. Se a pessoa já foi silenciada ou banida, retirar a advertência não restaura suas permissões. Isso exige ações separadas.

11. Alterar XP

Por exemplo: Ilya explica uma atividade em detalhes a um novato. Anna responde com /reward_member, e Ilya recebe 25 XP.

Informe 25 para somar experiência ou -25 para subtrair. É uma alteração: somar 25 a 100 XP resulta em 125, não define o total como 25.

O XP precisa estar ativado. Use inteiros diferentes de zero entre −99.999 e 99.999. No exemplo de agradecimento, Aplicar a deve indicar o usuário da mensagem respondida.

12. Alterar REP

Por exemplo: além do XP pela explicação útil, você quer dar um ponto de reputação a Ilya.

Informe 1 para somar ou -1 para subtrair. A reputação precisa estar ativada. Os valores são inteiros diferentes de zero entre −999 e 999. Aqui também é uma alteração, não um novo total.

Repetir o comando pode dar XP e REP novamente. Se a recompensa deve ocorrer só uma vez, os moderadores precisam controlar isso separadamente.

13. Aprovar solicitação de adesão

Por exemplo: organizadores de uma aula aberta criaram um convite específico e querem aprovar os pedidos por ele sem clicar manualmente.

Selecione Solicitação de adesão (pedido de entrada), o link desejado e a ação de aprovação. Sem limitar origem e público, a regra pode aprovar muito mais pedidos do que você pretende.

O link não verifica pagamento nem identidade: alguém pode repassá-lo.

14. Recusar solicitação de adesão

Por exemplo: pedidos por um convite são recusados temporariamente, enquanto a equipe continua analisando os de outros links.

A ação está disponível em eventos de pedido de entrada. Recusa o pedido, mas não equivale a banir a pessoa permanentemente.

Não deixe duas regras sobrepostas tentando aprovar e recusar o mesmo pedido. Confira antes quais links e usuários correspondem a cada uma.

Formate a resposta e escolha o destino

Uma boa resposta automática ajuda a dar o próximo passo. Para “onde está a atividade”, uma explicação curta e um botão dos materiais podem bastar. Não é preciso enviar o manual inteiro do curso.

Texto: uma pergunta, uma resposta clara

O editor funciona como o de boas-vindas do Combot: permite formatar texto, inserir links e variáveis. O campo aceita até 4096 caracteres; acompanhe o contador.

Uma resposta do suporte pode ser assim:

Não consegue entrar na sua conta? Abra as instruções no botão abaixo. Se não resolver, diga em qual etapa ocorreu o problema. Não envie sua senha no grupo.

Mesmo com uma imagem, o texto é necessário. Uma URL de imagem, sozinha, não basta para uma mensagem vazia.

Nomes e outras variáveis

Uma variável é um marcador que o bot substitui pela informação pertinente. Por exemplo:

Boas-vindas a {chat.title}! Os materiais do curso estão na mensagem fixada.

{chat.title} vira o nome do grupo. Tenha mais cuidado com nomes de pessoas: o autor do evento e o novo membro nem sempre são a mesma pessoa.

O menu inclui:

• {from.title} — nome exibido do autor do evento. Por exemplo, falar com quem fez uma pergunta.
• {from.username} — nome de usuário. Útil em uma nota de moderação, mas nem todos têm um.
• {from.id} — ID numérico do usuário. Por exemplo, identificar com precisão a conta citada em uma nota.
• {chat.title} — nome do grupo. Útil em boas-vindas e informações reutilizáveis.
• {chat.username} — nome de usuário público do grupo, se existir.
• {chat.id} — ID numérico do grupo, caso uma nota de serviço precise dele.
• {message.id} — ID da mensagem associada ao evento. Por exemplo, ajudar a investigar uma solicitação.
• {message.timestamp} — data e hora da mensagem, quando disponíveis. Nem todo evento tem uma mensagem ou todas as propriedades dela.

Não construa a resposta inteira em torno de um campo que pode estar vazio. Usar o nome exibido costuma ser mais claro do que depender de um nome de usuário que talvez não exista.

Se Anna adiciona Ilya, {from.title} pode conter Anna: ela iniciou o evento. Por isso, as boas-vindas genéricas acima não usam o nome de uma pessoa. Escolher o alvo da ação não altera as variáveis.

Nomes exigem atenção especial em comandos de moderação. Se Anna usa um comando na mensagem de Ilya, {from.title} se refere a Anna. Escolher Ilya para receber a recompensa não muda isso. “Uma resposta útil foi reconhecida. Obrigado pela ajuda!” é mais seguro que agradecer à moderadora por engano.

Botões: ofereça o link certo

Em vez de “procure a seção de materiais no site”, adicione um botão Abrir materiais com o link direto.

Cada botão tem texto e URL. Organize-os em linhas: Materiais na primeira, por exemplo, e Regras e Feedback na segunda. Um ícone de emoji personalizado precisa do ID.

São botões de link. Eles não atribuem funções, não dão recompensas, não executam outro gatilho nem concluem um CAPTCHA.

Imagens: coloque uma capa na mensagem

Por exemplo, inclua a capa do curso nas boas-vindas da nova turma. Informe a URL em Imagens; Mostrar imagens acima do texto (mostrar acima do texto) define a posição.

A imagem aparece pela prévia de link do Telegram. Não é um álbum: várias URLs não significam várias fotos anexadas separadamente.

Comece com uma imagem acessível e confira no Telegram. Se a prévia não aparecer, verifique o link. Salvar a regra não garante a exibição da imagem.

Para onde enviar

Escolha Chat de origem (grupo de origem) para responder ao participante. A pergunta sobre a gravação chega ao grupo do curso, por exemplo, e as informações aparecem ali.

Escolha Canal de log (canal de logs) para avisos à equipe, como mudanças em listas de tarefas. Conecte o destino antes e confira se o Combot pode escrever nele.

Dentro do destino, configure os tópicos:

• Tópico atual: por exemplo, responder no mesmo Suporte onde surgiu a pergunta.
• Tópico selecionado (tópicos escolhidos): por exemplo, publicar informações por comando no Suporte e em Dúvidas dos novatos.
• Tópico geral: enviar à área geral, não a um tópico separado.

Cada tópico recebe sua própria mensagem. Repetir o mesmo ID em uma ação não cria outra cópia. O destino de logs também pode ter tópicos, se oferecer esse recurso; use os IDs do destino, não os do grupo de origem.

Mais tópicos significam mais envios no limite de ações. Veja os exemplos numéricos em Limites.

Não é possível escolher grupos externos arbitrários nem conversas privadas dos membros. Se o canal de logs estiver indisponível, a mensagem destinada à equipe não é redirecionada ao grupo principal.

Mensagem independente ou resposta à pergunta

Mensagem normal serve para boas-vindas ou avisos independentes.

Responder à mensagem do acionador (responder à mensagem do gatilho) é útil para dúvidas de pagamento: as instruções ficam vinculadas àquela pergunta.

Use no local da conversa original, onde a mensagem existe. Se a ação envia a outro grupo ou tópico, não suponha que o vínculo será mantido. Confira qual modo o editor mostra.

Evite acumular lembretes repetidos

Ilya pergunta sobre as gravações hoje; uma hora depois, Marina pergunta também. Se a resposta antiga não for mais necessária, ative Excluir resposta anterior (excluir a resposta anterior desta ação): o próximo envio remove a resposta associada a ela.

A regra tem uma configuração geral de limpeza. Em cada envio, escolha:

• Usar a configuração do gatilho (usar a configuração da regra) — seguir a escolha geral. Alterá-la na regra também muda esta ação.
• Sem limpeza — manter as respostas desta ação mesmo com a limpeza geral ativada.
• Excluir resposta anterior — ativar a limpeza especificamente para esta ação.

Por exemplo, substitua informações aos membros, mas mantenha os logs como registro. Escolha Sem limpeza na ação de logs.

A limpeza é acompanhada separadamente para cada ação e tópico. O lembrete do Suporte substitui sua versão anterior ali; o de Estudos substitui a própria. Logs são apagados no destino de logs.

Duas ações com texto idêntico ainda guardam respostas anteriores separadas. Uma mensagem aleatória de boas-vindas substitui a resposta anterior da própria ação, não a última de todo o conjunto. Reordenar as linhas não muda isso.

A opção não procura texto idêntico no grupo inteiro nem apaga mensagens de membros. Também não significa “apagar após cinco minutos”: é preciso outro envio. Lembretes antigos, enviados antes da atualização desse mecanismo, podem permanecer. Confira com novos envios.

Várias ações e respostas diferentes

Às vezes, uma resposta não basta. Uma infração pode exigir advertência e explicação. Já as boas-vindas podem ficar melhores com alguma variedade. Dois modos cobrem essas tarefas.

Executar todas as ações

No modo Executar todas, o Combot segue a lista de cima para baixo.

Um comando de moderação pode:

1. Advertir o membro.
2. Enviar a explicação: “Conversem sobre as ideias, sem ataques pessoais”.
3. Apagar a própria mensagem do comando.

Coloque as ações na ordem desejada. Se a advertência funcionar, mas a explicação não puder ser enviada, a advertência não é desfeita automaticamente. Confira tanto a resposta quanto o efeito sobre o membro.

Uma lista longa pode atingir o limite. Enviar a vários tópicos com limpeza custa mais que uma mensagem informativa, por exemplo. Veja o cálculo em Limites.

Escolher uma resposta aleatória

Um clube pode preparar três boas-vindas:

• “Boas-vindas! Conte um pouco sobre você.”
• “Que bom ter você no clube! Comece pelas informações fixadas.”
• “Olá! Explore os tópicos e entre na conversa.”

Adicione três ações de envio e escolha Uma aleatória. Quando alguém entra, o Combot seleciona uma ação desse conjunto.

Aleatoriedade não garante alternância. Dois novatos seguidos podem receber o mesmo texto. Não é possível definir probabilidades diferentes para as opções.

A estrela Sempre: ações obrigatórias e uma escolha aleatória

Suponha que stickers não sejam permitidos em Estudos. Você quer apagá-los sempre e escolher aleatoriamente uma entre três mensagens pedindo o envio no Bate-papo.

1. Crie um gatilho para stickers em Estudos. Marque Excluir mensagem com a estrela Sempre.
2. Deixe os três lembretes sem estrela.
3. Escolha Uma aleatória.

O bot executa a exclusão obrigatória e um envio escolhido. As ações selecionadas mantêm sua ordem na lista.

Se todas tiverem estrela, todas são executadas: não sobra nada para sortear. Se nenhuma tiver, uma ação aleatória é executada. A escolha acontece depois que as condições correspondem; não é um sorteio para decidir se o bot responderá à regra.