Transfira regras e resolva problemas

Organize suas regras

Logo o chat acumula várias regras úteis: materiais do curso, pagamentos, vagas e comandos dos tutores. Veja como organizar tudo, desativar o que não precisa mais e levar as configurações para a próxima turma.

Encontre, desative, copie ou exclua

A lista mostra as regras e uma breve descrição das ações. Pesquise “pagamento”, por exemplo, ou use os filtros Todos (todas), Acionadores (gatilhos), Comandos e Problemas.

Desativar. O curso acabou? Desative a regra de informações. As configurações ficam salvas, e você pode ativá-la novamente depois.

Desativar só uma alternativa OU. Imagine que a resposta sobre pagamento ainda seja necessária no Suporte, mas temporariamente não em Dúvidas dos novatos. Desative essa alternativa. A condição principal e as outras alternativas ativas continuam funcionando, e sua escolha é mantida ao reabrir a regra.

Desativar a regra inteira. O interruptor principal interrompe tanto a condição principal quanto todas as alternativas OU. Desativar uma alternativa não interrompe a regra inteira.

Copiar. Já tem uma resposta para PDFs e quer algo parecido para outro tipo de documento? Faça uma cópia e confira o nome, as condições, o comando, o estado de ativação e as ações. Uma cópia sem alterações pode fazer as duas regras responderem ao mesmo arquivo.

Excluir. Você pode remover uma regra de um evento que acabou há muito tempo. Se talvez precise dela novamente, exporte antes para guardar uma cópia recuperável das configurações.

Confira as configurações

Validar verifica a regra aberta. Validar tudo (validar todas) verifica o conjunto inteiro.

Talvez você tenha criado uma recompensa por respostas úteis, mas esquecido de ativar o XP. Ou selecionado um canal de registro que ainda não está conectado. Resolva esses problemas antes de ativar a regra.

A validação também pode apontar nome vazio, comando ou ação ausente, horários inválidos, tipos de mensagem incompatíveis, condições contraditórias ou um limite excedido.

Não ignore um aviso só porque conseguiu salvar. Uma resposta salva não ajuda muito se o bot não consegue enviá-la ao lugar certo.

Você pode manter desativada uma regra antiga baseada no tempo desde a primeira mensagem ou outra primeira atividade para preservar a ideia. Não é possível ativá-la com essa condição sem suporte. O tempo desde a entrada mede outra coisa: só use como substituto se atender à sua necessidade.

Depois de conferir as configurações, experimente a regra no Telegram. Envie um PDF correspondente e uma foto comum, por exemplo. A resposta deve aparecer apenas para o PDF.

Por que as regras podem se sobrepor

Imagine que uma regra responda a “pagar” e outra a “como pagar”. “Como pagar o curso?” corresponde às duas, então a pessoa pode receber duas respostas.

A verificação de conflitos procura condições idênticas; o texto da ação não importa. Por isso, Sem conflitos não comprova que regras parecidas nunca vão se sobrepor.

Tenha cuidado especial com recompensas repetidas e decisões opostas, como uma regra aprovar uma solicitação de entrada e outra recusá-la.

Exporte para guardar ou compartilhar configurações

Antes de começar uma nova turma, você pode exportar todas as regras ou apenas algumas. A exportação é um pacote de configurações em JSON. Não é preciso editar o arquivo à mão para transferir as regras.

Guarde uma cópia antes de uma alteração grande ou compartilhe com um colega. Ela contém as configurações, não o histórico do que o bot fez.

Confira o conteúdo antes de compartilhar: os textos e as condições podem conter convites privados, IDs de participantes e links que você não quer divulgar.

Importe para levar regras a outro chat

Vai abrir uma segunda turma? Abra Importar, cole o pacote exportado e confirme.

A importação adiciona regras às existentes. Ela não as substitui. Importar o mesmo pacote duas vezes pode criar duas cópias da mesma resposta.

