Migrar do Rebrandly: guia de exportação, importação e DNS

Para migrar do Rebrandly você faz três coisas: tira seus links pela API do Rebrandly, recria cada slashtag em um domínio que você controla no Elido e depois aponta o DNS desse domínio para o Elido. O importador de Rebrandly embutido no Elido cuida das duas primeiras para os campos que ele suporta (slashtag, destino, título, tags). A troca de DNS, o histórico de cliques e as regras de roteamento ficam por sua conta.

O que surpreende as pessoas é o domínio. Os links no seu próprio hostname mantêm suas URLs exatas, então o redirecionamento que um visitante recebe na segunda-feira é o mesmo que recebeu na sexta. Os links em rebrand.ly não podem migrar, porque você não é dono desse host. Este guia percorre toda a jornada em ordem: exportação, mapeamento, importação, troca de DNS, manutenção dos 301, verificação, rollback e o que esperar dos analytics. Tudo o que está abaixo sobre o Elido foi conferido no código-fonte do importador e no painel; tudo sobre o Rebrandly vem da central de ajuda e da documentação para desenvolvedores dele, acessadas em 2026-10-02.

Se você ainda está decidindo se vai mesmo sair, comece por Elido versus Rebrandly. Se já decidiu, continue lendo.

Migração do Rebrandly num relance

A versão curta, para quem quer o plano antes do detalhe:

1. Baixe todos os links por GET /v1/links para um arquivo JSONL que você guarda como trilha de auditoria.
2. Decida por domínio: o seu próprio hostname migra com uma troca de CNAME, os links rebrand.ly ganham URLs novas.
3. Adicione o domínio de destino no Elido e publique o registro TXT de verificação.
4. Rode o importador (ou a API em massa) com uma estratégia de conflito que não possa alterar slugs em silêncio.
5. Troque o CNAME, confira em resolvedores públicos e teste seus links principais.
6. Deixe o Rebrandly rodando por 30 dias como seu rollback.

Para alguns milhares de links, a importação leva minutos. O tempo de calendário vai para os TTLs de DNS, os testes e os 30 dias de sobreposição.

Passo 1: exporte seus links do Rebrandly

O Rebrandly expõe os links pela API REST, e esse é o caminho de exportação que toda ferramenta de migração usa, inclusive a do Elido. GET /v1/links devolve até 25 links por página, ordena por createdAt e pode filtrar por domain.id ou domain.fullName. A paginação é por cursor: passe o id do último link recebido como last, como descreve a documentação de paginação.

Com arquivos é mais difícil. O artigo do Rebrandly sobre mover links para um novo domínio diz que não há uma opção embutida; o contorno é exportar pela API para CSV, editar a coluna de domínio e importar de novo. O guia de importação deles cobre o sentido inverso (CSV de até 400.000 links por arquivo, domínio personalizado obrigatório). Então use a API e guarde uma cópia sua:

# Dump every link to links.jsonl (25 per page, cursor = id of last link)
last=""
while :; do
  page=$(curl -s -H "apikey: $REBRANDLY_KEY" \
    "https://api.rebrandly.com/v1/links?limit=25&orderBy=createdAt&orderDir=asc${last:+&last=$last}")
  [ "$(echo "$page" | jq 'length')" -eq 0 ] && break
  echo "$page" | jq -c '.[]' >> links.jsonl
  last=$(echo "$page" | jq -r '.[-1].id')
done
wc -l links.jsonl

O arquivo é a sua linha de base de contagem, a sua fonte das datas de criação originais e a entrada de qualquer ajuste feito por script. Uma armadilha: uma chave de API do Rebrandly enxerga todos os links de todos os workspaces a que o usuário pertence. Uma agência com cinco workspaces de clientes costuma querer migrar um cliente por vez, e tanto a chamada de listagem quanto o importador do Elido aceitam um filtro de workspace.

Não consegui confirmar, pela documentação pública, quais campos de clique cada plano devolve, então abra um registro real da sua própria conta antes de prometer a alguém uma análise histórica.

Passo 2: decida o que migra - rebrand.ly versus seu próprio domínio

O caminho migra; o host só migra se for seu. Um link como go.acme.com/summer pode continuar funcionando sem alteração depois da troca. rebrand.ly/summer não pode, porque esse hostname pertence ao Rebrandly e continua resolvendo pelo serviço deles enquanto a sua conta existir. Três casos cobrem a maioria das contas.

