Integracja Zoom

Automatycznie twórz spotkanie Zoom dla kazdej potwierdzonej rezerwacji i dostarczaj link do dolaczenia klientowi: w emailu potwierdzajacym, w Telegramie i w kazdym innym kanale powiadomien, ktorego uzywasz.

Jak to dziala

Baza Booking Calendar laczy sie z Zoom przez Server-to-Server OAuth app, typ danych uwierzytelniajacych, ktory Zoom udostepnia dla integracji po stronie serwera, nie wymagajacych logowania uzytkownika w czasie dzialania. Gdy tylko wkleisz swoje dane uwierzytelniajace do BBC, wtyczka automatycznie zarzadza tokenami.

Integracja jest wlaczana osobno dla kazdej uslugi. Ty decydujesz, dla ktorych uslug maja byc tworzone spotkania Zoom, konsultacje online, zajecia, sesje coachingowe, pozostawiajac rezerwacje stacjonarne czy pomieszczen bez zmian.

Kiedy rezerwacja dla uslugi z wlaczonym Zoom zostaje potwierdzona:

• BBC wywoluje Zoom API i tworzy spotkanie nazwane wedlug uslugi i rezerwacji
• Unikalny URL do dolaczenia jest zapisywany razem z rekordem rezerwacji
• Przycisk Join Zoom meeting jest dodawany do emaila potwierdzajacego klienta
• URL do dolaczenia jest dodawany do wszystkich powiadomien w komunikatorach (Telegram, Viber itd.)
• Odznaka Zoom pojawia sie na liscie rezerwacji w panelu admina
• Przycisk Join pojawia sie w naglowku panelu bocznego rezerwacji

Jesli rezerwacja zostanie pozniej anulowana, odrzucona lub wygasnie, BBC automatycznie usuwa spotkanie Zoom.

Wymagania wstepne

• Konto Zoom, Pro, Business lub wyzsze (darmowe konta maja ograniczony dostep do API)
• Musisz byc wlascicielem konta lub administratorem, aby tworzyc aplikacje Marketplace i zarzadzac zakresami OAuth
• Baza Booking Calendar w planie Pro lub wyzszym
• Twoja strona WordPress musi byc publicznie dostepna przez HTTPS, aby Zoom mogl dostarczac zdarzenia webhook

Krok 1, Utworz aplikacje Zoom

1. Przejdz na marketplace.zoom.us i zaloguj sie jako wlasciciel konta.
2. Kliknij Develop, Build App i wybierz Server-to-Server OAuth, nastepnie kliknij Create.
3. Wpisz dowolna nazwe aplikacji (np. Baza Booking Calendar) i kliknij Create.
4. Na karcie App Credentials skopiuj swoje Account ID, Client ID i Client Secret. Zostaw te strone otwarta, przyda sie w kroku z webhookiem.

Krok 2, Skonfiguruj Scopes

BBC wymaga dokladnie czterech scope. Dodaj je na karcie Scopes swojej aplikacji Zoom.

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

Aby dodac scope: otworz karte Scopes, kliknij Add Scopes, znajdz kazda nazwe, wybierz ja i kliknij Done. Powtorz dla wszystkich czterech, nastepnie zapisz.

Wazne: te nazwy scope sa dokladne. Nie uzywaj skroconych wariantow jak meeting:write:admin, to inne scope, i spowoduja bledy uwierzytelniania.

Krok 3, Skonfiguruj webhook (zalecane)

Webhook pozwala Zoom powiadamiac BBC, gdy spotkania sie rozpoczynaja lub koncza. Tworzenie i usuwanie spotkan dziala rowniez bez niego, ale webhook wlacza sledzenie zdarzen w czasie rzeczywistym.

URL Twojego punktu koncowego webhook BBC:

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

Ten URL jest rowniez pokazany na stronie ustawien Zoom w BBC dla latwego kopiowania.

Aby dodac subskrypcje zdarzen w Zoom:

1. Przejdz do karty Feature swojej aplikacji i wlacz Event Subscriptions.
2. Kliknij Add New Event Subscription, nadaj nazwe i wklej swoj URL punktu koncowego.
3. Kliknij Add Events, znajdz Meeting, wybierz Start Meeting i End Meeting. Opcjonalnie dodaj tez Participant/Host joined meeting.
4. Zapisz, Zoom pokaze Secret Token. Skopiuj go i wklej w pole Webhook Secret Token w BBC.
5. Kliknij Validate. BBC automatycznie obsluguje weryfikacje. Jesli Twoja strona jest dostepna, walidacja konczy sie w kilka sekund.

