DokladBot

WhatsApp ucetni asistent pro ceske OSVC. AI kategorizace uctenek, DPH vypocty, fakturace.

WhatsApp Bot REST API Web Dashboard Cron Jobs

Obsah

Funkce
Architektura
API Endpointy
Dashboard API
WhatsApp Prikazy
Kategorie
Persony
Cron Jobs

Funkce

📸

OCR Uctenek

Google Vision API pro cteni uctenek a faktur z obrazku

🤖

AI Kategorizace

Claude AI s in-context learning pro automaticke zarazeni vydaju

💰

DPH Planner

Vypocty DPH, deadliny, sledovani limitu pro registraci

📄

Fakturace

Generovani faktur v PDF primo z WhatsApp

🏦

Wise Import

Automaticky import transakci z TransferWise

📊

Dashboard

Webovy prehled uctenek, faktur a statistik

Architektura

Komponenta	Technologie	URL
Backend API	Flask / Python	`web-production-3deef.up.railway.app`
Frontend	Next.js 15	`uctobot-web.vercel.app`
Databaze	Supabase (PostgreSQL)	-
AI	Claude API (Anthropic)	-
OCR	Google Vision API	-
Platby	Stripe	-

API Endpointy

Health Check

GET /health

Zakladni health check vsech sluzeb.

{
  "status": "ok",
  "services": {
    "meta_webhook": true,
    "dashboard": true,
    "dokladbot": true,
    "finance": true,
    "previo": true,
    "reminders": true,
    "monitoring": true,
    "registration": true
  }
}

GET /monitoring/health

Rozsireny health check s kontrolou externich sluzeb (Supabase, Claude, Google Vision).

GET /monitoring/stats?key={secret}

Statistiky systemu - pocet transakci, uzivatelu, wflow sync.

GET /monitoring/dashboard?key={secret}

Vizualni admin dashboard s grafy a prehledem.

WhatsApp Webhook

GET /meta/webhook

Verifikace Meta webhook (challenge response).

POST /meta/webhook

Prijem zprav z WhatsApp. Zpracovava text, obrazky, dokumenty.

Dashboard API

GET /app/{token}

Hlavni dashboard pro uzivatele. Token je aktivacni kod z registrace.

GET /app/api/data/{user_id}

Data pro dashboard - uctenky, faktury, kredity, historie.

{
  "balance": 50,
  "receipts": [...],
  "pending_invoices": [...],
  "history": [...],
  "prices": {...},
  "packages": {...}
}

GET /app/api/detail/{transaction_id}

Detail transakce vcetne polozek a prilohy (obrazek uctenky).

POST /app/api/category/{transaction_id}

Zmena kategorie transakce.

// Request body:
{
  "category": "potraviny",
  "user_id": 123
}

WhatsApp Prikazy

Prikaz	Popis
`pomoc` / `help`	Zobrazit napovedu
`uctenky`	Prehled poslednich uctenek
`faktury`	Faktury k zaplaceni
`statistiky`	Mesicni prehled vydaju
`export` / `csv`	Export dat do CSV
`oprav`	Editace kategorii
`oprav {ID} {kategorie}`	Zmena kategorie konkretni uctenky
`dph`	DPH prehled a deadline
`dph limit`	Kontrola limitu pro registraci
`faktura`	Vytvorit novou fakturu
`moje faktury`	Seznam vydanych faktur
`wise`	Zustatek na Wise uctu
`wise sync`	Synchronizovat transakce z Wise
`persona`	Vybrat komunikacni styl
`ahoj` / `cau`	Pozdrav

Kategorie

Platne kategorie pro ucetnictvi:

potraviny, phm, material, sluzby, opravy, cestovne,
reprezentace, energie, kancelar, software, ucetnictvi,
pojisteni, ostatni, restaurace, elektronika, drogerie,
doprava, internet

Persony

DokladBot podporuje 7 ruznych komunikacnich stylu:

Persona	Styl	Popis
Maruska (default)	Kamaradka	Vrela, pratelska
Natalka	Prima	Energicka, bez kecu
Eva	Profesionalka	Vecna, efektivni
Denisa	Optimistka	Pozitivni, povzbudiva
Petra	Pecliva	Detailni, presna
Marek	Ochrance	Klidny, strucny
Viktor	Radce	Trpelivy, vysvetluje

Cron Jobs

GET /dokladbot/cron/wflow-sync?key={secret}&limit=10

Synchronizace novych dokumentu z Wflow. Spousti se kazdych 30 minut.

GET /cron/vat-reminder?secret={secret}

Odeslani DPH pripominek uzivatelum. Spousti se denne v 9:00.

GET /cron/invoice-reminder?secret={secret}

Pripominky splatnosti faktur.