Comandos personalizados e suas primeiras regras

Prepare o grupo

Imagine o grupo de um curso online. Cada novo aluno pergunta onde estão as gravações das aulas, e o tutor procura o mesmo link de novo. Vamos começar deixando o Combot enviar essas informações.

Adicione @combot ao grupo. Abra o painel do Combot, escolha o grupo e entre em Automação.

Confira duas coisas: se você pode alterar as configurações e se o bot pode executar a ação. Ter acesso às estatísticas, por exemplo, não significa poder criar regras. E a permissão para enviar mensagens não permite ao bot apagar mensagens de outras pessoas.

Escolha as permissões conforme a tarefa:

• Enviar informações: o bot precisa poder escrever no grupo ou tópico escolhido — uma área de conversa separada dentro do grupo.
• Apagar publicidade: precisa de permissão para excluir mensagens.
• Silenciar ou banir membros: precisa de permissões de administrador para restringir membros.
• Aprovar pedidos de entrada: precisa de permissão para convidar usuários.
• Dar XP ou reputação: o recurso correspondente precisa estar ativado nas configurações do Combot.

Se houver um aviso acima da lista de regras, resolva-o primeiro. Salvar uma regra de “25 XP por uma resposta útil”, por exemplo, não fará com que ela funcione se o XP estiver desativado no grupo.

As regras pertencem ao grupo escolhido. Se você já sincroniza gatilhos entre vários grupos, edite o conjunto compartilhado no grupo de origem. Assim, você pode atualizar as informações do curso para vários grupos em um só lugar; a edição pode não estar disponível nos grupos que herdam essas regras.

Sua primeira regra: compartilhar informações úteis

No grupo do curso, é comum perguntarem: “Onde estão as gravações e as atividades?”. Vamos criar /course_info para responder. O comando não apaga nada nem restringe ninguém, então é um bom ponto de partida.

1. Clique em Adicionar acionador para adicionar um gatilho. Dê à regra o nome Curso — gravações e atividades.
2. Em Tipo, escolha Comando. Adicione /course_info.
3. Escolha Comando simples. Deixe Acionado por (quem pode chamar) aberto a todos, para que qualquer aluno possa usar.
4. Em ENTÃO, adicione Enviar mensagem. Você pode usar o texto abaixo, substituindo os nomes dos tópicos pelos seus.
   Texto da mensagem Copiar

   As gravações e as atividades estão na mensagem fixada. Envie dúvidas sobre as aulas no tópico Estudos e dúvidas de acesso no Suporte.

5. Mantenha Chat de origem (grupo de origem) e o tópico atual. Clique em Salvar ação para salvar a ação.
6. Clique em Validar para verificar e depois em Salvar acionador para salvar a regra. Confira se ela está ativada.
7. Envie /course_info no Telegram. As informações devem aparecer. Um simples “Olá, pessoal!” não deve acionar a regra.

Agora o tutor pode enviar um comando em vez de repetir a explicação. Depois, você pode adicionar um botão com o link dos materiais; veja Formate a resposta.

Validar procura problemas nas configurações. Não envia o comando nem confere a resposta no Telegram por você: essa última etapa continua sendo manual.

Explique o que o bot deve fazer

Quase toda regra pode ser descrita em uma frase:

Se alguém perguntar “como pagar” no Suporte, envie as instruções de pagamento.

O editor divide a frase em duas partes. Em SE, você explica a que situação responder. Em ENTÃO, escolhe o que fazer.

O bot não deduz a tarefa pelo nome da regra. Chamar uma regra de “Ajudar os novatos” não ativa nada por si só: ainda é preciso escolher os novos membros, um evento e uma ação.

Todas: cada condição precisa corresponder

Suponha que as instruções de pagamento sejam necessárias apenas no Suporte. Defina duas condições: o tópico certo e a frase “como pagar”.

“Como pagar a assinatura?” no Suporte corresponde. A mesma frase no Bate-papo não. “Como trocar a senha?” no Suporte também não corresponde.

É assim que funciona Todas, ou E: todos os requisitos escolhidos precisam ser atendidos.

Qualquer: basta uma opção corresponder

Algumas pessoas escrevem “como pagar”; outras, “o pagamento não passa”. Ambas precisam das mesmas instruções.

Onde o editor oferece Pelo menos uma (qualquer), ou OU, basta uma opção corresponder. A pessoa não precisa usar as duas frases na mesma mensagem.

