Integração CodeQR e Pluga via Webhooks: Passo a Passo
Aprenda a configurar a integração do CodeQR com o Pluga usando webhooks para automatizar eventos como cliques, scans e capturas de leads.
Introdução
Se você utiliza o CodeQR para encurtar links, criar QR Codes dinâmicos e capturar leads, agora é possível automatizar fluxos de trabalho com outras ferramentas via Pluga Webhooks.
O Pluga é uma plataforma que permite conectar diferentes sistemas sem necessidade de código, possibilitando a automação de processos entre aplicativos e CRMs como Google Sheets, RD Station, HubSpot, Trello, Slack e muitos outros.
Neste guia, você aprenderá como configurar a integração do CodeQR com o Pluga utilizando webhooks, permitindo que eventos como cliques em links, scans de QR Codes e capturas de leads sejam enviados automaticamente para outras ferramentas.
O que são Webhooks e como funcionam no CodeQR?
Os webhooks são mecanismos que permitem que um sistema envie automaticamente informações para outro sistema sempre que um evento específico acontece.
No CodeQR, você pode configurar webhooks para enviar dados em tempo real sempre que ocorrerem eventos como:
- Captura de um lead em uma página de pre-redirecionamento.
- Scan de um QR Code dinâmico.
- Clique em um link curto.
- Interações registradas no painel de análise.
Como Configurar o Pluga Webhooks para Receber Eventos do CodeQR
Aqui está o passo a passo para integrar o CodeQR ao Pluga via Webhooks:
1. Criando um Webhook no Pluga
🚀 Adicione uma imagem aqui mostrando o passo a passo no Pluga. Descrição da imagem: Tela do Pluga com a opção de criar uma nova automação, selecionando "Pluga Webhooks" como ferramenta de origem e gerando a URL do webhook.
Acesse sua conta no Pluga (https://pluga.co).
1 - Clique em "Criar uma nova automação".
2 - Na página seguinte, será necessário dar um nome a essa automatização:
3- Na etapa seguinte da configuração da sua automatização, selecione o Pluga Webhooks como ferramenta de origem e o gatilho "Notificação recebida"
4 - Depois, na etapa de conexão de conta, selecione uma conta conectada ou conecte uma nova:
5 - Copie o URL que será gerado pela sua automatização:
2. Configurando o Webhook no CodeQR
Agora, vamos configurar o CodeQR para enviar eventos para o Pluga.
1 - Acesse o Painel do CodeQR.
2- Navegue até as Configurações, Webhooks e clique em Criar Webhook
3 - Digite um nome e no campo "URL do Webhook", cole a URL gerada pelo Pluga.
4 - Escolha os eventos que deseja ativar e clique em Criar webhook
Pronto! O CodeQR agora enviará dados automaticamente para o Pluga Webhooks sempre que um desses eventos acontecer.
5 - Volta para a Pluga e clique em “Continuar”
6 - Em "Modelo de envio dos dados para notificação" cole um exemplo de JSON da CodeQR clique em "Continuar".
Veja abaixo um exemplo de JSON que você pode copiar e colar:
{
"id": "evt_12345",
"event": "event_name",
"createdAt": "2024-08-30T09:53:50.343Z",
"data": {
"eventName": "Nome do Evento",
"customer": {
"id": "customer_12345",
"name": "Nome do Cliente",
"email": "cliente@exemplo.com",
"avatar": "https://exemplo.com/avatar.jpg"
},
"interaction": {
"id": "click_12345",
"timestamp": "2024-08-30T10:16:12.124Z",
"url": "https://exemplo.com",
"ip": "192.168.0.1",
"continent": "SA",
"country": "BR",
"city": "São Paulo",
"device": "Desktop",
"browser": "Chrome",
"os": "Windows",
"ua": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/127.0.0.0 Safari/537.36",
"bot": false,
"qr": false,
"referer": "(direct)"
},
"link": {
"id": "link_12345",
"domain": "exemplo.link",
"key": "abc123",
"externalId": "external_12345",
"url": "https://exemplo.com",
"trackConversion": false,
"archived": false,
"expiresAt": "2025-08-30T09:53:50.343Z",
"expiredUrl": "https://exemplo.com/expired",
"password": "senha123",
"proxy": false,
"title": "Título do Link",
"description": "Descrição do Link",
"image": "https://exemplo.com/image.jpg",
"video": "https://exemplo.com/video.mp4",
"rewrite": false,
"doIndex": false,
"ios": "https://exemplo.com/ios",
"android": "https://exemplo.com/android",
"geo": "geo:37.7749,-122.4194",
"publicStats": false,
"tagId": "tag_12345",
"tags": ["tag1", "tag2"],
"comments": "Comentários sobre o link",
"shortLink": "https://exemplo.link/abc123",
"qrCode": "https://api.exemplo.io/qr?url=https://exemplo.link/abc123?qr=1",
"utm_source": "utm_source_example",
"utm_medium": "utm_medium_example",
"utm_campaign": "utm_campaign_example",
"utm_term": "utm_term_example",
"utm_content": "utm_content_example",
"userId": "user_12345",
"clicks": 0,
"lastClicked": "2024-09-05T16:36:15.000Z",
"leads": 0,
"sales": 0,
"saleAmount": 0,
"createdAt": "2024-08-26T16:41:52.084Z",
"updatedAt": "2024-08-26T16:41:52.084Z",
"projectId": "project_12345"
},
"qrcode": {
"id": "qrcode_12345",
"domain": "exemplo.link",
"key": "qr_abc123",
"archived": false,
"expiresAt": "2025-08-30T09:53:50.343Z",
"expiredUrl": "https://exemplo.com/expired",
"password": "senha123",
"externalId": "external_12345",
"trackConversion": false,
"proxy": false,
"title": "Título do QR Code",
"description": "Descrição do QR Code",
"image": "https://exemplo.com/qrcode.png",
"utm_source": "utm_source_example",
"utm_medium": "utm_medium_example",
"utm_campaign": "utm_campaign_example",
"utm_term": "utm_term_example",
"utm_content": "utm_content_example",
"rewrite": false,
"doIndex": false,
"flexible": false,
"filled": true,
"ios": "https://exemplo.com/ios",
"android": "https://exemplo.com/android",
"geo": "geo:37.7749,-122.4194",
"static": false,
"type": "url",
"contentStatic": "Conteúdo estático",
"text": "Texto do QR Code",
"email": {},
"wifi": {},
"url": "https://app.exemplo.io/",
"phone": "+5511999999999",
"vcard": {},
"crypto": {},
"sms": {},
"facetime": {},
"latlog": {},
"logo": "https://exemplo.com/logo.png",
"bgColor": "#ffffff",
"fgColor": "#000000",
"size": 1024,
"level": "H",
"showLogo": true,
"src": "https://exemplo.com/logo.png",
"height": 256,
"width": 256,
"excavate": true,
"userId": "user_12345",
"projectId": "project_12345",
"publicStats": false,
"scans": 1,
"lastClicked": "2024-09-05T16:36:15.000Z",
"leads": 0,
"sales": 0,
"createdAt": "2024-09-05T16:35:54.597Z",
"updatedAt": "2024-09-05T16:35:54.597Z",
"tagId": "tag_12345",
"comments": "Comentários sobre o QR Code",
"notificationToken": "token_12345",
"tags": ["tag1", "tag2"],
"shortLink": "https://exemplo.link/qr_abc123"
},
"page": {
"id": "page_12345",
"domain": "exemplo.link",
"key": "p/abc123",
"name": "Deixe seu feedback",
"description": "O que achou do nosso atendimento?",
"logo": "https://exemplo.com/logo.png",
"image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/=",
"imageBlurhash": "LKO2?U%2Tw=w]~RBVZRi};RPxuwH",
"externalId": "external_12345",
"trackConversion": false,
"message404": "Página não encontrada",
"type": "feedback",
"pageTitle": "Compartilhe seu feedback",
"pageSubtitle": "Alguma sugestão para melhorias adicionais? (opcional)",
"pageBackgroundType": "gradient",
"pageBackgroundStyles": {
"backgroundColorTo": "#2f1265",
"backgroundColorFrom": "#294c7c"
},
"pageFormType": "flat-color",
"pageFromStyles": {
"backgroundColor": "#FFFFFF"
},
"inputStyle": "rounded",
"buttonType": "flat-color",
"buttonStyles": {
"backgroundColor": "#000000"
},
"submitButtonType": "flat-color",
"submitButtonStyles": {
"backgroundColor": "#000000"
},
"fontFamily": "font-poppins",
"fontColor": "#000000",
"items": {
"fields": [
{
"id": "message",
"name": "message",
"type": "textarea",
"label": "Mensagem",
"enabled": true,
"required": false,
"placeholder": "Deixe sua mensagem"
}
]
},
"views": 1,
"lastClicked": "2024-09-07T21:36:01.000Z",
"publicStats": false,
"createdAt": "2024-09-07T21:32:37.309Z",
"updatedAt": "2024-09-07T21:32:51.471Z",
"hiddenLogo": false,
"projectId": "project_12345",
"userId": "user_12345",
"notificationToken": "token_12345",
"socialMediaLinks": {
"facebook": "https://facebook.com/exemplo",
"twitter": "https://twitter.com/exemplo",
"instagram": "https://instagram.com/exemplo"
},
"feedbacksCount": 0
}
}
}7 - Mapeie os campos e personalize as informações que serão enviadas pela nome da sua ferramenta, como mostra o gif abaixo:
Prontinho! Agora é só clicar em "Finalizar automatização" e deixar os robôs da Pluga trabalharem para você. 😎
Automações Possíveis via Pluga Webhooks
A integração do CodeQR com Pluga Webhooks abre diversas possibilidades, como:
✅ Enviar leads capturados para CRMs como RD Station, Pipedrive ou HubSpot.
✅ Criar uma tarefa no Trello ou Asana sempre que um lead for capturado.
✅ Registrar cliques e scans em uma planilha do Google Sheets para análise.
✅ Enviar uma notificação no Slack quando um QR Code for escaneado.
✅ Criar um evento no Google Calendar para follow-up com leads capturados.
Conclusão e Próximos Passos
Agora você já sabe como integrar o CodeQR ao Pluga via Webhooks, criando automações poderosas para seu negócio. Isso permite otimizar processos e integrar os dados de QR Codes, links e leads diretamente em suas ferramentas favoritas.
Aproveite e experimente agora mesmo essa integração! 🚀