Bot de RH do Telegram

Sistema de automação e ecossistema integrado para otimização de fluxos de trabalho internos, triagem de dados e geração automatizada de documentos para a diretoria de Desenvolvimento Humano.

ANO 2026
TIPO Projeto Interno / Empresa Júnior(Ecomp)
TECNOLOGIAS N8N, Docker, APIs

// 01. VISÃO GERAL

O projeto nasceu da necessidade de liderar, planejar e arquitetar uma solução capaz de otimizar os fluxos de trabalho manuais da diretoria de Desenvolvimento Humano (DH) na Ecomp (Empresa Júnior de Computação da UFPR). O objetivo central foi substituir processos operacionais repetitivos por um ecossistema integrado de automação, centralizando a comunicação dos membros via Telegram e conectando ferramentas de gestão de dados e documentos.

// 02. O DESAFIO

Antes da implementação do bot, os processos internos do setor sofriam com atritos de tempo e risco de falha humana no manuseio de informações sensíveis:

  • Ineficiência Operacional: A criação e emissão manual de documentos demandava até mais 15 minutos por solicitação.
  • Fragmentação de Dados: Informações descentralizadas entre mensagens de texto, planilhas e pastas do setor.
  • Risco de Erro Humano: Falhas eventuais de digitação e padronização na geração de relatórios e documentos de membros.

// 03. ARQUITETURA TÉCNICA

A solução foi desenhada como um ecossistema totalmente integrado e orquestrado por fluxos de automação em N8N hospedados em ambiente containerizado (Docker), abaixo, segue uma abstração da arquitetura dos fluxos:

~/architecture/n8n-pipeline-flow Router & Sub-Workflows
[ Telegram Bot Interface ]
(Webhook / API) ↓
1. Workflow de Autenticação & Validação (N8N)
└─ Verifica ID do Usuário & Permissões no Banco de Dados
✕ Não Autorizado ➔ Acesso Negado
✓ Autorizado ➔ Prosseguir
↓
2. Workflow Roteador Principal (Core Router)
└─ Analisa o Comando Disparado (ex: /termo, /dados)
(Redirecionamento por Comando) ↓
Sub-Workflows de Consultas
Consulta Cadastral
➔ Notion API
Sub-Workflows de Geração de Documentos
Gerador de Documentos
➔ Google Docs / Drive API
Sub-Workflows de Avisos
Métricas & Resposta
➔ Telegram API (Payload)
  • Interface de Entrada: Bot no Telegram atuando como ponto único de contato para os assessores de Desenvolvimento Humano.
  • Orquestração de Automações: Fluxos no N8N para consumo de webhooks, tratamento de payload e roteamento condicional de regras de negócio.
  • Modelagem e Persistência de Dados: Integração com a API do Notion para consulta e atualização em tempo real de cadastros e status operacionais.
  • Geração e Armazenamento de Documentos: Integração automatizada com Google Drive/Docs para preenchimento dinâmico de templates e salvamento estruturado.

// 03.1 DEMONSTRAÇÃO DO FLUXO INICIAL

[fig 3.1] Demonstração do fluxo interativo no Telegram integrado ao N8N para gestão automatizada de dados, processos e documentos de Desenvolvimento Humano.

// 03.2 DEMONSTRAÇÃO DO FLUXO DE DESLIGAMENTO EM TEMPO REAL

[fig 3.2] Fluxo automatizado de geração de documentos oficiais (PDF) em tempo real, integrando Telegram API, N8N, Notion e Google Drive.

// 04. RESULTADOS & IMPACTO

A implementação do ecossistema restaurou a eficiência operacional da diretoria, gerando um ganho de 80% na produtividade ao reduzir o tempo de emissão de documentos de 15 minutos para menos de 3 minutos. Além de otimizar a rotina da equipe para que pudessem focar em ações estratégicas de gestão de pessoas, a automação eliminou gargalos operacionais e garantiu uma taxa de erro zero na padronização dos dados e arquivos gerados.

[Repositório Privado]