• Seu próprio domínio, com o DNS sob seu controle. O melhor caso. Recrie cada slashtag no mesmo hostname no Elido e depois aponte o DNS para o novo destino. QR codes impressos, arquivos de e-mail e bios continuam funcionando.
• Um domínio comprado pelo Rebrandly. O artigo de ajuda do Rebrandly manda usar Transfer out e pedir um código por e-mail, e observa que a maioria dos domínios tem um bloqueio de 60 dias após o registro. Comece esse relógio cedo e trate a troca do CNAME como o primeiro passo mais seguro.
• O domínio gratuito rebrand.ly. Os slashtags passam para um novo host, mas as URLs antigas ficam com o Rebrandly. Se estiverem impressas, mantenha a conta ativa enquanto esses materiais circularem.

Para um hostname novo, veja domínios personalizados para links curtos.

Passo 3: mapeie campos, tags e workspaces do Rebrandly para o Elido

O importador é propositalmente enxuto. Ele lê quatro itens por link do Rebrandly (slashtag, destino, título, tags), grava-os em um link do Elido no domínio que você escolheu e adiciona uma tag. Qualquer outra coisa exige um script seu ou uma etapa manual.

As datas de criação merecem uma segunda olhada: o endpoint em massa (POST /v1/workspaces/{id}/links/bulk, 100 links por requisição) recebe apenas slug, destino, título e tags, então os links importados são ordenados pela data de importação. O importador do Dub as preserva, então, se as datas originais importam para relatórios, guarde o arquivo JSONL. O formulário do painel mostra apenas a chave, o domínio de destino e a estratégia de conflito; o filtro de workspace funciona hoje pela API e um campo no painel está planejado.

O Elido tem pastas, mas o importador não as cria. Leve a estrutura como tags no seu pré-processamento (client:acme, campaign:summer), ou filtre por imported:rebrandly depois e use edições de tag em massa. Os modelos de UTM do Rebrandly não têm uma exportação limpa, então refaça-os como regras de campanha e corrija nomes soltos com uma convenção de nomes para UTM. Os links importados recebem um QR code padrão do Elido; designs de QR personalizados precisam ser aplicados de novo.

Passo 4: rode o importador de Rebrandly do Elido

O importador fica em Integrations, depois Rebrandly to Elido (também POST /v1/workspaces/{id}/imports/rebrandly). Adicione primeiro o domínio de destino ao seu workspace para que ele apareça no seletor.

1. Crie uma chave no Rebrandly em Account, depois API. O acesso de leitura é tudo de que o job precisa.
2. Cole a chave no formulário. O Elido a mantém na memória do processo durante a execução e a descarta depois; ela não é gravada no registro do job.
3. Escolha o domínio de destino. Todo link que a chave enxerga cai nesse único domínio, sem filtro por domínio, então uma conta com vários domínios no Rebrandly e slashtags repetidos vai gerar colisões.
4. Escolha uma estratégia de conflito e inicie o job. A página consulta o estado a cada dois segundos e você pode fechá-la.

O Rebrandly limita uma página a 25 links, enquanto o Bitly devolve 100, então a mesma conta leva mais tempo vindo do Rebrandly e o gargalo é o fornecedor. Nossa estimativa de engenharia para 5.000 links é de 6 a 10 minutos. O worker segue o cursor last até uma página voltar vazia, limita um job a 50.000 links e desiste após 30 minutos. As linhas ignoradas e com falha vão para o log de erros do job (primeiras 1.000 entradas).

Três estratégias de conflito são escolhidas no início. suffix (padrão) tenta mylink-2, mylink-3 e assim por diante até 50 candidatos, e então informa um erro. skip deixa o link existente do Elido em paz e registra a linha no log. fail aborta o job no primeiro conflito. Um slug com sufixo não é registrado como problema, mas é uma URL alterada, então, para uma transferência no mesmo domínio, use skip ou fail em um domínio de destino vazio e trate qualquer contagem de ignorados ou com falha diferente de zero como trabalho a fazer.

Para um controle mais fino, envie o seu JSONL ao endpoint em massa, que informa sucesso ou erro por linha; as APIs e SDKs do Elido recebem o mesmo par de slug e destino. Quer testar antes? Crie um workspace no Elido e aponte o importador para um domínio reserva; a página de migração do Rebrandly lista os mesmos itens que vão junto e os que ficam para trás.

Passo 5: troca do DNS e manutenção dos 301

A ordem importa, porque o Elido verifica um domínio por dois registros de DNS e o tráfego real só muda quando o segundo muda: um registro TXT em _elido-verify.<hostname> com o valor verify=<token> e um CNAME do hostname para o destino de borda do Elido (edge.elido.me por padrão). Veja a página de recursos de domínios personalizados.