Os tópicos selecionados são redefinidos na importação. Atividades no grupo antigo e Atividades no grupo novo são destinos diferentes. Após a redefinição, uma condição antes limitada a um tópico pode abranger todo o chat de origem; uma ação direcionada a um tópico específico volta para o local atual da conversa.

Transfira regras desativadas ou experimente a importação primeiro em um grupo de teste. Importar não transforma todas as regras em rascunhos seguros: o estado de ativação salvo é respeitado.

Depois de importar:

1. Selecione novamente os tópicos de origem e os destinos das respostas.
2. Confira os convites, os usuários selecionados e o canal de registro.
3. Confira se as ações são executadas juntas ou se uma é escolhida aleatoriamente. Verifique também as ações obrigatórias marcadas com a estrela Sempre.
4. Verifique se o XP ou a reputação estão ativados, quando necessários, e se o bot tem as permissões exigidas.
5. Valide as configurações.
6. Experimente uma regra com uma mensagem que corresponda e outra que não corresponda. Depois ative as demais.

Se você já usa gatilhos antigos

Um gatilho antigo talvez respondesse a “pagamento” em qualquer lugar do chat. Na Automação, você pode acrescentar um tópico específico, horário de atendimento e várias maneiras de fazer a pergunta. Outras tarefas podem usar eventos separados, condições sobre participantes, várias ações e comandos.

Migre essas regras aos poucos: recrie o comportamento necessário, confira o resultado e desative o gatilho antigo duplicado. Não presuma que uma exportação do Triggers v2 já seja um pacote pronto para importar no novo formato.

Quantas regras e ações você pode adicionar?

Uma ou duas regras costumam bastar para começar. Se estiver preparando um conjunto grande para um curso ou várias comunidades, confira os limites primeiro.

Regras salvas

Na data de revisão deste guia, os limites são:

• Free: até 2 regras separadas, sem alternativas OU adicionais para a regra inteira.
• Pro: até 50 regras, com até 2 alternativas OU adicionais em cada uma.
• Business: até 100 regras, com até 5 alternativas OU adicionais em cada uma.

Um comando para os materiais do curso e um gatilho de resposta sobre pagamento são duas regras separadas. Uma regra desativada ainda ocupa uma vaga: desativar não é remover. As alternativas OU ficam dentro de uma regra e têm seu próprio limite.

Ações configuradas

Uma regra pode conter até 100 linhas de ações. Isso é útil para variar as respostas: por exemplo, 30 mensagens de boas-vindas, com uma escolhida aleatoriamente a cada entrada.

Uma execução permite até 20 ações pelo contador do editor, identificado como limite de ações da API do Telegram. Uma linha de configuração nem sempre equivale a uma ação no contador: enviar uma resposta a três tópicos conta como três.

Alguns exemplos ajudam a entender:

• Enviar uma mensagem informativa a um tópico: 1.
• Enviá-la a três tópicos: 3.
• Enviá-la a três tópicos com limpeza da resposta anterior: 6 — três envios e três vagas de limpeza. A limpeza conta mesmo na primeira execução, quando ainda não há respostas anteriores.
• Aplicar uma advertência a um participante e enviar uma explicação sem limpeza: 2.
• Adicionar 25 XP: 0 neste cálculo, embora a linha da ação ainda conte para o limite de 100 linhas.

As demais ações são contadas assim:

• Aplicar ou remover uma advertência, restringir, retirar uma restrição ou excluir mensagens de um participante: 1 por participante selecionado conhecido pelo bot. Ambos (ambos) pode contar como até 2.
• Excluir a mensagem do evento, aprovar ou recusar uma solicitação de entrada: 1 cada.
• Alterar a reputação, assim como o XP: 0 neste cálculo.

Executar todas conta a lista inteira. Uma aleatória conta todas as ações obrigatórias mais a opção aleatória de maior custo possível. O editor não presume que a escolha será sempre o envio mais barato.

