logo
APIIntegrações•

Conecte a CodeQR ao Zapier, Make, n8n e IFTTT

Ative os apps da CodeQR no Zapier, Make, n8n e IFTTT em Configurações → Integrações, veja o que cada um dispara e faz, e a saída quando falta um campo.

Avatar for undefined
CodeQR Team
Equipe de Conteúdo

A CodeQR tem app oficial no Zapier, no Make e no IFTTT e um nó da comunidade no n8n. Este guia ativa cada um, lista exatamente o que ele dispara e faz, e mostra a saída para tudo o que os módulos não cobrem.

Disponibilidade

  • Plano: todos os planos podem conectar as quatro plataformas. O que a plataforma faz depois segue as regras normais: links e QR codes criados contam na sua cota; gatilhos de evento seguem os níveis de webhook (eventos de criação, atualização e exclusão a partir do Pro; cliques e leituras a partir do Business).
  • Onde: Configurações → Integrações, seção Automations (a página de integrações aparece em inglês). Os cartões mostram a quantidade de instalações e o selo ENABLED quando conectados; cartões COMING SOON (Albato) ainda não podem ser ativados.

Automations section of the Integrations page with Make, Zapier, IFTTT, Pipedream, CodeQR MCP, Integrately, Bubble, n8n and Albato cards

Antes de começar

  • Você precisa de conta na plataforma (Zapier, Make, n8n, IFTTT). O lado da CodeQR é gratuito.
  • Só o n8n pede chave de API; os outros três autorizam por uma tela de consentimento e criam a própria chave com escopo, que então aparece em Configurações → Chaves de API.
  • Decida qual workspace conectar. A autorização é por workspace; para automatizar dois workspaces, conecte duas vezes.

Zapier

  1. Em Configurações → Integrações, abra Zapier e siga o link do site zapier.com/apps/codeqr/integrations, ou comece pelo Zapier e procure CodeQR - Link and QR Analytics.
  2. Quando o Zapier pedir para conectar sua conta, permita o acesso ao workspace; o cartão vira ENABLED.
  3. Monte o Zap. Os gatilhos são por consulta periódica — Zapier checks for new data every 15 min on the Free plan: New Link, New QR Code, New Page. Ações: Create a Link (URL obrigatória; Key, Domain, External ID, Flexible, Tag IDs, Tag Names, Title, Description, Image URL, Video URL, Proxy, Pre-Redirection Page, Page ID, Page URL, Rewrite, iOS, Android, Allow Indexing, Comments, Expiration Date, Expired Redirect URL, Geo-Targeting, Public Stats), Create a QR Code (QR Code Type obrigatório; Static/Dynamic, Show Logo, URL, Text, E-mail, Phone, Background Color, Foreground Color, Size, Track Conversion, Title, Description, Image URL, Expiration Date, Public Stats), Delete Link, Delete QR Code, e as buscas Retrieve Link e Retrieve a QR Code (por ID, External ID ou Domain + Key).
  4. Não há gatilho de clique ou leitura no Zapier. Para automações por clique, use um webhook para uma URL "Catch Hook" do Zapier (plano Business) — veja Envie eventos de links e QR codes ao seu app com webhooks.

Make

  1. Abra Make em Configurações → Integrações e clique em Enable (ou comece pelo Make: app CodeQR - Link and QR Analytics, marcado Verified e Official Vendor). Permita que o Make acesse o workspace.
  2. Módulos disponíveis: Create a Link, Create a QR Code, Delete a Link, Delete a QR Code, Search Link e Retrieve a QR Code, o gatilho instantâneo Watch Webhook Events ("Triggers when an event occurs in your CodeQR account, such as link creation, updates, or tracking activities") e Make an API Call para qualquer endpoint que os módulos não expõem.
  3. Watch Webhook Events registra um webhook da CodeQR para você; escolha os eventos no módulo (os catorze tipos de evento podem ser selecionados para o Make). Os níveis de plano valem exatamente como para um webhook criado à mão.
  4. O cartão do Make também oferece um cupom (Request Coupon) para quem já usa o Make e links para a Make Academy, modelos e comunidade.