Krok 4, Polacz w BBC

1. W panelu administracyjnym WordPress przejdz do Baza Booking, Zoom.
2. Wklej Account ID, Client ID, Client Secret i (jesli skonfigurowano) Webhook Secret Token.
3. Kliknij Test connection. BBC wywoluje Zoom Users API i przy sukcesie pokazuje email konta.
4. Wlacz przelacznik Enable Zoom synchronization i kliknij Save.

Wszystkie dane uwierzytelniajace sa przechowywane w postaci zaszyfrowanej i nigdy nie sa uwzgledniane w eksportach ustawien.

Krok 5, Wlacz dla konkretnej uslugi

Tworzenie spotkan Zoom jest domyslnie wylaczone dla kazdej uslugi, nawet po aktywacji integracji.

1. Przejdz do Baza Booking, Uslugi i otworz usluge, dla ktorej maja byc tworzone spotkania Zoom (np. konsultacja online).
2. W panelu ustawien uslugi wlacz checkbox Create Zoom meeting.
3. Zapisz usluge.

Od tej pory kazda rezerwacja potwierdzona dla tej uslugi bedzie automatycznie tworzyc spotkanie Zoom.

Wskazowka: pozostaw checkbox wylaczony dla uslug stacjonarnych. Utrzymuje to Twoje konto Zoom w porzadku i unika wysylania linkow klientom rezerwujacym spotkania fizyczne.

Nazewnictwo spotkan: BBC nazywa kazde spotkanie wedlug tytulu uslugi i ID zamowienia, na przyklad Photography Session #a3f2c1. Dzieki temu lista spotkan Zoom jest czytelna bez dodatkowej konfiguracji.

Cykl zycia spotkania

Ponowne potwierdzenie: jesli anulowana rezerwacja zostanie przywrocona do statusu Booked, BBC sprawdza istnienie spotkania i tworzy nowe tylko jesli zadnego nie znaleziono, bez duplikatow.

Czas trwania: obliczany na podstawie zarezerwowanych slotow. Rezerwacja 3-godzinna tworzy spotkanie na 180 minut. Minimalny czas trwania to 30 minut.

Strefa czasowa: czas rozpoczecia spotkania uzywa strefy czasowej ustawionej w WordPress, Ustawienia, Ogolne, Strefa czasowa.

Powiadomienia

Link do dolaczenia jest rowniez automatycznie dolaczany do przypomnien, dzieki czemu klienci zawsze maja link, gdy go potrzebuja.

Rozwiazywanie problemow

Test connection nie dziala

• Sprawdz czy dane uwierzytelniajace skopiowano bez dodatkowych spacji na poczatku lub koncu
• Upewnij sie, ze status aplikacji w Zoom Marketplace to Activated
• Sprawdz czy wszystkie cztery wymagane scope sa obecne na karcie Scopes

Spotkania nie sa tworzone po potwierdzeniu

• Potwierdz, ze Enable Zoom synchronization jest wlaczone w ustawieniach BBC, Zoom
• Potwierdz, ze Create Zoom meeting jest wlaczone dla konkretnej uslugi
• Sprawdz czy rezerwacja osiagnela status Booked, spotkania nie sa tworzone dla rezerwacji Pending, gdy wymagane jest reczne potwierdzenie

Blad scope w odpowiedzi Zoom API. Wroc do karty Scopes w Zoom Marketplace, dodaj wszystkie cztery scope wymienione w Kroku 2, zapisz i odczekaj 1-2 minuty, az zmiany zaczna dzialac, przed ponownym testem.

Walidacja webhooka nie powiodla sie

• Twoja strona musi byc publicznie dostepna przez HTTPS, lokalne lub chronione zapora srodowiska nie moga odbierac webhookow Zoom
• Sprawdz czy Webhook Secret Token w BBC dokladnie odpowiada temu pokazanemu w Zoom Marketplace
• Sprawdz czy zadna zapora ogniowa lub regula Cloudflare nie blokuje zadan POST do /wp-json/bbc/v1/api/zoom

Najczesciej zadawane pytania