Como registrar informações automaticamente em planilhas

O CodeQR é uma ferramenta poderosa para encurtar links, gerar QR Codes dinâmicos e capturar leads. Com a integração entre o CodeQR e a Pluga via Webhooks, você pode registrar automaticamente eventos importantes, como cliques, scans de QR Codes e capturas de leads, diretamente em planilhas do Google Sheets ou Excel Online.

Essa automação permite centralizar informações valiosas, acompanhar resultados em tempo real e manter seus dados organizados — sem precisar inserir nada manualmente.

O que são Webhooks e como automatizar o envio de eventos para outras ferramentas?

Os webhooks são uma forma de automação que permite que um sistema envie dados automaticamente para outro sempre que um evento específico ocorre. 

No CodeQR, você pode configurar webhooks para enviar informações em tempo real sobre eventos como cliques, scans de QR Codes e capturas de leads. Isso permite que você monitore as conversões em tempo real, garantindo que sua equipe receba atualizações instantâneas e possa agir rapidamente. 

Essas informações podem ser enviadas diretamente para planilhas no Google Sheets ou Excel, permitindo que você registre e analise os dados de forma automática.

Exemplo de uso: planilha para registrar conversões em tempo real

Por exemplo, empresas que usam QR Codes em materiais de divulgação conseguem monitorar em tempo real onde e como os códigos estão sendo acessados. A cada interação, dados como cidade, dispositivo e horário são salvos automaticamente na planilha, facilitando a análise da campanha.

Já quem utiliza o CodeQR para capturar leads via formulários pode armazenar informações como nome e e-mail diretamente em uma planilha, mantendo a base sempre atualizada para ações de marketing ou vendas.

Essa automação traz agilidade, organização e decisões baseadas em dados.

Como Configurar a Pluga Webhooks para Receber Eventos do CodeQR

Passo 1: Criando um Webhook na Pluga

1 - Acesse sua conta na Pluga

Vá para o site Pluga e faça login.

2 - Crie uma nova automatização

Clique em Criar uma nova automatização e forneça um nome para a automatização.

3 - Selecione a Pluga Webhooks

Na etapa de configuração da automatização, escolha Pluga Webhooks como a ferramenta de origem. Selecione o gatilho Notificação recebida.

4 - Obtenha a URL do Webhook

Na etapa de configuração de conexão, copie a URL gerada pela Pluga. Esta URL será usada no CodeQR.

Passo 2: Configurando o Webhook no CodeQR

1 - Acesse o Painel do CodeQR

Faça login na sua conta do CodeQR e vá para a seção de Configurações.

2 - Crie um novo Webhook

Em Webhooks, clique em Criar Webhook e insira um nome para o webhook.

3 - Cole a URL da Pluga

No campo URL do Webhook, cole a URL que você copiou da Pluga.

4 - Clique em Criar Webhook

Selecione os eventos desejados para disparar notificações, como cliques em links ou scans de QR Codes. Com a configuração concluída, clique em Criar Webhook. Agora, os dados serão enviados automaticamente para a Pluga toda vez que um desses eventos ocorrer.

Exemplo de JSON de Dados Enviados

A Pluga receberá os dados enviados pelo CodeQR no formato JSON. Aqui está um exemplo de como os dados podem ser estruturados:

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

Passo 3: Configurando a Notificação de conversão em sua ferramenta

1 - Insira o JSON na Pluga

Volte para a Pluga e clique em “Continuar”. Agora, ajuste as informações do Pluga Webhooks preenchendo o nome da ferramenta que está enviando as informações para a Pluga. No campo "Modelo de envio dos dados para notificação" cole um exemplo de JSON da CodeQR clique em "Continuar".

2 - Filtre as informações

Se preferir, você pode filtrar as informações a serem recebidas. Caso contrário, basta deixar esses campos em branco.

3 - Conecte a ferramenta

Conecte a ferramenta para dar continuidade a criação de sua automatização. Por exemplo, suponha que você deseja atualizar uma planilha com informações relacionadas a um evento de conversão do CodeQR.

4 - Selecione a ferramenta de destino

Como exemplo, escolhemos o Google Sheets como ferramenta de destino. Você pode configurar uma mensagem personalizada para ser enviada a um canal sempre que um evento de conversão ocorrer (por exemplo, um clique ou scan de QR Code).

Passo 4: Mapeamento de Campos na Pluga

1 - Mapeie os campos requeridos

Após configurar a automatização, é necessário mapear os campos requeridos para garantir que os dados recebidos sejam formatados corretamente. Isso assegura que informações como nome do cliente, evento e URL apareçam corretamente nas notificações. 

2 - Finalize ou continue a sua automatização

Se desejar, você pode configurar a automatização para enviar os dados mapeados para várias ferramentas de sua preferência, como Slack, Trello ou outras plataformas. Isso permitirá que você receba as notificações de forma organizada em diferentes canais. Caso contrário, é só finalizar sua automatização.

Conclusão e Próximos Passos

Agora você já sabe como integrar o CodeQR à 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! 🚀