Realne sluzby, OpenAI, odesilani e-mailu a helpdesk

Katalog srovnany s tim, co opravdu bezi na services.csbot.cz/apps:
trinact sluzeb dostalo pristupove udaje a levne cteci overeni, opravena
appId, ktera nikam nevedla (ppl, microsoft365, transcription), a GA4,
Search Console, Google Ads i Sklik ted stoji na aplikaci analytics,
kazda s vlastnimi udaji. Nove sluzby SAP Business One, Google Workspace
a Meta Ads. K tomu 23 skriptu, ktere s nimi opravdu neco delaji.

OpenAI jako prvni sluzba, ktera nebezi u nas: Service.baseUrl s absolutni
adresou, prepis pres <SLUZBA>_BASE_URL nebo adresu u konektoru, predpona
hlavicky u pole udaju (uzivatel vlepi holy klic, Bearer dopise runtime).
Dotaz na model, nahrani souboru, otazka nad souborem, prepis zvuku.
Skript umi odeslat soubor pres ctx.http.postForm (multipart, obsah Base64).

Sluzba E-mail pres SMTP. Neni to skript, ale vnitrni krok - SMTP neni HTTP.
Konektor nese schranku firmy, krok ma HTML telo, ve kterem se dosazene
hodnoty escapuji (znacky autora sablony jsou zamer, ostre zavorky od
zakaznika ne). Overeni konektoru se prihlasi na server a nic neodesle.

Helpdesk: Ticket.helpdeskSourceId drzi firmu, ktera pozadavek poslala,
vlastnikem zustava ta, ktera ho resi - jinak by ho resitel nemel ve sve
fronte. Komu pozadavek pripadne, urcuje Tenant.helpdeskProviderId.
Zadavatel vidi jen svoje pozadavky a smi k nim pripsat komentar.

Opravy v portalu:
- hlasky o ulozisti a odchozi IP vidi jen spravce platformy
- typ ticketu se v automatizaci vybira ze seznamu firmy, nebo dosadi z dat
- stav ticketu je otevreny naseptavac, ne ciselnik
- ticket jde zalozit rucne, zakaznik u nej neni povinny
- kanal se prejmenoval a parametry u webhooku jsou oznacene jako nepovinne
- srovnane markdown tabulky v cele dokumentaci

Co z teto davky jeste neni: prepinac firmy je porad jen stav uvnitr stranky
Prehled, takze se prepnuti neprojevi v Lidech ani jinde.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

documentation/04-api.md

@@ -7,17 +7,17 @@ co ze Swaggeru neni videt.
 
 Verejne:
 
-| Metoda | Cesta               | Popis                                   |
-| ------ | ------------------- | --------------------------------------- |
-| GET    | `/health`           | liveness, nezavisi na databazi          |
-| GET    | `/health/ready`     | readiness, 503 pri nedostupne databazi  |
-| GET    | `/docs`             | Swagger UI                              |
-| GET    | `/openapi.json`     | OpenAPI definice                        |
-| POST   | `/api/auth/login`   | prihlaseni, vraci JWT                   |
-| POST   | `/api/contact`      | poptavka z webu                         |
-| POST   | `/webhook/:token`   | prijem dat do automatizace              |
-| POST   | `/webhook/ticket/:token` | prijem udalosti do ticketu         |
-| GET    | `/webhook/ticket/:token` | napoveda k prijmu                  |
+| Metoda | Cesta                    | Popis                                  |
+| ------ | ------------------------ | -------------------------------------- |
+| GET    | `/health`                | liveness, nezavisi na databazi         |
+| GET    | `/health/ready`          | readiness, 503 pri nedostupne databazi |
+| GET    | `/docs`                  | Swagger UI                             |
+| GET    | `/openapi.json`          | OpenAPI definice                       |
+| POST   | `/api/auth/login`        | prihlaseni, vraci JWT                  |
+| POST   | `/api/contact`           | poptavka z webu                        |
+| POST   | `/webhook/:token`        | prijem dat do automatizace             |
+| POST   | `/webhook/ticket/:token` | prijem udalosti do ticketu             |
+| GET    | `/webhook/ticket/:token` | napoveda k prijmu                      |
 
 Vyzaduji `Authorization: Bearer <token>`:
 