Exclusões: deixar pessoas ou mensagens de fora

Em um grupo de vagas, você lembra as regras de publicação, mas não quer responder aos anúncios da própria equipe. Adicione os administradores em Excluir.

Uma exclusão não remove alguém do grupo nem tira suas permissões. Ela apenas diz: “Este conjunto de condições não corresponde a esta pessoa”.

As exclusões de condições de usuário também valem no modo Qualquer. Por exemplo, atender a uma condição de atividade não anula a exclusão de administradores no mesmo conjunto.

Várias alternativas OU na mesma regra

Use Adicionar opção OU (adicionar alternativa OU) quando conjuntos diferentes de condições devem gerar a mesma resposta. Por exemplo:

• Alguém escreve “como pagar” no Suporte.
• Alguém escreve “onde assinar” em Dúvidas dos novatos.

Descreva as duas situações e escreva as instruções uma vez. O tipo de evento é compartilhado. Mesmo que as duas alternativas correspondam, a lista de ações desta regra só é executada uma vez.

Duas regras separadas funcionam de outro jeito: cada uma pode enviar uma resposta. É por isso que regras parecidas às vezes geram mensagens duplicadas.

As alternativas OU são independentes. Se mensagens de administradores não devem corresponder a nenhuma delas, inclua a exclusão em todas.

Você pode desativar uma alternativa específica. Por exemplo, pausar as respostas em Dúvidas dos novatos e manter as do Suporte. Desative a regra principal para interromper o cenário inteiro.

Um bom hábito: leia a condição em voz alta antes de salvar. “Responder à palavra ‘pagamento’ em qualquer lugar” e “responder a dúvidas de pagamento apenas no Suporte” são regras diferentes.

Comandos personalizados para membros e moderadores

Dois tipos de comandos são úteis em um grupo. Alguns trazem uma resposta: onde ver os horários, como falar com o tutor ou onde entregar atividades. Outros ajudam o moderador a agir sobre uma pessoa, como dar uma advertência ou recompensar uma resposta útil.

Os nomes de comandos deste guia são exemplos. Crie-os primeiro no editor; digitar esses nomes no grupo não os adiciona automaticamente ao Combot.

Nome, descrição e tipo da regra

O Nome aparece na lista de automações. Escolha algo que um colega entenda de imediato: “Curso — informações aos alunos” ou “Vagas — lembrete de salário”. O limite é de 80 caracteres.

A Descrição é uma nota para administradores, com até 280 caracteres. Por exemplo: “Mostrar as informações à nova turma. Desativar quando o curso terminar”. O bot não publica essa descrição no grupo.

Em Tipo, escolha:

• Acionador (gatilho) para o bot responder automaticamente a uma situação correspondente, como uma pergunta sobre “como pagar”.
• Comando para alguém executar a regra de propósito, por exemplo enviando /course_info.

Vários comandos para a mesma resposta

Você pode adicionar /course_info e /course_help à mesma regra. Seja qual for o nome usado pelo membro, ele recebe as mesmas informações.

Adicione cada nome separadamente. Use letras latinas, números e sublinhados. Escolha nomes que não estejam sendo usados por comandos nativos do Combot ou por outros bots do grupo.

Comando simples: receber informações

Escolha Comando simples quando a pessoa precisa de uma resposta, não de uma ação sobre um usuário escolhido.

Por exemplo, um aluno envia /course_info, e o bot explica onde estão as gravações. Não é necessário selecionar ninguém com Responder.

Ações sobre usuários não estão disponíveis neste modo. Um comando simples não implementa “cada pessoa envia o comando para dar XP a si mesma”.

Ao ativar Excluir mensagem de comando (excluir a mensagem do comando), /course_info desaparece da conversa, mas a resposta do bot permanece. Assim, os comandos não se acumulam no grupo.

Comando como resposta: escolher uma pessoa

Suponha que Ilya descumpra uma regra e Anna, moderadora, queira adverti-lo.

1. Anna escolhe Responder na mensagem de Ilya.
2. Ela envia /team_warn como resposta.
3. O Combot adverte Ilya.

Para configurar, escolha Alvo de resposta (alvo da resposta) no comando. Permita administradores do Telegram em Acionado por e selecione o usuário da mensagem respondida em Aplicar a, na ação.