1. Dois dias antes, reduza o TTL do CNAME atual para 300 segundos, adicione o domínio no Elido e publique o registro TXT. O tráfego real não é afetado.
2. Rode o importador nesse domínio e compare a contagem importada com wc -l links.jsonl.
3. Na janela da troca, mude o CNAME para o destino de borda do Elido. O Elido consulta os dois registros e emite o certificado, como explicado em TLS de domínio personalizado em cinco minutos.
4. Consulte pelo menos dois resolvedores públicos (dig @8.8.8.8 go.acme.com CNAME, depois @1.1.1.1), já que a sua própria máquina só prova o seu próprio cache.
5. Não mexa no Rebrandly: ainda não exclua o domínio nem a conta.

Reaponte o Zapier, o Make ou scripts que criam links do Rebrandly só depois de a importação estar confirmada.

No seu próprio domínio, o hostname e o caminho são idênticos, então a mesma URL passa a responder pelo Elido. O que você protege é o tipo de redirecionamento: se os seus links do Rebrandly eram permanentes, mantenha-os permanentes, porque trocar um link de longa duração para temporário muda como buscadores e caches o tratam (redirecionamentos 301 vs 302). Quando o próprio host muda, um 301 do antigo para o novo leva os usuários até lá e a RFC 9110 seção 15.4.2 diz aos clientes que eles podem atualizar as referências guardadas, mas isso exige o hostname antigo, que você não controla em rebrand.ly.

Passo 6: verifique a migração

Não anuncie a mudança com base em uma tela verde do job. Confira que importados mais ignorados mais com falha é igual ao número de linhas do seu JSONL (menos os domínios que você deixou para trás), que ignorados e com falha são zero ou que cada entrada do log tem explicação, e que nenhum slug terminou com um sufixo -2 que o Rebrandly não tinha. Filtre Links por imported:rebrandly e examine. Depois compare o cabeçalho Location dos seus 100 principais links com o destino no seu JSONL:

while read -r slug dest; do
  got=$(curl -s -o /dev/null -w "%{redirect_url}" "https://go.acme.com/$slug")
  [ "$got" = "$dest" ] || echo "MISMATCH $slug -> $got (expected $dest)"
done < top100.tsv

Confira à mão slashtags com maiúsculas e minúsculas misturadas e caracteres especiais, já que não testei todos os slugs de caso extremo. Leia um QR code impresso em um celular usando dados móveis. Migrar do Bitly sem quebrar links tem uma lista de modos de falha mais rigorosa, e o guia de migração do TinyURL mostra o padrão para outra origem.

Passo 7: rollback, analytics e quando não trocar

Seu rollback de verdade é a configuração antiga, ainda rodando. Enquanto o Rebrandly mantiver o domínio e os links, reverter é uma troca de CNAME de uma linha de volta ao destino anterior, e com um TTL de 300 segundos a maioria dos visitantes acompanha em minutos. Dentro do Elido, a tag imported:rebrandly é a alça de desfazer: filtre o lote e reaplique tags, mova ou exclua, e depois importe de novo. Rodar de novo é seguro com skip; com suffix ele cria cópias -2, então prefira skip em uma segunda passada.

O worker roda dentro da aplicação do Elido, então um deploy ou uma falha no meio da importação o interrompe. Uma varredura a cada cinco minutos muda para falho, com um motivo, qualquer job sem progresso por 30 minutos. Hoje não há cursor salvo. Você reinicia o job. Retomar a partir do último cursor do Rebrandly está planejado e fará mais diferença acima de cerca de 10.000 links.

O histórico de cliques fica no Rebrandly, então exporte os relatórios de que precisa antes de fazer downgrade e anote o horário da troca. Os novos cliques chegam ao Elido a partir do momento em que o CNAME resolve para ele, com uma curta sobreposição em que os dois painéis contam, porque os resolvedores descartam registros em cache em velocidades diferentes. Se um link movimentado não mostrar nada após uma hora, rode o loop de curl antes de suspeitar do painel. Para manter contínuas as séries de campanha, veja rastrear UTMs de ponta a ponta. Após 30 dias tranquilos, faça downgrade ou encerre o Rebrandly.

O importador não refaz regras de roteamento por dispositivo ou geografia, modelos de UTM nem o estilo de QR. A participação em equipes também não é copiada. O importador de Rebrandly do Dub também ignora o direcionamento por dispositivo e geografia, então isso é típico, não exclusivo do Elido. Se a sua configuração depende de regras de roteamento ou da marca nos QR codes, rode os dois produtos em paralelo por um mês antes. A página de comparação com o Rebrandly e as alternativas ao Rebrandly comparam preços e recursos.

Relacionados no blog

• Elido vs Rebrandly: preços, residência de dados na UE e links de marca em 2026
• Alternativas ao Rebrandly: 9 ferramentas de links de marca ranqueadas
• Bitly vs Rebrandly: links de marca, preços e adequação
• Guia de migração do Bitly: do inventário ao monitoramento de 30 dias
• Configure links curtos de marca: escolha um domínio e publique numa tarde