Zoom інтеграція

Автоматично створюйте Zoom-зустріч для кожного підтвердженого бронювання і доставляйте посилання на приєднання клієнту: в листі-підтвердженні, в Telegram і в будь-якому іншому каналі сповіщень, яким ви користуєтесь.

Як це працює

Baza Booking Calendar підключається до Zoom через Server-to-Server OAuth app, тип облікових даних, який Zoom надає для серверних інтеграцій, що не потребують входу користувача в реальному часі. Щойно ви вставите свої облікові дані в BBC, плагін автоматично керує токенами.

Інтеграція вмикається окремо для кожної послуги. Ви вирішуєте, для яких саме послуг створювати Zoom-зустрічі: онлайн-консультації, заняття, коучинг-сесії, лишаючи офлайн-бронювання чи бронювання приміщень без змін.

Коли бронювання для послуги з увімкненим Zoom підтверджується:

• BBC викликає Zoom API і створює зустріч, названу за назвою послуги і бронювання
• Унікальне посилання для приєднання зберігається разом із записом бронювання
• Кнопка Join Zoom meeting додається до листа-підтвердження клієнта
• Посилання для приєднання додається до всіх сповіщень у месенджерах (Telegram, Viber тощо)
• Значок Zoom з’являється в списку бронювань в адмінці
• Кнопка Join з’являється в заголовку бічної панелі бронювання

Якщо бронювання пізніше скасовано, відхилено чи протерміновано, BBC автоматично видаляє Zoom-зустріч.

Передумови

• Акаунт Zoom, Pro, Business чи вище (безкоштовні акаунти мають обмежений доступ до API)
• Ви маєте бути власником акаунту чи адміністратором, щоб створювати додатки Marketplace і керувати OAuth scope
• Baza Booking Calendar на тарифі Pro чи вище
• Ваш сайт WordPress має бути публічно доступним через HTTPS, щоб Zoom міг доставляти вебхук-події

Крок 1. Створіть Zoom-додаток

1. Перейдіть на marketplace.zoom.us і увійдіть як власник акаунту.
2. Натисніть Develop, Build App і оберіть Server-to-Server OAuth, потім натисніть Create.
3. Введіть будь-яку назву додатку (наприклад Baza Booking Calendar) і натисніть Create.
4. На вкладці App Credentials скопіюйте свої Account ID, Client ID і Client Secret. Лишіть цю сторінку відкритою, вона знадобиться для кроку з вебхуком.

Крок 2. Налаштуйте Scopes

BBC потребує рівно чотири scope. Додайте їх на вкладці Scopes вашого Zoom-додатку.

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

Щоб додати scope: відкрийте вкладку Scopes, натисніть Add Scopes, знайдіть кожну назву, оберіть її і натисніть Done. Повторіть для всіх чотирьох, потім збережіть.

Важливо: ці назви scope точні. Не використовуйте скорочені варіанти типу meeting:write:admin, це інші scope, і вони спричинять помилки автентифікації.

Крок 3. Налаштуйте вебхук (рекомендовано)

Вебхук дозволяє Zoom сповіщати BBC про початок чи завершення зустрічей. Створення і видалення зустрічей працює й без нього, але вебхук вмикає відстеження подій у реальному часі.

URL вашої вебхук-точки BBC:

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

Цей URL також показаний на сторінці налаштувань Zoom в BBC для зручного копіювання.

Щоб додати підписку на події в Zoom:

1. Перейдіть на вкладку Feature вашого додатку і увімкніть Event Subscriptions.
2. Натисніть Add New Event Subscription, дайте назву і вставте свій URL точки.
3. Натисніть Add Events, знайдіть Meeting, оберіть Start Meeting і End Meeting. За бажанням додайте також Participant/Host joined meeting.
4. Збережіть, Zoom покаже Secret Token. Скопіюйте його і вставте в поле Webhook Secret Token у BBC.
5. Натисніть Validate. BBC автоматично обробляє перевірку. Якщо ваш сайт доступний, підтвердження завершується за секунди.

Крок 4. Підключіть у BBC

1. У адмінці WordPress перейдіть у Baza Booking, Zoom.
2. Вставте Account ID, Client ID, Client Secret і (якщо налаштовано) Webhook Secret Token.
3. Натисніть Test connection. BBC викликає Zoom Users API і при успіху показує email акаунту.
4. Увімкніть перемикач Enable Zoom synchronization і натисніть Save.

Усі облікові дані зберігаються зашифрованими і ніколи не потрапляють в експорт налаштувань.

Крок 5. Увімкніть для конкретної послуги

Створення Zoom-зустрічей вимкнено за замовчуванням для кожної послуги, навіть після активації інтеграції.

1. Перейдіть у Baza Booking, Послуги і відкрийте послугу, для якої потрібні Zoom-зустрічі (наприклад онлайн-консультація).
2. У панелі налаштувань послуги увімкніть чекбокс Create Zoom meeting.
3. Збережіть послугу.

Відтепер кожне бронювання, підтверджене для цієї послуги, автоматично створюватиме Zoom-зустріч.

Порада: лишайте чекбокс вимкненим для офлайн-послуг. Це тримає ваш акаунт Zoom чистим і уникає надсилання посилань клієнтам, які бронюють фізичні зустрічі.

Назви зустрічей: BBC називає кожну зустріч за назвою послуги і ID замовлення, наприклад Photography Session #a3f2c1. Це робить ваш список зустрічей у Zoom зрозумілим без додаткового налаштування.

Життєвий цикл зустрічі

Повторне підтвердження: якщо скасоване бронювання повертають назад у статус Booked, BBC перевіряє наявність існуючої зустрічі і створює нову тільки якщо жодної не знайдено, без дублікатів.

Тривалість: розраховується з заброньованих слотів. 3-годинне бронювання створює зустріч на 180 хвилин. Мінімальна тривалість 30 хвилин.

Часовий пояс: час початку зустрічі використовує часовий пояс, вказаний у WordPress, Налаштування, Загальні, Часовий пояс.

Сповіщення

Посилання для приєднання також автоматично включається в нагадування, тож клієнти завжди мають посилання, коли воно потрібне.

Усунення несправностей

Test connection не проходить

• Перевірте, що облікові дані скопійовані без зайвих пробілів на початку чи в кінці
• Переконайтесь, що статус додатку в Zoom Marketplace Activated
• Перевірте, що всі чотири потрібні scope присутні на вкладці Scopes

Зустрічі не створюються після підтвердження

• Підтвердіть, що Enable Zoom synchronization увімкнено в налаштуваннях BBC, Zoom
• Підтвердіть, що Create Zoom meeting увімкнено для конкретної послуги
• Перевірте, що бронювання досягло статусу Booked, зустрічі не створюються для бронювань Pending, коли потрібне ручне підтвердження

Помилка scope у відповіді Zoom API. Поверніться на вкладку Scopes у Zoom Marketplace, додайте всі чотири scope з Кроку 2, збережіть і зачекайте 1-2 хвилини, поки зміни набудуть чинності, перед повторною перевіркою.

Валідація вебхука не проходить

• Ваш сайт має бути публічно доступним через HTTPS, локальні чи захищені файрволом середовища не можуть отримувати вебхуки Zoom
• Перевірте, що Webhook Secret Token у BBC точно збігається з тим, що показаний у Zoom Marketplace
• Перевірте, що жоден файрвол чи правило Cloudflare не блокує POST-запити на /wp-json/bbc/v1/api/zoom

Типові питання