Não existe um limite separado de “no máximo cinco envios”. Uma lista simples, sem limpeza nem outros custos, pode conter 20 envios. Isso não garante que todas as mensagens cheguem: as permissões do bot e os limites do Telegram continuam valendo.

Quando a próxima ação não cabe

O bot calcula o custo completo de uma ação antes de executá-la. Se ela não couber, nem essa ação nem o restante da lista serão executados. As ações já concluídas não são desfeitas.

Por exemplo, uma ação que envia a 21 tópicos não será reduzida aos primeiros 20. Uma tentativa de ação que falha também usa a vaga reservada.

O orçamento de 20 ações vale para uma execução de uma regra. Não é uma cota diária compartilhada pelo chat ou por todas as regras.

O contador ajuda a planejar uma regra; ele não conta toda requisição que o bot faz ao Telegram. Uma advertência também pode acionar uma punição das configurações do chat, e limpar o histórico de mensagens pode exigir várias requisições. Por isso, o número real de requisições ao Telegram pode passar de 20.

Esses detalhes raramente atrapalham uma resposta informativa simples. Para uma lista longa com moderação, vários tópicos e limpeza, use o contador do editor e confira o resultado de cada ação necessária.

Os limites dos planos podem mudar. Confira os valores disponíveis no painel antes de preparar um conjunto grande.

Quando o resultado não é o esperado

Comece por um exemplo específico: o que a pessoa escreveu, onde escreveu e qual resposta você esperava. É mais fácil encontrar uma condição a mais assim do que alterar toda a configuração de uma vez.

A regra está salva, mas o bot não responde

Talvez você tenha enviado um PDF, mas a regra espere texto simples. Ou a pergunta chegou no Bate-papo, enquanto a regra está limitada ao Suporte.

Confira o estado de ativação, o chat, o evento e as condições. Se a mensagem corresponder apenas a uma alternativa OU, verifique se ela também está ativa. Em um grupo de teste, mantenha uma condição simples e uma resposta, depois recoloque as outras configurações uma a uma. Se fizer uma cópia no mesmo chat, desative a original durante o teste.

São 10h, mas nenhuma mensagem apareceu

Na Automação, um horário significa “processar os eventos correspondentes durante estas horas”, não “enviar uma mensagem às dez da manhã”.

O bot pode responder a uma pergunta sobre a gravação recebida no horário selecionado. Para publicar a programação das aulas em um horário definido, use o Agendador de anúncios.

A pessoa recebeu a recompensa de novo

Dois moderadores podem ter respondido /reward_member à mesma mensagem útil. São duas chamadas, e a recompensa pode ser adicionada duas vezes.

Procure comandos repetidos, edições, novas entradas no grupo e novas mensagens correspondentes. Um álbum também pode chegar como várias mensagens. Excluir edições não impede a pessoa de enviar um novo texto.

“Exatamente uma mensagem” não garante uma recompensa única pela primeira mensagem: o contador é atualizado separadamente. Se recompensas duplicadas forem inaceitáveis, combine uma verificação separada em vez de depender apenas dessa condição.

Uma reação foi adicionada, mas o resultado foi inesperado

Ilya tinha um 👍, adicionou ❤️, e a condição de 👍 correspondeu novamente. Isso acontece porque a regra verifica as reações que permanecem após a mudança. 👍 ainda está entre elas.

Confira a direção da mudança e os emojis selecionados. Um filtro por emoji específico exige a direção de adição. Para a contagem de reações, confira a soma dos tipos escolhidos: atualizações com 20 e 21 reações podem corresponder ao mínimo de 20. Zero ou um campo vazio não define um limite do intervalo.

Uma pergunta recebe duas respostas iguais

Uma causa comum são duas regras com condições parecidas, como “pagar” e “como pagar”. Outras possibilidades são uma cópia importada, um gatilho antigo ainda ativo ou as boas-vindas padrão funcionando junto com a nova regra.

