UC PR Bot
Configuração com IA para um grupo

Como configurar um bot do Telegram com IA

Este guia é do UC PR Bot. Descreva como o acesso a mensagens deve funcionar. O assistente devolve JSON. O bot mostra um resumo e não altera nada antes de Aplicar.

01

Abra o grupo no @UCPRbot

Escolha primeiro o grupo do Telegram. O JSON não tem um id de grupo, por isso o bot não aplica definições a outro chat.

02

Copie a instrução

No menu do grupo toque em Configurar com IA e depois em Copiar a instrução. O bot envia o ficheiro ucprbot-ai-prompt.txt.

03

Dê a uma IA capaz

Anexe o ficheiro ou cole o texto no ChatGPT, Claude, Gemini, DeepSeek ou noutro assistente que saiba devolver JSON. Depois descreva o grupo com palavras simples.

As capturas de tela mostram a interface do bot em inglês. Todos os menus do bot e as notificações para os membros também estão disponíveis em português.

Abra Configurar com IA no menu do grupo
Abra Configurar com IA no menu do grupo
Copie a instrução e envie o JSON para aqui
Copie a instrução e envie o JSON para aqui

4. Envie o JSON de volta ao bot

A resposta deve ser um objeto JSON com schema ucprbot.settings.v1. Envie o texto ou um ficheiro .json. Se não couber numa mensagem do Telegram, envie um ficheiro.

5. Reveja e aplique

O bot mostra o que vai mudar. Nada é guardado até tocar em Aplicar. Campos desconhecidos, código extra e definições de outro grupo são rejeitados.

A instrução chega num ficheiro de texto curto
A instrução chega num ficheiro de texto curto

Que ferramentas de IA podem preparar as definições

Basta qualquer assistente que aceite uma instrução de texto e saiba devolver JSON. Não lhe dê o token do bot nem acesso ao Telegram. O bot continua a verificar cada campo.

O que dizer ao assistente

Só subscrição do canal

Exigir subscrição de @mychannel antes de publicar. Manter o antispam ligado. Não exigir convites.

Um convite real

Um membro pode escrever depois de adicionar uma pessoa à mão. Vigiar 3 dias se a pessoa convidada fica. Entrar por ligação não conta.

Ambas as condições, avisos em português

Exigir a subscrição e um convite. Mostrar avisos aos membros em português e apagá-los após 5 minutos.

O que o JSON pode definir

  • Até cinco canais ou grupos públicos, por @username ou ligação t.me.
  • Quatro regras de acesso: só subscrição, só convites, ambas ou qualquer uma.
  • Número de convites 0, 1, 2 ou 3. Contam só pessoas adicionadas à mão.
  • A vigilância do convite é o tempo que a pessoa convidada deve ficar. O acesso abre na mesma de imediato.
  • Idioma dos avisos do grupo, boas-vindas, antispam, duração dos cartões e texto próprio até 200 caracteres.
  • A IA não pode dar direitos de administrador ao bot nem adicioná-lo a canais por si.

Esquema técnico

Os nomes dos campos JSON ficam em inglês. Se um campo for omitido, um grupo já configurado mantém o valor atual. Abrir ai-settings.v1.json.

Perguntas frequentes

Isto funciona com qualquer bot do Telegram?

Não. A instrução, o esquema JSON e o botão Aplicar pertencem ao UC PR Bot.

Posso enviar ao bot uma descrição em linguagem natural?

Não. O bot lê texto JSON ou um ficheiro .json. Descreva o grupo à IA e envie o JSON para aqui.

E se o JSON não couber numa mensagem do Telegram?

Envie um ficheiro .json. É o caminho mais seguro quando o assistente devolve um objeto completo.

O bot altera alguma coisa antes da confirmação?

Não. O resumo é só um rascunho. Aplicar guarda. Cancelar deixa o grupo igual.

Ainda posso configurar tudo com botões?

Sim. Use o guia habitual se preferir toques em vez de JSON.

Descreva o grupo e confirme no Telegram

Abra o @UCPRbot, copie a instrução, envie o JSON e toque em Aplicar só quando o resumo estiver correto.