Рецепт вебхуков для 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, например в шаге с кодом.
• Давайте ключу только тот доступ, который ему нужен, и отзывайте его на экране Интеграции, когда он больше не используется; там видно, когда каждый ключ использовался в последний раз.