Integrace MiroTalk P2P (Self-Hosted Video)

MiroTalk P2P je open-source řešení pro videokonference postavené na technologii WebRTC. Umožňuje provozovat neomezené audio/video hovory, sdílení obrazovky, chat a nahrávání přímo na vašem vlastním serveru bez jakýchkoliv licenčních poplatků nebo limitů na délku hovorů.

Note

Propojením LockMyCal s instancí MiroTalk zajistíte, že každá rezervovaná online schůzka automaticky obdrží unikátní, zabezpečenou video místnost na vaší vlastní doméně.


Jak integrace funguje

sequenceDiagram
    participant K as Klient
    participant L as LockMyCal
    participant M as MiroTalk Server

    K->>L: Potvrzení rezervace typu "MiroTalk Video"
    L->>L: Vygenerování kryptograficky bezpečné video místnosti
    L->>K: Odeslání odkazu: https://meet.vasedomena.cz/join/room-xyz
    L->>L: Zápis odkazu do kalendářů a e-mailových pozvánek
    K->>M: Vstup do místnosti v čase schůzky (WebRTC P2P)

1. Nasazení MiroTalk P2P přes Docker

Pokud ještě nemáte MiroTalk nainstalovaný, můžete jej snadno spustit pomocí Dockeru:

version: "3.8"

services:
  mirotalk:
    image: mirotalk/p2p:latest
    container_name: mirotalk-p2p
    restart: unless-stopped
    ports:
      - "3000:3000"
    environment:
      - NODE_ENV=production

Spusťte kontejner:

docker compose up -d

2. Nastavení reverzní proxy a HTTPS

WebRTC striktně vyžaduje zabezpečené spojení HTTPS (pro přístup k mikrofonu a kameře v prohlížeči).

Příklad konfigurace pro Caddy:

meet.vasedomena.cz {
    reverse_proxy localhost:3000
}

3. Propojení v administraci LockMyCal

  1. Přejděte do Integrace → Video a zvolte MiroTalk.
  2. Zadejte Base URL vaší MiroTalk instance (např. https://meet.vasedomena.cz).
  3. Zadejte API Key – klíč API nastavený v konfiguraci vašeho MiroTalk serveru.
  4. Uložte nastavení.

Tip

Běží-li MiroTalk ve vaší interní síti (např. pod názvem Docker služby), musí provozovatel LockMyCal povolit ALLOW_PRIVATE_IPS_FOR_VIDEO=true.

4. Aktivace na typu schůzky

  1. Otevřete Typy schůzek a upravte požadovanou schůzku.
  2. V sekci Místo konání vyberte Video a službu MiroTalk.
  3. Při každé nové rezervaci LockMyCal automaticky vygeneruje unikátní odkaz na místnost, který vloží do e-mailového potvrzení pro vás i klienta.