Este guia explica como configurar a árvore do respondedor automático ramificado do Deskgram 2. Veja as funções na página do módulo. Configurações conferidas no código em 24 de outubro de 2026.
O módulo responde a mensagens privadas recebidas pelas contas escolhidas. Mantém a etapa de cada interlocutor, escolhe uma resposta disponível e envia o texto preparado. Comece com uma árvore curta e teste de outra conta sua.
Escolha o modo
Em CONFIG.EXE → Geral, há duas opções:
| Modo | Seleção da resposta |
|---|---|
| Ramificado | Gatilhos dos filhos ou AI decision do nó atual; admite ramo padrão quando não há correspondência |
| Sequencial | Cada nova mensagem avança para a próxima resposta; sem gatilhos nem AI decision |
Sequencial não envia a cadeia toda ao iniciar. Cada etapa exige nova mensagem recebida. Mantenha um único filho seguinte em cada etapa; use ramificação para respostas alternativas.
O estado pertence ao par “conta selecionada e interlocutor”. A mesma pessoa conversando com duas contas suas não compartilha um percurso. O estado vive na tarefa ativa; perfil salva configurações, não garante recuperação das posições reais após reiniciar.
Monte a árvore
O nó inicial representa a mensagem recebida. Adicione filhos com +, como “Preço” e “Instalação”. O lápis abre configurações. Use nomes identificáveis no log.
Arraste nós, amplie pela roda e mova a vista arrastando o fundo. Para ligar um nó existente, arraste + até ele. Alinhar organiza a árvore, Voltar desfaz a última mudança do quadro, Encontrar nó localiza um bloco. Expandir abre um espaço maior.
Teste primeiro escolha inicial, continuação e encerramento; amplie depois. Ao mudar conexões, confira se o bloco continua filho da etapa que deve selecioná-lo.
Configure gatilhos e mensagens
Desative AI decision no primeiro teste. Em Geral do filho, separe gatilhos por vírgulas ou linhas:
- “Preço”:
preço, custo, valor. - “Instalação”:
instalação, instalar.
A comparação ignora maiúsculas e considera limites de palavra. Somente os filhos da etapa atual participam. O mesmo gatilho em outra parte pode levar a outra resposta. Se vários irmãos correspondem, a ordem importa: refine sobreposições e teste os casos.
Em Mensagem, escolha:
- Texto: resposta preparada.
{Olá|Boa tarde}escolhe uma variante no envio. - Mensagem complexa: Salvar e configurar mensagem complexa abre o editor separado de texto e anexos.
Confira cada conteúdo. Selecionar o ramo correto não corrige erros de texto ou arquivo daquele nó.
Controle as transições
Transição normal
Depois do envio bem-sucedido, o nó escolhido vira a etapa atual. A próxima mensagem consulta seus filhos. Um nó sem filhos não retorna automaticamente ao início; para isso, configure o encerramento explícito.
Encerrar conversa
Após envio correto, retorna ao início da árvore. A próxima mensagem pode iniciar o cenário novamente. Filhos abaixo do encerramento não são usados. Falha de envio não equivale a concluir a etapa.
Ramo padrão
Cada pai pode ter um filho padrão em ramificação. Ele é usado quando gatilhos normais não correspondem; seus próprios gatilhos não participam da seleção padrão. A interface substitui a escolha anterior ao marcar outro no mesmo nível.
Serve para uma pergunta preparada: “Você precisa de valores ou de ajuda com a instalação?”. Não é resposta escrita automaticamente pela IA.
Permanecer na etapa atual
Envia a resposta do filho escolhido, mas mantém a etapa anterior. A próxima entrada volta a poder escolher os ramos vizinhos anteriores; filhos do bloco de esclarecimento não viram o próximo nível.
Só vale em ramificação e não deve ser combinado com encerramento. Em sequencial, projete a progressão da cadeia em vez dessas regras.
Ative AI decision se necessário
AI decision escolhe pelo sentido um filho existente, sem reescrever automaticamente a resposta preparada.
Ative IA no módulo, escolha provedor e modelo e depois habilite AI decision no nó de onde sai a escolha. No inicial escolhe o primeiro ramo; nos demais, a continuação após a resposta enviada.
Exemplo de instrução: “Preço corresponde a valores e planos. Instalação corresponde a baixar e iniciar. Se nenhum servir, não escolha ao acaso”. Incluir histórico fornece contexto recente disponível, não necessariamente toda a conversa.
IA exige ativação tanto no módulo quanto no nó atual. Nesse caso, gatilhos não são filtro prévio obrigatório. Se estiver desativada em qualquer nível, funcionam gatilhos normais e ramo padrão. Sequencial não usa AI decision para transições.
Diferencie ausência de correspondência e falha técnica. ainomatch ou no_candidates podem usar o ramo padrão. Erro de provedor, saída vazia ou resposta inválida não mudam automaticamente para gatilhos ou padrão. Leia a razão no log.
Veja o guia do componente IA. Disponibilidade, chave, custo e respostas do provedor são conferidos separadamente.
Tempo e atraso
Em Geral, defina minutos da tarefa. 0 remove o limite desse temporizador. O atraso é um intervalo em segundos antes de responder; mínimo não pode superar máximo.
Não significa mostrar “digitando”. Uma nova mensagem do mesmo remetente enquanto a resposta anterior é preparada pode ser ignorada e registrada. Não há promessa de fila de todas essas mensagens. No teste, envie uma por vez e espere.
Confira contas livres e limites de acesso ao módulo. Aparecer no seletor não libera uma conta ocupada por outra tarefa.
Mensagens antigas
Nas opções avançadas há Responder mensagens antigas e Não responder anteriores à data. É uma varredura na inicialização, não carregamento contínuo do histórico completo.
O chat privado precisa ter não lidas; a última mensagem deve ser recebida, ter texto não vazio e respeitar a data mínima. Verifica-se somente a última, não cada não lida. Se a última foi enviada por você, não se qualifica.
Antes de responder há nova checagem: atividade recente ou última mensagem diferente pode cancelar o tratamento da antiga. Teste a data com um chat seu.
Sem essa opção, use mensagens novas após iniciar. Uma conversa antiga já lida não testa a varredura de não lidas.
Excluir por palavras no histórico
Filtragem por palavras no chat define exclusões e profundidade de 1–100 mensagens. Cada palavra configura palavra inteira e diferenciação de maiúsculas.
Examina histórico recente disponível, entradas e saídas; texto encaminhado e nomes ou títulos disponíveis também podem participar. É diferente dos gatilhos da mensagem atual.
Uma exclusão impede resposta e transição. Se não conseguir buscar histórico, pula a resposta com aviso, em vez de tratar o filtro como aprovado.
Exemplo hipotético: exclua operador para não responder automaticamente onde solicitaram atendimento humano. Com profundidade 10, pedidos fora das últimas dez não entram. Teste maiúsculas, palavra inteira e substring separadamente.
Salve um perfil
Em Perfis, informe nome e salve. Para restaurar, escolha na lista e carregue. Importar JSON lê um cenário do arquivo.
Após carregar/importar, confira modo, árvore, textos, IA, filtros, tempo e atraso. Revise especialmente zeros se deseja execução sem temporizador. Perfil não arquiva mensagens recebidas.
Perfis ficam na pasta do programa e podem ser escolhidos em módulos com esse componente integrado. Consulte o guia do componente respondedor.
Excluir perfil remove o cenário salvo; Redefinir árvore altera a árvore atual. Salve antes a versão necessária.
Teste antes do trabalho
- Escolha uma conta de teste conectada e livre.
- Revise árvore, modo, mensagens e ajustes; salve perfil.
- Clique Iniciar; para depois há Adiar.
- De outra conta sua, envie “preço” por privado e espere.
- No estado inicial, teste “instalação” e uma pergunta alheia para o padrão.
- Percorra continuação, esclarecimento que mantém etapa e final que reinicia.
- Teste IA, exclusões e não lidas antigas separadamente, se for usar.
- Compare com o log e mude uma configuração por vez.
Resolver problemas
| Sintoma | Verificar |
|---|---|
| Sem resposta a nova entrada | Conta, conexão, tempo, privado após início, exclusões |
| Chat antigo ignorado | Opção, não lidas, último recebido com texto, data, sem atividade nova |
| Ramo diferente | Etapa atual, ordem dos gatilhos, IA |
| Não continua | Filho existente, encerramento, nova mensagem em sequencial |
| Esclarecimento repete | Permanecer conserva alternativas anteriores |
| Padrão não resolveu erro IA | Não é fallback técnico; veja o log |
| Histórico não carrega | Conexão e aviso; falha pula resposta |
| Ignora durante atraso | Espere resposta anterior e consulte o log |
O cenário não processa grupos, canais, bots, saídas próprias nem conversas antigas inelegíveis. Verifique erros Telegram/IA pelo registro concreto. Uma árvore correta não garante disponibilidade externa.
Páginas relacionadas
Todas as versões usam capturas em russo porque o módulo ainda não foi completamente traduzido. Mostram operações principais; ajustes adicionais da sua versão podem variar.