Veja todas as regras que poderiam responder à pergunta, incluindo conjuntos sincronizados. Desative as desnecessárias uma a uma e repita o mesmo exemplo.

O moderador recebeu a advertência

A ação provavelmente está direcionada a quem enviou o comando, não à pessoa da mensagem respondida. No exemplo de Anna e Ilya, selecione Ilya — o autor da mensagem à qual Anna respondeu.

Confira o modo Alvo de resposta (alvo da resposta), a resposta de fato no Telegram e Aplicar a (aplicado a) em cada ação. Excluir a mensagem do evento ainda exclui a mensagem do comando, não a mensagem original de Ilya.

Meu comando personalizado não funciona

Talvez o comando exija uma resposta, mas você o enviou sozinho. Ou você não pertença ao grupo selecionado em Acionado por.

Confira a escrita, os usuários autorizados e a forma de chamada. Verifique se você realmente criou o comando no editor e se o nome já não é usado por um comando integrado.

A explicação chegou, mas a mensagem não foi excluída

Uma resposta não comprova que as outras ações funcionaram. O bot pode ter permissão para enviar mensagens, mas não para excluí-las.

Confira as permissões do Combot e o status do participante. Uma regra não pode contornar as restrições do Telegram, especialmente para administradores. Se houver mensagem, advertência e silêncio na regra, confira cada resultado separadamente.

Só o começo da lista de ações foi executado

Uma regra com vários envios a tópicos diferentes e limpeza em cada um usa o orçamento mais rápido do que a quantidade de linhas sugere.

Veja Limites: quando a próxima ação não cabe por inteiro, o restante da lista não é executado. Uma tentativa que falha também conta. Mas o limite pode não ser a causa: confira também o acesso ao destino, as permissões e se o usuário selecionado está disponível.

O XP ou a reputação não aumentou

Talvez você tenha adicionado uma recompensa antes de ativar o XP no chat da nova turma. Confira o recurso, o destinatário e uma alteração em número inteiro diferente de zero. 25 significa “adicionar 25”, não “definir o total como 25”.

No comando de agradecimento a quem convidou, responda a uma mensagem da pessoa que fez o convite. Se a recompensa usar uma solicitação de entrada por link, confira se o link está no catálogo do Combot e se seu criador é conhecido. Um destinatário desconhecido não é substituído pelo novato.

A regra correspondeu a alguém que você não considera novato

Compare sua ideia de novato com as configurações do chat. A categoria de novos membros depende dessas configurações e das exceções aplicáveis. Membros comuns, por si só, não significa membros antigos.

Se precisar de um limite preciso, como as primeiras duas horas ou no máximo dez mensagens, configure isso separadamente. Confira de qual pessoa as condições tratam e não confunda administradores do Telegram com administradores do painel do Combot.

O tempo desde a entrada não é contado como você esperava

Ilya entrou ontem às 23h50. Hoje, às 0h10, ele ainda está no chat há apenas vinte minutos: passar da meia-noite não acrescentou um dia.

Confira as unidades e a comparação. Um mês aqui equivale a 30 dias. Regras antigas podem contar dias completos decorridos, enquanto uma unidade explícita usa uma duração exata. Se precisar de Igual (igual a), confira se a configuração antiga não manteve Pelo menos (pelo menos).

Um link não é considerado externo

Você pode selecionar o convite para a aula aberta e esperar que todos os outros links sejam externos. Mas outro link também pode estar registrado no catálogo desse chat no Combot.

Externo significa ausente de todo o catálogo, não ausente da sua seleção. Se a informação do convite estiver indisponível, o bot não deve tratá-lo como externo nem como certamente não utilizado.

Uma lista de tarefas mudou, mas não houve notificação

Confira se você copiou o link da própria lista, não da mensagem de serviço sobre a atualização. Um link com ?comment=… não serve; use um link direto para a mensagem no chat.

