Zapier·Make 웹훅 연동 레시피

1. 준비물

본인이 소유한 QR Wait 계정(매니저와 직원은 연동을 볼 수 없습니다), Zapier 또는 Make 계정, 그리고 다른 탭에 열어 둔 관리 페이지의 연동 화면.

2. Zapier

1. Zapier에서 트리거는 Webhooks by Zapier, 이벤트는 Catch Hook인 Zap을 만듭니다. Zapier가 보여 주는 웹훅 URL을 복사하세요.
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에서 필요한 이벤트만 선택하거나 Zapier나 Make에서 type으로 걸러 내세요.

{
  "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" }
}

이름, 참여 양식 답변, 예약 코드는 해당 주소에 이름, 참여 양식 답변, 예약 코드 포함을 선택한 경우에만 전송됩니다. 선택하지 않으면 이벤트에는 번호와 시간만 담깁니다.

전송에 실패하면 같은 id로 약 9시간 동안 다시 시도합니다. 중복이 문제가 된다면 행을 추가하기 전에(검색 단계로) 확인하세요.

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 }). 대기열 ID는 GET /api/v1/queues로 얻습니다. 다음 호출, 처리 완료 표시와 모든 필드는 API 레퍼런스(영어)에 있습니다.

6. 안전하게 사용하기

• Zapier나 Make가 준 주소만 있으면 Zap이나 시나리오로 데이터를 보낼 수 있습니다. 공유하지 마세요.
• Zapier와 Make는 QR Wait의 서명을 스스로 확인하지 않습니다. 받는 쪽에서 이벤트가 QR Wait에서 왔는지 확실해야 한다면 API 레퍼런스대로 X-QRWait-Signature 헤더를 검증하세요(예: 코드 단계에서).
• 키에는 필요한 권한만 주고, 더 이상 쓰지 않으면 연동 화면에서 취소하세요. 화면에 각 키를 마지막으로 사용한 시점이 표시됩니다.