@@ -105,14 +105,14 @@ Jednotny pro cele API:
 { "error": "validation_error", "message": "Zadejte platny e-mail." }
 ```
 
-| HTTP | `error`               | Kdy                                     |
-| ---- | --------------------- | --------------------------------------- |
-| 400  | `validation_error`    | vstup neprosel schematem                |
-| 401  | `unauthorized`        | chybi nebo neplatny token               |
-| 401  | `invalid_credentials` | spatny e-mail nebo heslo                |
-| 403  | `forbidden`           | nedostatecna role                       |
-| 404  | `not_found`           | zaznam nebo endpoint neexistuje         |
-| 409  | ruzne                 | operace nedava v danem stavu smysl      |
+| HTTP | `error`               | Kdy                                         |
+| ---- | --------------------- | ------------------------------------------- |
+| 400  | `validation_error`    | vstup neprosel schematem                    |
+| 401  | `unauthorized`        | chybi nebo neplatny token                   |
+| 401  | `invalid_credentials` | spatny e-mail nebo heslo                    |
+| 403  | `forbidden`           | nedostatecna role                           |
+| 404  | `not_found`           | zaznam nebo endpoint neexistuje             |
+| 409  | ruzne                 | operace nedava v danem stavu smysl          |
 | 500  | `internal_error`      | neodchycena chyba, detail jen mimo produkci |
 
 `message` je vzdy cesky a je urcena k zobrazeni uzivateli.
@@ -150,12 +150,12 @@ Verejny endpoint bez prihlaseni. Autorizuje neuhodnutelny token v adrese,
 Token generuje **vyhradne server**. Hodnota `webhookToken` poslana klientem se
 ignoruje, jinak by si sel nastavit predvidatelnou adresu.
 
-| Situace                             | Odpoved |
-| ----------------------------------- | ------- |
-| vse v poradku                       | 202     |
-| neznamy token                       | 404     |
-| automatizace je pozastavena         | 409     |
-| chybi povinny parametr, spatny typ  | 400     |
+| Situace                            | Odpoved |
+| ---------------------------------- | ------- |
+| vse v poradku                      | 202     |
+| neznamy token                      | 404     |
+| automatizace je pozastavena        | 409     |
+| chybi povinny parametr, spatny typ | 400     |
 
 Parametry navic se neodmitaji, jen loguji. Odesilatele bezne posilaji i vlastni
 data a odmitat je by rozbijelo integrace.
@@ -217,13 +217,13 @@ uz adresu zname, tak ji, at ji clovek nemusi psat. Nic o tom, kdo ve firme je.
 
 `POST /api/invites/:kod/accept` s telem `{"name", "email", "password"}`:
 
-| Situace | Co se stane |
-| --- | --- |
-| ucet neexistuje | zalozi se a pripoji k firme |
-| ucet existuje, heslo sedi | jen se pripoji k firme |
-| ucet existuje, heslo nesedi | 401 |
-| pozvanka je na jinou adresu | 403 |
-| pozvanka uz byla pouzita nebo vyprsela | 409 s konkretnim duvodem |
+| Situace                                | Co se stane                 |
+| -------------------------------------- | --------------------------- |
+| ucet neexistuje                        | zalozi se a pripoji k firme |
+| ucet existuje, heslo sedi              | jen se pripoji k firme      |
+| ucet existuje, heslo nesedi            | 401                         |
+| pozvanka je na jinou adresu            | 403                         |
+| pozvanka uz byla pouzita nebo vyprsela | 409 s konkretnim duvodem    |
 
 Overeni hesla u existujiciho uctu neni formalita: bez nej by kdokoliv s odkazem
 pripojil cizi adresu ke sve firme a videl by jeji data.