Integracia Zoom

Automaticky vytvorte Zoom stretnutie pre kazdu potvrdenu rezervaciu a doruccte odkaz na pripojenie klientovi: v potvrdzovacom emaili, v Telegrame a v akomkolvek inom notifikacnom kanali, ktory pouzivate.

Ako to funguje

Baza Booking Calendar sa pripaja k Zoom cez Server-to-Server OAuth app, typ prihlasovacich udajov, ktory Zoom poskytuje pre serverove integracie, ktore nevyzaduju prihlasenie pouzivatela za behu. Akonahle vlozite svoje udaje do BBC, plugin automaticky sprvauje tokeny.

Integracia sa zapina samostatne pre kazdu sluzbu. Vy rozhodujete, pre ktore sluzby sa maju vytvarat Zoom stretnutia, online konzultacie, kurzy, koucingove sedenia, pricom osobne rezervacie alebo rezervacie priestorov zostavaju nezmenene.

Ked je rezervacia pre sluzbu so zapnutym Zoom potvrdena:

• BBC vola Zoom API a vytvori stretnutie pomenovane podla sluzby a rezervacie
• Jedinecna URL na pripojenie sa uklada spolu so zaznamom rezervacie
• Tlacidlo Join Zoom meeting sa prida do potvrdzovacieho emailu klienta
• URL na pripojenie sa prida ku vsetkym notifikaciam v messengeroch (Telegram, Viber a pod.)
• Odznak Zoom sa objavi v zozname rezervacii v admin paneli
• Tlacidlo Join sa objavi v hlavicke bocneho panela rezervacie

Ak je rezervacia neskor zrusena, odmietnuta alebo vyprsi, BBC automaticky vymaze Zoom stretnutie.

Predpoklady

• Ucet Zoom, Pro, Business alebo vyssi (bezplatne ucty maju obmedzeny pristup k API)
• Musite byt vlastnikom uctu alebo administratorom, aby ste mohli vytvarat aplikacie Marketplace a spravovat OAuth scopes
• Baza Booking Calendar v pláne Pro alebo vyssom
• Vasa WordPress stranka musi byt verejne dostupna cez HTTPS, aby Zoom mohol doruccovat webhook udalosti

Krok 1, Vytvorte Zoom aplikaciu

1. Prejdite na marketplace.zoom.us a prihlaste sa ako vlastnik uctu.
2. Kliknite na Develop, Build App a vyberte Server-to-Server OAuth, potom kliknite na Create.
3. Zadajte akykolvek nazov aplikacie (napriklad Baza Booking Calendar) a kliknite na Create.
4. Na karte App Credentials skopirujte svoje Account ID, Client ID a Client Secret. Nechajte tuto stranku otvorenu, budete ju potrebovat pre krok s webhookom.

Krok 2, Nastavte Scopes

BBC vyzaduje presne styri scopes. Pridajte ich na karte Scopes vasej Zoom aplikacie.

meeting:write:meeting:admin
meeting:write:meeting:master
meeting:read:meeting:admin
user:read:user:admin

Ako pridat scope: otvorte kartu Scopes, kliknite na Add Scopes, najdite kazdy nazov, vyberte ho a kliknite na Done. Zopakujte pre vsetky styri, potom ulozte.

Dolezite: tieto nazvy scope su presne. Nepouzivajte skratene varianty ako meeting:write:admin, su to ine scope a sposobia chyby autentifikacie.

Krok 3, Nastavte webhook (odporuca sa)

Webhook umoznuje Zoom informovat BBC, ked sa stretnutia zacinaju alebo koncia. Vytvaranie a mazanie stretnuti funguje aj bez neho, ale webhook zapina sledovanie udalosti v realnom case.

URL vasho webhook koncoveho bodu BBC:

https://yoursite.com/wp-json/bbc/v1/api/zoom

Tato URL je tiez zobrazena na stranke nastaveni Zoom v BBC pre jednoduche kopirovanie.

Ako pridat odber udalosti v Zoom:

