Bot parsera RAI

RAI parser — to MVP systemu operacyjnego dla generacji leadów w Telegramie i sprzedaży AI w ekosystemie Gerchik/GTE. Projekt zamyka drogę od wyszukiwania potencjalnych klientów w grupach Telegram do pierwszego kontaktu, kontynuacji dialogu przez asystenta AI, podgrzewania leada i przekazywania do Zoho CRM.

System składa się z dashboardu operatora, pracownika konta użytkownika Telegram do wyszukiwania/autodoinowania/pierwszego DM, bota biznesowego Telegram do przychodzących dialogów, agenta AI na OpenAI, bazy wiedzy i przekazywania CRM. Osobno zaplanowano sekcję Threads, ale w obecnym kodzie to celowe zablokowanie MVP, a nie działający collector.

Co potrafi produkt

Tworzyć tematy wyszukiwania: słowa kluczowe, język, geo, kanały Telegram/Threads.
Wyszukiwać grupy Telegram przez rzeczywiste konto użytkownika Telegram, a nie Bot API.
Autodoinować znalezione grupy z dziennym limitem.
Skanować wiadomości w grupach i wybierać leady według intencji kupna: słowa kluczowe plus wyraźna prośba o pomoc/edukację/konsultację.
Odsiewać promocje, reklamy i nieistotne wiadomości.
Umieszczać pierwszy DM w kolejce z konta użytkownika Telegram.
Prowadzić dialogi biznesowe Telegram przez webhook.
Generować odpowiedzi przez OpenAI Responses API z odpowiedziami zapasowymi w przypadku błędów/timoutów.
Przetwarzać tekst, wiadomości głosowe, obrazy z podpisem/odpowiedzią zapasową.
Transkrybować głos przez Whisper.
Generować odpowiedzi głosowe przez OpenAI TTS.
Przechowywać prompt, bazę wiedzy do 100 MB, linki do Google Docs/Sheets/Slides i bank mediów.
Wysyłać materiały z banku mediów przez znacznik serwisowy MEDIA:.
Określać ciepłych leadów według sygnałów zainteresowania, telefonu, emaila lub zgody na kontynuację w Telegramie.
Wysyłać ciepłych leadów/leady do Zoho CRM.
Pokazywać operatorowi dashboard: tematy, słowa kluczowe, leady, dialogi, ustawienia, logi, wydarzenia Zoho, statusy systemowe.
Pełny stos

Backend:

Python >=3.11
FastAPI
Uvicorn
Starlette SessionMiddleware
Szablony Jinja2
SQLite przez standardowy sqlite3
httpx dla zewnętrznych API HTTP
OpenAI Python SDK
Telethon dla automatyzacji konta użytkownika Telegram
pytest dla testów
Frontend:

HTML renderowane po stronie serwera przez Jinja2
CSS bez frameworka frontendowego
Brak React, Next.js, Vite, npm/pnpm/yarn w obecnym checkout
Baza danych/przechowywanie:

Plik SQLite: data/gerchik_rai.db domyślnie
Tabele: tematy wyszukiwania, słowa kluczowe, odkryte grupy, leady, rozmowy, wiadomości, wydarzenia outreach, prace Telegram, wątki/aktualizacje/odpowiedzi biznesowe, wydarzenia synchronizacji Zoho, logi, ustawienia aplikacji, elementy wiedzy, elementy mediów
Przechowywanie plików obok DB:
knowledge/ dla bazy wiedzy
media/ dla wysyłanych materiałów
telegram_sessions/ dla sesji Telethon
Integracje:

Telegram Bot API:
Webhook bota biznesowego
Webhook bota Finder
sendMessage, sendVoice, sendDocument, getFile, setWebhook
Konto użytkownika Telegram przez Telethon:
wyszukiwanie publicznych grup
dołączanie do kanałów/megagrup
skanowanie wiadomości grupowych
wysyłanie wiadomości bezpośrednich
wyciszanie/archiwizowanie dołączonych grup
OpenAI:
Responses API dla odpowiedzi AI
Whisper whisper-1 do transkrypcji głosu
TTS gpt-4o-mini-tts dla odpowiedzi głosowych
model domyślny: gpt-5-mini
Zoho CRM:
OAuth refresh token flow
tworzenie leadów przez Zoho CRM API
Google Docs/Sheets/Slides:
im eksport przez export URLs w txt/csv