O artigo mais antigo Integração CodeQR e Make.com: Automatize fluxos de trabalho percorre um cenário completo; a lista de módulos acima é a atual.

n8n

  1. Instale o nó da comunidade no n8n: Settings → Community nodes → Install → n8n-nodes-codeqr (n8n 1.54.4 ou mais novo, Node.js 18.10 ou mais novo).
  2. Crie uma chave de API da CodeQR com Links → Write e QR Codes → Write (Crie uma chave de API e escolha as permissões) e cole na credencial do nó.
  3. Operações: Links — Create Short Link, Get Link Information, Update Link, Delete Link; QR Codes — Generate QR Code, Get QR Code Data, Update QR Code Destination, Delete QR Code.
  4. Tudo o mais — tags, pastas, analytics, em massa — vai pelo nó HTTP Request do n8n com Authorization: Bearer <chave> contra https://api.codeqr.io. O cartão n8n em Configurações → Integrações só aponta para o pacote; ativá-lo lá é opcional.

IFTTT

  1. Abra IFTTT em Configurações → Integrações, clique em Enable e permita o acesso — ou conecte a partir de ifttt.com/codeqr ao montar o applet.
  2. Existem duas ações, sem gatilhos nem consultas: Create a link e Generate a QR Code. Applets típicos: encurtar cada novo post do WordPress, item de RSS, vídeo do YouTube ou evento de calendário.
  3. As chaves que você digita na ação Create a link recebem um sufixo aleatório de 5 caracteres (lancamento vira lancamentox7Kq2), então dois applets nunca colidem.

Pipedream, Integrately, Albato, Bubble

Esses cartões apontam para a listagem da própria plataforma (Pipedream e Integrately instalam pelo mesmo fluxo de consentimento; Albato está COMING SOON; Bubble é um plugin). Todos usam a mesma API REST por baixo, então os nomes de campos deste guia e de Crie seu primeiro link curto com a API da CodeQR valem.

Desconecte uma plataforma

Abra o cartão em Configurações → Integrações, clique em ⋮ ao lado de INSTALLED BY e escolha Uninstall Integration; em Desinstalar Integração (Isso removerá a integração do seu workspace. Tem certeza de que deseja continuar?) clique em Confirmar. Apagar a chave da plataforma em Configurações → Chaves de API também corta o acesso, mas o cartão continua ENABLED até você desinstalar aqui.

Verifique se funcionou

  1. Rode o cenário ou o Zap uma vez com uma linha de teste ou um gatilho manual.
  2. O link ou QR code aparece em Links / QR Codes com o destino que você mapeou.
  3. Em Configurações → Chaves de API, a chave da plataforma mostra um Último uso recente.

Solução de problemas

O gatilho do Zapier "não encontrou dados" ou dispara atrasado

Os gatilhos da CodeQR no Zapier consultam a cada 15 minutos no plano Free do Zapier (mais rápido nos pagos). Crie um link, espere a próxima consulta ou aperte "Test trigger" depois que o link existir.

O módulo do Make de que preciso (atualizar link, listar links) não existe

Use Make an API Call com o endpoint da referência — por exemplo PUT /links/{id} com {"url": "…"}. A descrição do Make dentro do app ainda menciona módulos de update e upsert; o app atual do Make tem os oito módulos listados acima.

"The provided key does not have the required permissions…" dentro do n8n

A chave de API que você colou foi criada Somente Leitura ou sem o recurso. Crie uma chave nova com Write em Links e QR Codes e atualize a credencial.

A lista de domínios da ação está vazia

O workspace conectado à plataforma ainda não tem domínio próprio, ou a plataforma guardou a lista antes de você adicionar um. Reconecte a conta ou digite o domínio; os domínios compartilhados funcionam sem configuração.

Conectei o workspace errado

Desinstale pelo cartão (⋮ → Uninstall Integration) e ative de novo com o workspace certo selecionado no seletor do painel.

Artigos relacionados