Klientský portál

Vyzkoušejte si to. Otevřít demo portál — bez účtu, bez registrace. Je to skutečný sběr podkladů na skutečném portálu, takže vidíte přesně to, co uvidí váš klient. Do jednoho dne se sám smaže.

Přehled

Když zavoláte define_intake, BriefGate vygeneruje jedinečnou adresu portálu ve vašich barvách (například https://p.briefgate.dev/8f3k) a pošle ji klientovi e-mailem jako magic link. Klient si nemusí zakládat účet. Klikne na odkaz, přistane rovnou ve svém portálu a začne nahrávat podklady.

V placených tarifech nese portál váš branding, ne ten náš. Z pohledu klienta je to nástroj, který jste pro něj postavili vy.

Jakmile klient začne odevzdávat podklady, projděte si je na stránce detailu sběru podkladů v dashboardu, nebo si vše najednou stáhněte jako ZIP — viz Stažení všeho v ZIPu.

Jak funguje magic link

Klientovi přijde e-mail s magic linkem obsahujícím token
Klient na odkaz klikne; prohlížeč pošle POST /portal/:slug/redeem a vymění token za session cookie
Cookie dává přístup pouze k tomu jednomu sběru podkladů (ne k ostatním) a platí 14 dní
Když klient e-mail ztratí, pošlete ho znovu přes POST /v1/intakes/:id/send (nebo nástrojem send_chase z MCP)

Magic link není jednorázový a není ani jeden na e-mail: sběr podkladů má jeden stálý odkaz po celou dobu své existence a stejný odkaz nese každý e-mail k němu — pozvánka, každá upomínka i ruční chase. Platí po dobu nastavenou v účtu jako platnost odkazu do portálu (portal_link_ttl_days, výchozí 30 dní, nastavitelné 1–365 v dashboardu), počítanou od posledního odeslaného e-mailu k tomu sběru podkladů — takže každé další odeslání platnost prodlouží, místo aby odkaz nahradilo. Samotný token se odvozuje na serveru z ID sběru podkladů a serverového tajemství a ukládá se jen jeho hash — nikdy token samotný, natož v plaintextu.

Praktický důsledek: kdo drží odkaz, má přístup k tomu sběru podkladů tak dlouho, dokud mu chodí e-maily (nebo dokud od posledního neuplyne portal_link_ttl_days). S přeposlanou pozvánkou zacházejte stejně jako s přeposlaným dokumentem. Smazání nebo anonymizace sběru podkladů odkaz vždy zneplatní, bez ohledu na platnost.

Co klient uvidí

Váš branding: logo, doplňkovou barvu, jméno odesílatele (v placených tarifech); stejné logo a volitelný podpis do e-mailů (dobře poslouží vizitka) se objeví v každém e-mailu, který klient od vás dostane
Název projektu a nadpis se jménem vaší firmy („Radim potřebuje vaše podklady“) — jméno klienta se v žádném oslovení nezobrazuje
Ukazatel postupu („5 z 8 hotovo“)
Seznam všech položek s popisky, nápovědou a aktuálním stavem
Tlačítko „Odeslat podklady“ (v anglickém rozhraní „Send assets“), které sběr podkladů označí za dokončený a spustí webhook intake.completed

V tarifu Free je ve spodní části portálu uvedeno „Powered by BriefGate“. V tarifech Solo, Studio a Agency tam není. Vlastní doména portálu (třeba podklady.vasefirma.cz) je k dispozici v tarifech Studio a Agency — návod na nastavení najdete v kapitole Vlastní domény.

Brief pro klienta

Někdy potřebuje informace putovat i opačným směrem — smlouva k podpisu, dokument se zadáním, pár vět s kontextem, než klient začne cokoli vyplňovat. Nastavte client_brief u define_intake (nebo dodatečně přes PATCH /v1/intakes/:id) a soubory přiložte přes POST /v1/intakes/:id/brief/files; obojí je popsané v referenci REST API u POST /v1/intakes a Brief pro klienta.

Je-li vyplněné aspoň jedno z toho, zobrazí se nad požadovanými položkami jako „Informace od <vaše jméno>“ — stejné jméno odesílatele, jakým se podepisuje pozvánkový e-mail. Přílohy procházejí přesně stejným procesem jako klientovo vlastní nahrání: skutečné rozpoznání typu obsahu, konverze HEIC na JPEG a antivirová kontrola dřív, než se soubor vůbec nabídne ke stažení. Soubor, který se ještě kontroluje, nebo který kontrola označila jako podezřelý, se v portálu zobrazí bez funkčního odkazu, dokud neprojde — klient tak nikdy nedostane soubor, který BriefGate neprověřil.

Pozvánkový a upomínkový e-mail přidají jednu větu upozorňující klienta na portál, když je brief vyplněný, ale samotné soubory k e-mailu nikdy nepřipojí — přílohy e-mailu by obešly antivirovou kontrolu a účtování kvóty, na kterých je celý tenhle produkt postavený, takže klient si přílohy musí vždy otevřít v portálu.

Děkovný e-mail

Ve chvíli, kdy je sběr podkladů dokončený — ať už klient klikl na „Odeslat podklady“, nebo jste poslední položku označili jako přijatou mimo BriefGate — dostane klient jeden krátký děkovný e-mail v jazyce sběru s potvrzením, že všechno dorazilo a můžete pokračovat. Ve výchozím stavu je zapnutý, odchází jednou za sběr a nikdy u sběrů založených klíčem v testovacím režimu. Pokud chcete klientovi poděkovat sami, vypněte ho v Nastavení volbou Poslat klientovi děkovný e-mail, jakmile dodá všechno (nebo send_client_thank_you: false přes PATCH /v1/account); webhook intake.completed ani vaše vlastní upozornění to neovlivní.

Práce s položkami

Každý typ položky se vykresluje vlastním rozhraním:

text / longtext — běžné pole nebo víceřádkové pole s živým počítadlem znaků
file / image — plocha pro přetažení souborů, na mobilu výběr z fotoaparátu nebo galerie, během nahrávání ukazatel postupu
file_list — tlačítko „Přidat soubory“ (na mobilu výběr z fotoaparátu nebo galerie), během nahrávání ukazatel postupu; na rozdíl od file/image tu není plocha pro přetažení
color_list — barevný čtvereček a textové pole s hex kódem u každé položky (samostatný typ color neexistuje — jen color_list)
select — rozbalovací seznam
boolean — dvojice tlačítek Ano/Ne
url — pole pro adresu s kontrolou formátu při opuštění pole
secret — zamaskované pole s ikonou zámku; hodnota se posílá přes HTTPS a šifruje se veřejným klíčem (sealed box) až na straně serveru, než se uloží — v prohlížeči se nešifruje a po uložení se už nikdy nevrací zpět
structured — jednoduchý formulář vygenerovaný z JSON Schema; dvojice klíč/hodnota u objektů, opakující se řádky u polí

Všechny položky se průběžně ukládají při každé změně. Když klient prohlížeč v půlce zavře, postup zůstane uložený a po návratu přes stejný odkaz nemusí nic vyplňovat znovu.

Především pro mobil

Portál je navržený pro klienty, kteří podklady posílají z telefonu. Klíčové chování na mobilu:

Pole pro soubory otevřou fotoaparát nebo galerii na iOS i Androidu
Obrázky HEIC z iPhonu se automaticky převádějí na JPEG na straně serveru — klient nemusí nic konvertovat
Postup přežije obnovení stránky i restart prohlížeče
Nahrávání ukazuje živý ukazatel postupu; soubory se nenahrávají po částech a nejde v nahrávání navázat po výpadku — při přerušeném připojení je potřeba nahrání zopakovat (už nahrané soubory zůstanou zachované)

Kontrola přímo v portálu

Klient vidí chyby ve dvou vrstvách, ještě než je cokoli odesláno i po odeslání:

V prohlížeči, ještě než se pošle jakýkoli požadavek — základní kontroly (formát adresy, malý obrázek, velký soubor) proběhnou okamžitě při výběru souboru nebo opuštění pole, např. „Zadejte platnou URL adresu (https://...)“ nebo „Obrázek je příliš malý — potřebujeme min. 512 px na šířku“.
Na serveru, při odeslání / nahrání — BriefGate nezávisle znovu zkontroluje každou hodnotu i soubor, který dostane, a pokud něco pořád neprojde, vrátí podrobnější zprávu, např. „Tento obrázek je široký jen 200 px; potřebujeme alespoň 512 px.“ nebo „Tento soubor má 28 MB; limit je 20 MB.“

Kontrola v prohlížeči je zdvořilost, která odchytí zjevné případy dřív, než klient klikne na Odeslat podklady, a ubere tak kola s opravami; rozhodující je ale kontrola na serveru — tu klient obejít nemůže, ani když tu prohlížečovou nějak obejde.

Jazyky

Rozhraní portálu je k dispozici v těchto jazycích:

Kód	Jazyk
`en`	angličtina
`cs`	čeština
`sk`	slovenština
`pl`	polština
`de`	němčina
`es`	španělština

Když client.language vynecháte, použije se default_language z účtu; pokud není nastavené ani to, portál spadne zpět na angličtinu.

Nastavuje se při volání define_intake přes client.language. Všechny popisky, nápovědy, tlačítka a systémové hlášky se zobrazí ve zvoleném jazyce. Pole label a help, která zadáváte vy, se zobrazují tak, jak jsou — u jiného než anglického jazyka si je přeložte sami.

Další jazyky jsou v plánu. Napište podpoře, o který máte zájem.

Kolečko na opravy

Když agent zavolá request_revision(intake_id, item_key, note), portál u dané položky zobrazí proužek s vaší poznámkou:

„Tohle logo je moc malé. Nahrajte prosím alespoň 512 px na šířku. Ideální by byla verze v SVG, pokud ji máte.“

Stav položky se změní na needs_revision. Klientovi přijde e-mail, vrátí se do portálu a položku nahraje nebo vyplní znovu. Po odeslání se opět spustí item.submitted a stav položky se vrátí na submitted.

V tarifu Free žádosti o opravu k dispozici nejsou (chyba plan_required). Fungují v tarifech Solo, Studio a Agency.

„Powered by BriefGate“

V tarifu Free se ve spodní části portálu objeví drobná poznámka „Powered by BriefGate“ s odkazem na https://briefgate.dev — a znovu na obrazovce „Hotovo!“ po odeslání všech podkladů. Hned vedle obou je i druhý, menší řádek: „Sbíráte podklady od svých klientů? Vyzkoušejte BriefGate →“, mířený na jiné lidi, kteří sbírají podklady od vlastních klientů, ne na vašeho klienta. Stejný řádek je i v patičce e-mailů, které klient dostává (pozvánka, upomínka, žádost o opravu, potvrzení dokončení).

Obě poznámky v tarifech Solo, Studio a Agency zmizí úplně — referral řádek nemá vlastní přepínač, mizí spolu s brandingem, vedle kterého je zobrazený. V tarifech Studio a Agency si navíc můžete nastavit vlastní doménu portálu, takže vaši značku ponese i samotná adresa (třeba podklady.vasefirma.cz místo p.briefgate.dev/8f3k) — viz Vlastní domény.