Receita de webhook para Zapier e Make

1. O que você precisa

Uma conta do QR Wait da qual você é proprietário (gerentes e atendentes não veem as integrações), uma conta no Zapier ou no Make e a tela Integrações da página de administração aberta em outra aba.

2. Zapier

1. No Zapier, crie um Zap com Webhooks by Zapier como gatilho e Catch Hook como evento. Copie a URL do webhook que o Zapier mostra.
2. No QR Wait, em Integrações, cole-a em Endereço do endpoint (https), marque os eventos desejados e clique em Adicionar webhook. Guarde o segredo de assinatura, mostrado uma única vez.
3. Entre uma vez na sua fila pelo celular, ou adicione alguém no painel do atendente, para que chegue um evento ticket.joined de verdade. Enviar evento de teste envia só um ping sem campos de ticket: mostra apenas que o endereço responde.
4. De volta ao Zapier, teste o gatilho e escolha esse evento. Adicione uma ação, por exemplo Google Sheets › Create Spreadsheet Row, e mapeie os campos: type, queue.name, ticket.no, ticket.size, ticket.joined_at.
5. Publique o Zap. A partir daí, cada evento adiciona uma linha.

3. Make

1. No Make, crie um cenário cujo primeiro módulo seja Webhooks › Custom webhook. Adicione um webhook e copie o endereço.
2. Cole-o em Integrações no QR Wait, como acima, e clique em Adicionar webhook.
3. O Make espera para aprender a estrutura dos dados: entre uma vez na fila ou adicione alguém no painel do atendente.
4. Adicione o próximo módulo, por exemplo Google Sheets › Add a Row ou uma mensagem no seu chat, mapeie os campos e ative o cenário.

4. O que chega

Cada evento é um corpo JSON como este. Marque no QR Wait só os eventos de que precisa, ou filtre por type no Zapier ou no 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" }
}

Nomes, respostas do formulário e códigos de reserva só são enviados se você marcar Incluir nomes, respostas do formulário de entrada e códigos de reserva para esse endereço. Sem isso, os eventos levam apenas números e horários.

Uma entrega que falha é repetida por cerca de 9 horas com o mesmo id. Verifique-o antes de adicionar uma linha (com uma etapa de busca) se uma duplicata for um problema.

5. O caminho inverso: adicionar pessoas pelo Zapier ou Make

Para que outra ferramenta coloque pessoas numa fila (um formulário do seu site, uma ferramenta de reservas), crie em Chaves de API uma chave com acesso de Leitura e escrita e envie uma requisição pelo Webhooks by Zapier › POST ou pelo módulo HTTP › Make a request do Make:

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

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

A resposta é o novo número, por exemplo { "no": 43 }. Os ids das filas vêm de GET /api/v1/queues. Chamar o próximo grupo, marcar alguém como atendido e todos os campos estão na referência da API (em inglês).

6. Mantenha seguro

• O endereço que o Zapier ou o Make fornece basta para enviar dados ao seu Zap ou cenário: não o compartilhe.
• O Zapier e o Make não verificam sozinhos a assinatura do QR Wait. Se o lado que recebe precisa ter certeza de que o evento veio do QR Wait, verifique o cabeçalho X-QRWait-Signature como mostra a referência da API, por exemplo numa etapa de código.
• Dê a cada chave só o acesso necessário e revogue-a na tela Integrações quando não for mais usada; a tela mostra quando cada chave foi usada pela última vez.