Dokumentace Zoom integrace

Tato dokumentace popisuje, jak propojit váš Content Flow účet se Zoomem a jak integrace funguje.

Co je Zoom integrace?

Zoom integrace umožňuje automaticky importovat nahrávky z vašich Zoom meetingů do Content Flow. Po propojení účtu můžete:

Automaticky stahovat nahrávky z vašich Zoom meetingů
Zobrazovat shrnutí meetingů
Vytvářet přepisy z audio/video nahrávek
Používat obsah z meetingů pro generování dalšího obsahu

Integrace využívá standardní OAuth 2.0 autorizaci Zoom API, která zajišťuje bezpečné propojení účtů.

Jak propojit účet se Zoomem

Propojení účtu se Zoomem je jednoduché a zabere jen několik kliknutí:

Postup propojení:

Přihlaste se do svého Content Flow účtu
Přejděte do sekce "Obsah" (v hlavním menu)
Klikněte na tlačítko "Přidat zdroj"
Vyberte "Zoom" ze seznamu dostupných zdrojů
Klikněte na tlačítko "Připojit Zoom účet"
Budete přesměrováni na Zoom autorizační stránku
Přihlaste se do svého Zoom účtu a potvrďte autorizaci
Po úspěšné autorizaci budete automaticky přesměrováni zpět do Content Flow

Co se stane při propojení?

Po úspěšném propojení:

Váš Zoom účet bude bezpečně propojen s Content Flow účtem
Automaticky se začnou stahovat nahrávky z vašich meetingů
V sekci "Obsah" se zobrazí nová záložka "Zoom" s vašimi meetingy
Budete moci pracovat s nahrávkami a vytvářet z nich přepisy

Bezpečnost

Integrace využívá standardní OAuth 2.0 protokol, který:

Nikdy neukládá vaše Zoom heslo
Používá pouze autorizační tokeny s omezeným přístupem
Respektuje oprávnění, která jste při autorizaci udělili
Můžete kdykoli odpojit účet a zrušit přístup

Jak odpojit účet od Zoomu

Pokud chcete odpojit svůj Zoom účet od Content Flow, postupujte následovně:

Postup odpojení:

Přihlaste se do svého Content Flow účtu
Přejděte do sekce "Obsah"
Klikněte na tlačítko "Přidat zdroj"
Uvidíte Zoom kartu s tlačítkem "Odpojit"
Klikněte na tlačítko "Odpojit" a potvrďte odpojení
Po odpojení budou smazány všechny uložené Zoom nahrávky z vašeho účtu

⚠️ Důležité upozornění

Při odpojení Zoom účtu budou:

Smazány všechny uložené Zoom nahrávky z vašeho Content Flow účtu
Smazány všechny přepisy vytvořené z Zoom nahrávek
Zrušena autorizace přístupu k vašemu Zoom účtu

Pokud máte důležité přepisy nebo obsah vytvořený z Zoom nahrávek, doporučujeme je před odpojením exportovat nebo uložit jiným způsobem.

Funkce integrace

Automatické stahování nahrávek

Po propojení účtu se automaticky začnou stahovat nahrávky z vašich Zoom meetingů. Systém synchronizuje meetingy z posledních 12 měsíců a průběžně aktualizuje nové nahrávky.

Zobrazení meetingů

Všechny vaše Zoom meetingy jsou dostupné v sekci "Obsah" pod záložkou "Zoom". U každého meetingu můžete vidět:

Název meetingu
Datum a čas konání
Délku trvání
Dostupné soubory (audio, video, přepisy)
Automatické shrnutí (pokud je dostupné)

Vytváření přepisů

Z každé Zoom nahrávky můžete vytvořit přepis, který pak můžete použít pro:

Generování dalšího obsahu pomocí AI
Vytváření článků, příspěvků na sociální sítě nebo newsletterů
Úpravu a vylepšení textu
Export do různých formátů

Technické detaily pro Zoom tým

Níže jsou uvedeny technické detaily integrace pro kontrolu ze strany Zoom týmu.

OAuth 2.0 Flow

Integrace využívá standardní OAuth 2.0 Authorization Code flow:

Uživatel klikne na "Připojit Zoom účet" v Content Flow aplikaci
Aplikace přesměruje uživatele na https://zoom.us/oauth/authorize
Uživatel se přihlásí do Zoomu a autorizuje přístup
Zoom přesměruje uživatele zpět na callback URL s autorizačním kódem
Aplikace vymění autorizační kód za access token a refresh token
Tokeny jsou bezpečně uloženy v databázi a používají se pro API volání

API Endpointy

Aplikace komunikuje s následujícími Zoom API endpointy:

GET /v2/users/me/recordings - Seznam nahrávek
GET /v2/meetings/{uuid}/recordings - Detail nahrávky
GET /v2/meetings/{uuid}/recordings/summary - Shrnutí meetingu
POST /oauth/token - Obnovení access tokenu

Oprávnění (Scopes)

Aplikace vyžaduje následující oprávnění v Zoom Marketplace:

recording:read - Čtení nahrávek
user:read - Čtení informací o uživateli

Aplikace nevyžaduje oprávnění k zápisu nebo úpravě meetingů.

Bezpečnost

Všechna komunikace probíhá přes zabezpečené HTTPS spojení. Tokeny jsou:

Ukládány v šifrované databázi
Automaticky obnovovány před vypršením platnosti
Používány pouze pro nezbytné API volání
Smazány při odpojení účtu

Omezení a limity

Aplikace respektuje všechny Zoom API limity:

Rate limiting - aplikace neprovádí více než 10 požadavků za sekundu
Paginace - všechny seznamy jsou načítány po stránkách
Error handling - aplikace správně zpracovává všechny chybové stavy

Callback URL

Callback URL pro OAuth autorizaci je konfigurována v Zoom Marketplace aplikaci:

https://contentflow.cz/api/zoom/callback

Tato URL musí být zaregistrována v Zoom Marketplace aplikaci jako povolená redirect URI.

Řešení problémů

Problém: Nemohu propojit účet

Pokud se vám nedaří propojit účet:

Zkontrolujte, že máte aktivní Zoom účet
Ujistěte se, že máte oprávnění k nahrávání meetingů
Zkuste použít jiný prohlížeč nebo vymazat cookies
Kontaktujte podporu na info@contentflow.cz

Problém: Nezobrazují se meetingy

Pokud se vám nezobrazují meetingy po propojení:

Počkejte několik minut - synchronizace může trvat
Zkontrolujte, že máte v Zoomu nahrávky z posledních 12 měsíců
Zkuste odpojit a znovu propojit účet
Kontaktujte podporu, pokud problém přetrvává

Problém: Token vypršel

Aplikace automaticky obnovuje access tokeny před vypršením platnosti. Pokud dojde k problému:

Odpojte a znovu propojte Zoom účet
Tím se získají nové tokeny a problém by měl být vyřešen

Kontakt

Máte dotazy ohledně Zoom integrace nebo potřebujete pomoc?

Mind Oasis s.r.o.

E-mail: info@contentflow.cz

Web: https://contentflow.cz