Anna é a autora do comando. Ilya escreveu a mensagem à qual ela respondeu. Confundir essas pessoas nas configurações muda completamente a tarefa.

A condição Aplicado a em SE limita quem pode ser alvo do comando. Aplicar a, dentro de cada ação, escolhe quem recebe aquela ação.

Quando disponível, a ação pode atingir o autor do comando, o usuário da mensagem respondida ou ambos. A advertência deste exemplo deve atingir apenas Ilya.

Permitir que alguém use o comando não o torna administrador do Telegram. O próprio Combot também precisa de permissão para executar a ação.

O que é apagado? Se você adicionar a exclusão da mensagem do comando, desaparece /team_warn, não a mensagem original de Ilya. Escolher quem recebe a advertência não muda qual mensagem será apagada.

A que o bot pode responder

Quando responde à pergunta “O que precisa acontecer?”. Para um gatilho, escolha um evento da lista. Um comando é mais simples: a mensagem que o contém executa a regra.

Mensagens, comentários e publicações

Qualquer mensagem do chat / Mensagem do chat (mensagem do grupo). Use nas situações comuns: uma pergunta sobre a aula, uma vaga ou um documento. Por exemplo, o bot encontra “onde está a gravação” e envia as informações.

Comentários. Escolha para conversas sobre publicações de um canal vinculado. Por exemplo, responder “como me inscrevo” nos comentários das publicações da escola.

Postagem do canal (publicação do canal). Refere-se às próprias publicações do canal vinculado. Por exemplo, ao aparecer um post com #aovivo, envie orientações de discussão ao grupo. Uma condição de mensagem comum não substitui uma condição de publicação.

Incluir edições. Alguém publica uma vaga curta e depois adiciona um contato. Com essa opção, o Combot verifica a mensagem editada também. As ações podem se repetir, então tenha cuidado ao combinar edições com recompensas.

Pedidos de entrada, chegadas e saídas

Solicitação de adesão (pedido de entrada). A pessoa ainda aguarda uma decisão. Por exemplo, organizadores querem aprovar automaticamente pedidos por um convite específico.

Novo membro. A pessoa já entrou. Agora você pode recebê-la: “Boas-vindas! Comece pela mensagem fixada”.

Saída de um membro (membro saiu). A pessoa saiu por conta própria ou foi removida. Por exemplo, envie um aviso ao canal de logs onde a equipe acompanha os eventos. O evento pode envolver duas pessoas: quem saiu e quem fez a remoção.

Pedir para entrar e entrar são etapas diferentes. Dar boas-vindas nas duas pode gerar duas mensagens. Escolha a etapa em que a informação é útil.

Impulsos

Novo Boost (novo impulso). Por exemplo, depois que alguém impulsiona o grupo de um clube, o bot escreve: “Obrigado por apoiar a comunidade!”.

Boost removido (impulso removido). Por exemplo, a equipe recebe um aviso nos logs. Isso não significa necessariamente que a pessoa decidiu retirar o impulso, então evite um tom de cobrança.

Reações

Reação do usuário (reação de usuário). Alguém adicionou, removeu ou trocou uma reação. Por exemplo, a equipe recebe um aviso sobre uma mudança de reação pertinente em uma conversa de trabalho.

Contagem de reações (quantidade de reações). O Telegram enviou uma atualização da contagem de uma publicação do canal vinculado. Por exemplo, o bot avisa os moderadores sobre um post com 20 a 30 reações dos tipos escolhidos.

A contagem não informa quem deixou cada reação. E a regra pode rodar de novo em atualizações posteriores. Veja Reações e listas de tarefas para configurar esses filtros sem repetições inesperadas.

Listas de tarefas

A equipe prepara um webinar no grupo de trabalho. Alguém cria uma lista, adiciona um item ou marca a apresentação como concluída. Há três eventos para isso:

• Nova lista de verificação (nova lista) — uma lista apareceu. Você pode avisar que há um novo plano para seguir.
• Tarefas da lista de verificação adicionadas (tarefas adicionadas) — a lista ganhou itens. Por exemplo, envie um aviso aos logs.
• Tarefas da lista de verificação concluídas (tarefas concluídas) — tarefas foram marcadas como feitas. Você pode convidar os colegas a abrir a lista e conferir as mudanças.

O último evento não significa “está tudo pronto para o webinar”: talvez só uma tarefa tenha sido concluída.