Рецепт вебхуків для Zapier і Make

1. Що знадобиться

Акаунт QR Wait, власником якого ви є (менеджери й працівники не бачать інтеграцій), акаунт Zapier або Make і екран Інтеграції сторінки адміністратора, відкритий в іншій вкладці.

2. Zapier

1. У Zapier створіть Zap із тригером Webhooks by Zapier і подією Catch Hook. Скопіюйте адресу вебхука, яку покаже Zapier.
2. У QR Wait на екрані Інтеграції вставте її в поле Адреса отримувача (https), позначте потрібні події й натисніть Додати вебхук. Збережіть секрет підпису: його показують лише раз.
3. Станьте один раз у свою чергу з телефона або додайте когось у панелі працівника, щоб надійшла справжня подія ticket.joined. Надіслати тестову подію надсилає лише ping без полів квитка: він тільки показує, що адреса відповідає.
4. Поверніться в Zapier, протестуйте тригер і виберіть цю подію. Додайте дію, наприклад Google Sheets › Create Spreadsheet Row, і зіставте поля: type, queue.name, ticket.no, ticket.size, ticket.joined_at.
5. Опублікуйте Zap. Відтепер кожна подія додає рядок.

3. Make

1. У Make створіть сценарій, першим модулем якого є Webhooks › Custom webhook. Додайте вебхук і скопіюйте його адресу.
2. Вставте її на екрані Інтеграції в QR Wait, як описано вище, і натисніть Додати вебхук.
3. Make чекає, щоб дізнатися структуру даних: станьте один раз у свою чергу або додайте когось у панелі працівника.
4. Додайте наступний модуль, наприклад Google Sheets › Add a Row або повідомлення у ваш чат, зіставте поля й увімкніть сценарій.

4. Що надходить

Кожна подія — це JSON-тіло на зразок цього. Позначте в QR Wait лише потрібні події або фільтруйте за type у Zapier чи Make.

{
  "id": "d_3f9a1c0b7e2d4a61",
  "type": "ticket.joined",
  "created": "2026-10-10T09:12:30.010Z",
  "account": "antalyabb",
  "queue": { "id": "a1b2c3d4e5", "name": "Konyaaltı Beach", "slug": "konyaalti" },
  "ticket": { "no": 42, "size": 2, "source": "qr", "joined_at": "2026-10-10T09:12:30.004Z" }
}

Імена, відповіді форми запису й коди запису передаються, лише якщо для цієї адреси позначено Передавати імена, відповіді форми запису та коди запису. Без цього події містять лише номери й час.

Невдала доставка повторюється близько 9 годин із тим самим id. Якщо дублікат завадить, перевіряйте його перед додаванням рядка (кроком пошуку).

5. У зворотний бік: додавати людей із Zapier чи Make

Щоб інший інструмент ставив людей у чергу (форма на сайті, сервіс бронювання), створіть у розділі API-ключі ключ із доступом Читання й запис і надішліть запит із Webhooks by Zapier › POST або з модуля Make HTTP › Make a request:

POST https://qrwait.app/api/v1/queues/<queue id>/tickets
Authorization: Bearer qrw_…
Content-Type: application/json

{ "size": 2, "note": "Website" }

У відповідь приходить новий номер, наприклад { "no": 43 }. Ідентифікатори черг повертає GET /api/v1/queues. Виклик наступного, позначку про обслуговування й усі поля описано в довіднику API (англійською).

6. Безпека

• Адреси, яку дає Zapier чи Make, достатньо, щоб надсилати дані у ваш Zap чи сценарій: не діліться нею.
• Zapier і Make самі не перевіряють підпис QR Wait. Якщо стороні, що приймає, треба бути певною, що подія прийшла від QR Wait, перевіряйте заголовок X-QRWait-Signature, як показано в довіднику API, наприклад у кроці з кодом.
• Давайте ключу лише той доступ, який йому потрібен, і відкликайте його на екрані Інтеграції, коли він більше не використовується; там видно, коли кожен ключ використовували востаннє.