Para um link público, o Combot também precisa conhecer o nome de usuário correspondente do chat. Experimente concluir uma tarefa na lista selecionada e depois em outra lista próxima. A segunda não deve corresponder.

A verificação de idioma, biografia ou arquivo não correspondeu

Talvez você esteja esperando um vídeo, mas a pessoa envie a mesma gravação como documento. Para o bot, são tipos de mensagem diferentes.

Os dados do perfil também nem sempre estão disponíveis: a biografia vem de uma solicitação de entrada, e o código do idioma pode estar ausente. Desconhecido não significa zero, ausência de uma característica nem correspondência à sua negação. Confira quais informações o evento selecionado realmente fornece.

A resposta apareceu no tópico errado

Confira duas configurações separadas: onde procurar a mensagem e onde enviar a resposta. Talvez a pergunta precise vir do Suporte, mas a resposta tenha sido direcionada sem querer para Estudos.

Selecione os tópicos novamente após importar. Se uma resposta apareceu em vários lugares, confira a lista de destinos: ela é enviada a todos os tópicos selecionados. Mensagens de registro precisam dos IDs de tópicos do destino de registro, não do grupo de origem.

As respostas antigas do bot continuam lá

A limpeza pode estar ativada na regra, mas uma ação de envio pode indicar explicitamente que não deve excluir. Essa escolha da ação tem prioridade.

Confira a configuração e acione a regra novamente: a limpeza acontece no próximo envio, não por um temporizador. Cada ação e cada tópico acompanha sua própria resposta anterior. Em um conjunto aleatório, as boas-vindas B não necessariamente excluem as boas-vindas A. Mensagens antigas sem uma associação clara também podem permanecer.

A imagem de capa do curso não aparece

Abra o link da imagem e confira se o Telegram gera a prévia. O campo de imagem não faz o upload de um álbum de fotos.

Comece com uma imagem acessível e uma mensagem curta. Confira o resultado no Telegram, não apenas no editor.

O editor mostra Sem conflitos, mas as regras se sobrepõem

Ele procura condições idênticas. “Pagar” e “como pagar” têm escritas diferentes, mas podem aparecer na mesma pergunta.

Experimente as duas regras com a mesma mensagem. Se elas precisam de uma única resposta compartilhada, uma regra com alternativas OU pode ser mais útil do que duas respostas independentes.

Não é possível adicionar outra regra

Uma regra desativada do curso do ano passado ainda ocupa uma vaga. Confira o limite do plano e a quantidade de regras salvas, incluindo as desativadas e as cópias importadas.

Exporte um conjunto não utilizado antes de excluí-lo se talvez precise dele novamente.

Uma checagem rápida antes de começar

Para uma resposta sobre pagamento, a lista de verificação pode ser assim:

1. “Como pagar o curso?” no Suporte recebe a resposta esperada.
2. “Como mudar minha senha?” no mesmo lugar não recebe resposta sobre pagamento.
3. A mesma pergunta sobre pagamento no Bate-papo não recebe resposta se apenas o Suporte estiver selecionado.
4. Uma mensagem de um administrador excluído não corresponde a nenhuma alternativa em que você definiu essa exclusão.
5. Mensagens dentro e fora do horário de atendimento recebem as respectivas respostas esperadas.
6. Uma pergunta repetida não cria recompensas indesejadas nem mensagens extras.

Para um comando de moderação, experimente também como membro comum e confira se cada ação afeta a pessoa e a mensagem certas. Teste banimentos e exclusões em participantes e mensagens de teste: uma cópia das configurações recupera a regra, mas não uma mensagem já excluída.

Comece por uma tarefa que tome tempo da equipe todos os dias. Quando essa resposta ou comando funcionar como esperado, adicione a próxima.

Se precisar de ajuda com um cenário, pergunte no chat de suporte do Combot. Mostre as configurações e explique o resultado esperado, mas oculte convites privados e dados desnecessários dos participantes.

Que sobre menos explicação repetida e mais tempo para a conversa!