1. Prejdite na kartu Feature vasej aplikacie a zapnite Event Subscriptions.
2. Kliknite na Add New Event Subscription, dajte mu nazov a vlozte svoju URL koncoveho bodu.
3. Kliknite na Add Events, najdite Meeting, vyberte Start Meeting a End Meeting. Volitelne pridajte aj Participant/Host joined meeting.
4. Ulozte, Zoom zobrazi Secret Token. Skopirujte ho a vlozte do pola Webhook Secret Token v BBC.
5. Kliknite na Validate. BBC automaticky spracuje overenie. Ak je vasa stranka dostupna, validacia sa dokonci za sekundy.

Krok 4, Pripojte v BBC

1. Vo WordPress admine prejdite do Baza Booking, Zoom.
2. Vlozte Account ID, Client ID, Client Secret a (ak je nakonfigurovany) Webhook Secret Token.
3. Kliknite na Test connection. BBC vola Zoom Users API a pri uspechu zobrazi email uctu.
4. Zapnite prepinac Enable Zoom synchronization a kliknite na Save.

Vsetky prihlasovacie udaje su ulozene sifrovane a nikdy nie su sucastou exportu nastaveni.

Krok 5, Zapnite pre konkretnu sluzbu

Vytvaranie Zoom stretnuti je predvolene vypnute pre kazdu sluzbu, aj po aktivacii integracie.

1. Prejdite do Baza Booking, Sluzby a otvorte sluzbu, pre ktoru maju byt Zoom stretnutia (napriklad online konzultacia).
2. V paneli nastaveni sluzby zapnite zaskrtavacie policko Create Zoom meeting.
3. Ulozte sluzbu.

Odteraz kazda rezervacia potvrdena pre tuto sluzbu automaticky vytvori Zoom stretnutie.

Tip: nechajte zaskrtavacie policko vypnute pre osobne sluzby. Udrzuje to vas ucet Zoom cisty a zabranuje posielaniu odkazov klientom, ktori rezervuju fyzicke stretnutia.

Pomenovanie stretnuti: BBC pomenuje kazde stretnutie podla nazvu sluzby a ID objednavky, napriklad Photography Session #a3f2c1. Vdaka tomu je vas zoznam stretnuti v Zoom citatelny bez dalsej konfiguracie.

Zivotny cyklus stretnutia

Opatovne potvrdenie: ak sa zrusena rezervacia vrati do stavu Booked, BBC skontroluje existujuce stretnutie a vytvori nove len ak ziadne nenajde, bez duplicit.

Trvanie: vypocitava sa z rezervovanych slotov. 3-hodinova rezervacia vytvori stretnutie na 180 minut. Minimalne trvanie je 30 minut.

Casove pasmo: zaciatocny cas stretnutia pouziva casove pasmo nastavene vo WordPress, Nastavenia, Vseobecne, Casove pasmo.

Notifikacie

Odkaz na pripojenie je tiez automaticky zahrnuty do pripomienok, takze klienti maju vzdy odkaz, ked ho potrebuju.

Riesenie problemov

Test connection zlyhava

• Skontrolujte, ci boli prihlasovacie udaje skopirovane bez medzier na zaciatku alebo konci
• Uistite sa, ze stav aplikacie v Zoom Marketplace je Activated
• Skontrolujte, ci su vsetky styri potrebne scope pritomne na karte Scopes

Stretnutia sa po potvrdeni nevytvaraju

• Potvrdte, ze Enable Zoom synchronization je zapnute v nastaveniach BBC, Zoom
• Potvrdte, ze Create Zoom meeting je zapnute pre konkretnu sluzbu
• Skontrolujte, ci rezervacia dosiahla stav Booked, stretnutia sa nevytvaraju pre rezervacie v stave Pending, ked je potrebne rucne potvrdenie

Chyba scope v odpovedi Zoom API. Vratte sa na kartu Scopes v Zoom Marketplace, pridajte vsetky styri scope uvedene v Kroku 2, ulozte a pockajte 1-2 minuty, kym sa zmeny prejavia, pred opatovnym testovanim.

Validacia webhooku zlyhava

• Vasa stranka musi byt verejne dostupna cez HTTPS, lokalne alebo firewallom chranene prostredia nemozu prijimat Zoom webhooky
• Skontrolujte, ci Webhook Secret Token v BBC presne zodpoveda tomu zobrazenemu v Zoom Marketplace
• Skontrolujte, ci ziadny firewall alebo pravidlo Cloudflare neblokuje POST poziadavky na /wp-json/bbc/v1/api/zoom

Casto kladene otazky