Envie cada visitante ao destino certo com Regras inteligentes
Regras inteligentes levam um único link curto ou QR Code a destinos diferentes por dispositivo, país, idioma, campanha ou site de origem — ou dividem o tráfego para um teste A/B.

Um link curto ou um QR Code impresso, vários destinos: com Regras inteligentes (Smart Rules) você decide onde cada visitante chega conforme o dispositivo, a localização, o idioma do navegador, a campanha que o trouxe ou o site de onde veio — e pode dividir o tráfego entre destinos para rodar um teste A/B. Leia esta página para entender o que é uma regra e escolher o guia da sua tarefa.
Disponibilidade
- Plano: Business ou superior (preços). Em planos inferiores o botão mostra o selo Business e a API recusa a requisição.
- Onde: no construtor de links (Links → Adicionar Link, ou abra um link e escolha Editar), ative Regras inteligentes na lista de recursos opcionais. QR Codes dinâmicos do tipo URL têm a mesma seção no editor de QR Code. QR Codes estáticos não usam Regras inteligentes.

O que é uma regra
Uma regra se lê como uma frase: se atributo é / não é valor, então envie o visitante para destino.
- Atributo — o que a CodeQR verifica na requisição:
- Dispositivo: o sistema operacional (iOS, Android, Windows, macOS, Linux)
- Localização: País, Região (estado), Cidade, Continente — a partir do endereço IP do visitante
- Campanha: Origem UTM, Mídia UTM, Campanha UTM, Termo UTM, Conteúdo UTM — lidos da query string do seu link curto
- Referenciador — o site de onde o visitante veio
- Idioma — o idioma preferido do navegador
- Operador — é ou não é. O valor precisa coincidir por inteiro (maiúsculas e minúsculas não importam); não existe "contém".
- URL de destino — para onde vão os visitantes que combinam com a regra. Em vez de uma URL, ative Dividir tráfego (teste A/B) para enviar esses visitantes a 2–4 URLs variantes por porcentagem.
Uma regra sem condição chama-se Todo o tráfego. Ela sempre divide o tráfego e precisa ser a última.

Como a CodeQR decide
As regras rodam de cima para baixo. A primeira que combinar vence. Se nenhuma combinar, o visitante vai para a URL de destino do link. Cada regra tem exatamente uma condição; para combinar condições, ordene as regras da mais específica para a mais geral. O caminho completo de decisão, incluindo como as Regras inteligentes interagem com Camuflagem de links, Segmentação iOS, Segmentação Android e Segmentação Geográfica, está em Como as Regras inteligentes escolhem o destino.
Escolha o seu guia
- Mandar quem usa iPhone para a App Store, quem usa Android para o Google Play e o restante para o seu site — Leia: Envie visitantes iOS e Android para a loja de apps certa
- Mostrar uma página localizada por país, estado, cidade, continente ou idioma do navegador — Leia: Redirecione visitantes por país, região, cidade ou idioma
- Levar o tráfego da newsletter, de anúncios ou do Instagram para uma página exclusiva — Leia: Roteie o tráfego de campanha por UTM ou referenciador
- Testar duas ou mais landing pages atrás de um link ou QR Code — Leia: Divida o tráfego de um link para um teste A/B
- Criar ou alterar regras por código, por um agente de IA ou por uma automação — Leia: Crie Regras inteligentes com a API, o MCP e automações
- Consultar todos os atributos, operadores, valores aceitos e limites — Leia: Referência das Regras inteligentes
- Entender por que um visitante caiu num lugar inesperado — Leia: Como as Regras inteligentes escolhem o destino
Limites em resumo
- Até 20 regras por link ou QR Code
- 2 a 4 variantes por divisão; pesos inteiros que somam 100
- Regras valem em links e em QR Codes dinâmicos do tipo URL; não em QR Codes estáticos nem em QR Codes de outros tipos (Wi-Fi, vCard, WhatsApp, texto)
- Disponíveis no app web, na API REST (campo
rulesem links e QR Codes), no servidor MCP (create_linkeupdate_link) e — por meio da API — nas plataformas de automação
Regras inteligentes e os botões antigos de segmentação
O construtor de links ainda tem Segmentação iOS, Segmentação Android e Segmentação Geográfica. As Regras inteligentes cobrem os mesmos casos e outros, e uma Regra inteligente que combina tem prioridade sobre esses botões. Use Regras inteligentes nos links novos; não é preciso ligar os botões antigos.
