---
title: Recuperação após instalação
description: Pré-requisitos e limites de colagem, Android, App Clip e detecção própria.
---

## Escolher o mecanismo

| Mecanismo | Pré-requisito | Limite |
| --- | --- | --- |
| Colagem explícita | Usuário copia o link, instala e confirma colagem no app | Não lê clipboard sem ação explícita; sem garantia se o conteúdo mudou |
| Google Play Install Referrer | App Android/SDK integrado e distribuição pela Google Play | Fluxo depende da loja e do referrer preservado; não cobre todas as instalações |
| Universal/App Links e scheme | Associação de domínio e identidade nativa corretas | Aplicam-se à abertura do app; não equivalem a recuperação após instalação |
| App Clip | Configuração e entrega próprias Apple | Disponibilidade depende do app/domínio e revisão/distribuição; não é habilitada só por criar um link |
| Detecção própria iOS | Opção habilitada por domínio, SDK pronto e contexto elegível | Opcional, desligada por padrão; pode não resolver por ambiguidades, atraso ou ausência de evidência |

No painel, abra Configurações / Domínios / integração nativa e confirme quais capacidades estão disponíveis. Configure identidade Android/iOS, formato de scheme e caminhos associados; habilite recuperação somente quando a integração estiver pronta. Não confunda os experimentos internos com funcionalidades liberadas para todo app.

## Integração e confirmação

No Flutter, use o SDK público para receber HTTPS/scheme/colagem e registrar abertura/conteúdo com identificadores preservados. Trate ausência de resultado, repetição, expiração e confirmação explícita. Não coloque API key administrativa no app. Teste instalação e abertura em aparelho real pela loja; teste de contrato não comprova instalação.

A API administrativa permite GET/PUT /domains/{domainId}/native-config e /recovery-config, diagnósticos e métricas agregadas. Endpoints de recuperação pública usam seus próprios contratos/capacidades, não uma chave administrativa de usuário. [Contratos públicos](/sdk/contratos-publicos/) · [SDK Flutter](/sdk/flutter/) · [Diagnóstico](/diagnostico/).

Erros 403 podem indicar capacidade desligada; estado pendente pode indicar associação/DNS/TLS; resultado vazio de detecção pode ser a decisão correta em contexto ambíguo. Não use preferências do dispositivo como identidade nem trate métricas de recuperação como instalações comprovadas.