Integrações
Conecte o QR Studio ao Zapier, ao Make e a milhares de apps
Cada leitura e cada resposta a um formulário podem iniciar uma automação: uma linha no Google Sheets, um contato no seu CRM, uma mensagem para a sua equipe. Sem código.
O que você pode automatizar
Cada leitura em uma planilha
Uma nova linha no Google Sheets ou no Excel para cada leitura, com o código, o horário, o país, a cidade e o dispositivo.
Respostas de formulários no seu CRM
Inscrições e avaliações enviadas pelas suas páginas hospedadas viram contatos no HubSpot, no Mailchimp ou no Brevo.
Alertas para a sua equipe
Uma mensagem no Slack, no Teams ou no Telegram quando um código é lido ou alguém se inscreve no seu evento.
Códigos criados automaticamente
Uma nova linha em uma planilha ou um novo produto na sua loja cria o QR code correspondente, pronto para imprimir.
Você precisa de um plano do QR Studio (API e webhooks estão incluídos em todos os planos) e de uma conta no Zapier ou no Make. No Zapier, o app “Webhooks by Zapier” exige um plano pago do Zapier; no Make, os webhooks também funcionam no plano gratuito.
Zapier, passo a passo
No Zapier, crie um Zap. Como trigger, escolha “Webhooks by Zapier”, evento “Catch Hook”, e copie a URL do webhook que o Zapier mostrar.
No QR Studio, abra API e webhooks, cole a URL em Webhooks e clique em “Adicionar webhook”.
Escaneie um dos seus códigos com o celular (ou envie uma resposta de uma das suas páginas hospedadas) e depois clique em “Test trigger” no Zapier: o evento chega com todos os campos.
Adicione uma etapa “Filter by Zapier” para que o Zap só continue com os eventos que você quer: por exemplo, Type é scan.created e Data Qr Name é o nome do seu código.
Adicione a ação, por exemplo “Create Spreadsheet Row” do Google Sheets, e mapeie os campos: Data Qr Name, Data Scan Scanned At, Data Scan Country…
Publique o Zap. A partir daí, cada leitura chega ao Zapier em poucos segundos.
Make, passo a passo
No Make, crie um cenário e adicione o módulo “Webhooks”, “Custom webhook”. Clique em “Add”, dê um nome a ele e copie o endereço.
No QR Studio, abra API e webhooks, cole o endereço em Webhooks e clique em “Adicionar webhook”.
De volta ao Make, o módulo fica aguardando dados: escaneie um dos seus códigos para que o Make aprenda a estrutura do evento.
Adicione os próximos módulos (Google Sheets, HubSpot, Slack…) e, se você recebe vários tipos de evento, um filtro em type. Depois ative o cenário com o agendamento “Immediately as data arrives”.
Criar códigos pelo Zapier ou pelo Make
Com a API REST, uma automação também pode criar códigos. Em API e webhooks, crie uma chave de API e depois adicione uma etapa de requisição HTTP (“Webhooks by Zapier” → “POST” no Zapier, “HTTP” → “Make a request” no Make) com estas configurações:
- Método
POST
- URL
https://qrcode.cdipalma.com/api/v1/qr
- Cabeçalhos
Authorization: Bearer qrs_… Content-Type: application/json
- Corpo (JSON)
{ "name": "Table 12", "destinationUrl": "https://example.com/menu?table=12" }
A resposta traz o id do novo código e o link curto dele (shortLink); a imagem, em SVG, fica em /api/v1/qr/ID/image (sendo ID esse id). Todos os campos e os demais endpoints estão descritos em API e webhooks.
O que cada evento contém
Cada requisição é um objeto JSON; o Zapier e o Make mostram os campos prontos para mapear.
type- O evento: scan.created para cada leitura, submission.created para cada resposta a uma página hospedada (avaliação, inscrição), ping para o evento de teste.
data.qr.id · name · slug · type- O código: o id, o nome que você deu a ele, o slug do link curto e o tipo.
data.scan.scannedAt · isUnique- Quando foi lido (ISO 8601, em UTC) e se é a primeira leitura daquele visitante.
data.scan.country · region · city- Local aproximado, quando conhecido: país (código de duas letras), região e cidade.
data.scan.deviceType · os · browser · language · variant- Tipo de dispositivo, sistema operacional, navegador, idioma e, em um teste A/B, a variante exibida.
data.submission.id · createdAt · rating · …- A resposta: o id, quando foi enviada, as estrelas (nas avaliações) e os campos do formulário, como nome e e-mail.
Cada requisição traz um cabeçalho X-QR-Studio-Signature (HMAC-SHA256), para que os seus próprios servidores possam verificar que ela vem mesmo do QR Studio. Trate o endereço do Zapier ou do Make como uma senha: quem o tiver pode enviar dados para a sua automação.
Pronto para conectar seus códigos?
API e webhooks estão incluídos em todos os planos.