Klientský portál

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.

Jak funguje magic link

Klientovi přijde e-mail s jednorázovým odkazem obsahujícím krátkodobě platný 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 intake (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)

Samotný magic link je jednorázový — po uplatnění přestane platit. Session cookie, která z něj vznikne, funguje opakovaně po dobu 14 dnů.

Co klient uvidí

Váš branding: logo, doplňkovou barvu, jméno odesílatele (v placených tarifech)
Název projektu a osobní oslovení („Dobrý den, Jane, Radim potřebuje pár věcí, aby mohl začít…“)
Ukazatel postupu („5 z 8 položek hotovo“)
Seznam všech položek s popisky, nápovědou a aktuálním stavem
Tlačítko „Odeslat vše“, které intake 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 a Agency tam není. Vlastní doména portálu (třeba podklady.vasefirma.cz) je k dispozici v tarifu Agency.

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 / file_list / image — plocha pro přetažení souborů, na mobilu výběr z fotoaparátu nebo galerie, během nahrávání ukazatel postupu
color / color_list — vizuální výběr barvy (kapátko a zadání hexu)
select — rozbalovací seznam nebo přepínače podle počtu možností
boolean — přepínač
url — pole pro adresu s kontrolou formátu při opuštění pole
secret — zamaskované pole s ikonou zámku; hodnota se zašifruje ještě v prohlížeči
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
Portál plně funguje i na pomalém připojení (soubory se nahrávají po částech s možností navázat)

Kontrola přímo v portálu

Klient vidí chyby okamžitě, ještě než klikne na Odeslat. Například:

„Logo je široké 200 px, minimum je 512 px. Nahrajte prosím větší verzi.“
„Adresa nevypadá platně — zkontrolujte, jestli nechybí https://.“
„Soubor má 28 MB, maximum je 20 MB.“

Kontrola běží na serveru a do portálu se vrací v reálném čase. Když se problém odhalí dřív, než klient odešle, ubyde kol s opravami.

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 revision_requested. 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 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.

V tarifech Solo a Agency zmizí úplně. V tarifu 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).