Automatize a CodeQR: API, MCP, Zapier, Make, n8n e webhooks
Qual caminho automatiza links curtos e QR codes — API REST, MCP para assistentes de IA, Zapier, Make, n8n, IFTTT ou webhooks — e o que cada plano inclui.
Tudo o que você faz no painel da CodeQR — criar um link curto, gerar um QR code dinâmico, trocar um destino, ler leituras e cliques — também pode ser feito por um programa, um cenário sem código ou um assistente de IA. Esta página diz qual porta usar para cada tarefa, o que o seu plano inclui e onde fica a referência técnica.
Disponibilidade
- Plano: a API REST, o servidor MCP e as integrações com Zapier, Make, IFTTT e n8n estão em todos os planos, inclusive o Free. Webhooks personalizados exigem Pro ou superior; webhooks de cliques e leituras individuais exigem Business ou superior. Limites de requisições e cotas dependem do plano (tabela abaixo).
- Onde: chaves de API em Configurações → Chaves de API; integrações em Configurações → Integrações; webhooks em Configurações → Webhooks; o servidor MCP em
https://mcp.codeqr.io/mcp; a referência de endpoints em docs.codeqr.io.
Antes de começar
- Uma chave de API pertence a um workspace. Se você administra vários, crie uma chave em cada um.
- Links e QR codes criados por qualquer desses caminhos aparecem no painel como os demais, contam nas mesmas cotas do plano e registram cliques e leituras do mesmo jeito.
- Nada aqui muda como um link redireciona: a automação só cria, edita, lê ou apaga o que você criaria à mão.
Qual caminho serve para a sua tarefa
- Algumas dezenas de links ou QR codes a partir de um arquivo, uma vez — importe um CSV no painel. Sem chave, sem código: Importe links em massa de um arquivo CSV e Importe QR Codes em massa de um arquivo CSV.
- Um link ou QR code por linha de planilha, formulário ou registro de CRM, continuamente — Make, Zapier, n8n ou IFTTT com um passo de "criar" por linha, ou
POST /links/bulknum script pequeno. Comparação em Crie links e QR codes em massa a partir de uma planilha. - Seu próprio produto ou backend cria e atualiza links — a API REST com uma chave de API. Comece por Crie seu primeiro link curto com a API da CodeQR; a chave em si está em Crie uma chave de API e escolha as permissões.
- Você quer pedir a um assistente que faça isso — conecte Claude, ChatGPT, Cursor ou qualquer cliente MCP ao servidor MCP da CodeQR. Não envolve chave de API; você entra com sua conta e escolhe o workspace: Conecte a CodeQR ao Claude, ChatGPT e Cursor com MCP.
- Seu sistema precisa saber quando um link é criado, um QR code muda, um lead chega ou alguém clica — webhooks, entregues como POSTs HTTP assinados para uma URL sua ou para Make, Zapier ou Pluga: Envie eventos de links e QR codes ao seu app com webhooks.
- Você quer especificamente os campos de analytics, regras inteligentes, formulários de pré-redirecionamento ou design de QR — cada um tem sua página de API: Leia suas métricas pela API, MCP e webhooks, Crie Regras inteligentes com a API, o MCP e automações, Crie QR Codes com a API, o MCP e automações, Configure formulários de pré-redirecionamento pela API.
O que cada plano inclui
- Acesso à API: todos os planos. Requisições por minuto por chave — Free 60, Starter 100, Pro 500, Business 1.000, Scale 10.000. Acima do limite a API responde
429 Too many requests.até virar o minuto. - Links, QR codes, cliques rastreados: as mesmas cotas mensais do painel; um link criado pelo Zapier é um link.
- Zapier, Make, IFTTT, n8n, Pipedream, Integrately: nenhum requisito de plano para conectar. Os gatilhos de "novo link" e de webhook seguem as regras de webhook abaixo.
- Servidor MCP: todos os planos; o assistente faz o que o usuário conectado pode fazer naquele workspace.
- Webhooks para a sua própria URL: Pro ou superior para eventos de criação, atualização e exclusão de links, QR codes e páginas, e para leads e vendas. Link clicked, QR Code scanned e Page visited, e anexar um webhook a links ou códigos específicos, exigem Business ou superior.
- Envio nativo de leads a CRMs (RD Station, Kommo, HubSpot): Starter ou superior.
Limites de requisições e cotas valem por chave e por workspace, não por usuário.
Vocabulário
- Chave de API — o segredo
codeqr_…que você coloca num cabeçalho. O painel chama a página de Chaves de API do Projeto. - Workspace — a unidade que possui links, QR codes, domínios, chaves e webhooks. Algumas telas e mensagens de erro chamam de projeto; é a mesma coisa.
- Webhook — um POST HTTP que a CodeQR envia à sua URL quando um evento acontece. Não confundir com a URL de um link.
- Em massa (bulk) —
POST /links/bulkePOST /qrcodes/bulk, até 100 itens por requisição. - MCP — Model Context Protocol, o jeito de assistentes de IA chamarem a CodeQR como um conjunto de ferramentas.
Verifique se funcionou
Seja qual for o caminho, a prova é a mesma: o novo link ou QR code aparece em Links ou QR Codes com o destino que você enviou e, depois de abrir o link curto uma vez, Análise mostra o clique em dois a três minutos.
Solução de problemas
Consigo criar chave de API, mas não consigo criar webhook
É o modelo de papéis, não um defeito: qualquer membro do workspace cria, edita e apaga chaves de API; só o proprietário do workspace cria, edita ou apaga webhooks e apps OAuth. Membros continuam vendo a lista de webhooks e os logs. As páginas ficam em Configurações do Desenvolvedor, na barra lateral de configurações — Chaves de API, Apps OAuth, Webhooks.
A página da integração diz COMING SOON
Cartões marcados COMING SOON (Albato, HubSpot na data desta publicação) ainda não podem ser ativados. Use um webhook genérico ou o módulo HTTP da sua ferramenta de automação enquanto isso.
Criei a chave, mas a ferramenta pede um "workspace ID"
As chaves da CodeQR são vinculadas a um workspace, então nada mais o identifica. Se um formulário insistir num ID, use o id do workspace devolvido por GET /projects — mas a chave sozinha basta para todo endpoint.