Guideline 5.6.3: o pedido de avaliação que recusa seu app

A Apple recusa um app que pede uma nota cedo demais. Se o seu pedido de avaliação aparece na primeira abertura ou durante o onboarding, você corre o risco de uma recusa com base na guideline 5.6.3. O pedido tem que vir depois que o usuário realmente usou o app, e passar pela janela do sistema.

Levei essa recusa no Solys, meu despertador com minijogos. Aqui está o que a regra diz, o que a Apple recomenda e como eu corrigi.

O que diz a guideline 5.6.3?

A guideline 5.6.3 faz parte do "Developer Code of Conduct", a seção 5.6 das App Review Guidelines. O texto proíbe manipular o que os clientes da App Store veem: rankings, busca, avaliações, indicações para o seu app. Ele não fala do onboarding.

Mesmo assim, foi essa a regra que a Apple citou para o meu pedido de nota. O raciocínio está nas regras de design dela: na primeira abertura ou durante o onboarding, a pessoa ainda não teve tempo de formar uma opinião.

Na mesma seção, a 5.6.1 define o meio permitido: usar a API fornecida pela Apple para pedir uma avaliação. Janelas de avaliação feitas em casa não são aceitas, e a guideline 3.2.2 proíbe bloquear uma função até o usuário dar uma nota.

Quando pedir uma avaliação

As regras de design da Apple sobre notas e avaliações são claras. Você só pede uma nota depois que a pessoa realmente usou o app.

Momento do pedido	Posição da Apple	Por quê
Na primeira abertura	Evitar	Ainda sem opinião
Durante o onboarding	Evitar	App ainda não usado
No meio de uma tarefa	Evitar	O pedido interrompe a ação
Depois de uma tarefa concluída	Recomendado	O app já é conhecido
Num botão "Avaliar o app"	Sim, com um link	A janela às vezes não abre
Várias vezes seguidas	Evitar	Os lembretes cansam

Só as duas primeiras linhas me renderam uma recusa. O resto vem dos conselhos da Apple. Duas referências úteis: a Apple aconselha deixar pelo menos uma a duas semanas entre dois pedidos, e o próprio sistema limita a exibição da janela a três vezes por período de 365 dias, para um mesmo app. Então você não consegue forçar que ela apareça.

A recusa 5.6.3 que levei no Solys

Em 30 de agosto de 2026, uma atualização do Solys foi recusada. A mensagem da Apple citava a 5.6.3 e dizia que o app pedia uma nota na primeira abertura ou durante o onboarding. A revisão foi feita num iPad Air.

A causa era simples. No fluxo de boas-vindas, a tela "Deixar uma avaliação" vinha em segundo lugar, logo depois da demo do minijogo. O usuário só tinha visto a demo.

A correção: o pedido foi movido para mais adiante no fluxo, e só aparece se o usuário acabou de ganhar a demo. Quem pula a demo ou perde não vê pedido nenhum. A versão corrigida foi aceita em seguida.

Foi uma aposta minha: a mensagem da Apple dizia "não durante o onboarding", sem ressalvas.

A lição: o caminho seguro é tirar o pedido do onboarding. Uma nota, assim como uma permissão, se pede depois que a pessoa viu o que o app entrega para ela.

Pedir uma avaliação com a janela do sistema

Num app Expo, a janela do sistema passa pela biblioteca expo-store-review:

import * as StoreReview from "expo-store-review";

export async function demanderUnAvis() {
  if (await StoreReview.isAvailableAsync()) {
    await StoreReview.requestReview();
  }
}

Três coisas para saber, tiradas da documentação da Apple sobre pedido de avaliação:

• É o sistema que decide se mostra ou não a janela. A chamada pode não mostrar nada. Não construa nenhuma tela que dependa dela aparecer.
• Evite disparar a janela a partir de uma ação do usuário, como um botão: ela pode não aparecer. Para um botão "Avaliar o app", abra a página do seu app na App Store, com ?action=write-review no fim do endereço.
• Escolha um momento de sucesso: o fim de uma sequência de ações que o usuário acabou de concluir, não a abertura do app.

O exemplo de código da Apple também atrasa a chamada: ele espera a pessoa concluir a ação várias vezes, e não pede duas vezes para a mesma versão do app. O número de vezes fica a seu critério.

O checklist antes de enviar

• Nenhum pedido de nota na primeira abertura.
• Nenhum pedido de nota no onboarding.
• O pedido passa pela janela do sistema, não por uma tela caseira com estrelas.
• O botão "Avaliar o app" dos ajustes abre a página da App Store, ele não chama a janela do sistema.
• O pedido vem depois de um uso real: uma tarefa concluída, uma fase vencida, várias aberturas.
• Você testou o fluxo de boas-vindas no iPad também: várias das minhas recusas foram apontadas no iPad, para apps de iPhone.

Evitar a recusa 5.6.3 antes do próximo envio

O Apple Review Kit reúne meu checklist antes do envio, minhas recusas da Apple corrigidas e skills do Claude Code que revisam seu projeto. Se o seu app acabou de ser recusado e você quer um olhar humano, agende uma hora comigo: a gente revisa seu fluxo de boas-vindas por videochamada, na sua tela. O passo a passo completo está na página app recusado pela Apple, e os outros motivos comuns estão em por que a Apple recusa um app.

Se você está preparando seu primeiro lançamento, faça seu diagnóstico gratuito: ele coloca as etapas na ordem e te envia meu checklist anti-recusa da Apple.

Perguntas frequentes

Dá para pedir uma nota durante o onboarding?

A Apple desaconselha isso nas regras de design dela, e eu levei uma recusa por isso, com base na guideline 5.6.3. A pessoa ainda não usou o app: ela não tem como ter opinião. Coloque o pedido depois de um uso real.

Quantas vezes dá para mostrar o pedido de avaliação?

O sistema limita a janela a três exibições por período de 365 dias para um mesmo app. A Apple também aconselha deixar pelo menos uma a duas semanas entre dois pedidos, e o exemplo de código dela não pede duas vezes para a mesma versão do app.

Dá para criar sua própria janela de avaliação?

Não. A guideline 5.6.1 exige usar a API fornecida pela Apple, e descarta janelas de avaliação caseiras. Por outro lado, você pode oferecer um botão "Avaliar o app" que abre a página do seu app na App Store.

Precisa de um novo build depois de uma recusa 5.6.3?

Sim, se o pedido está no código do build, o que quase sempre é o caso. O revisor vê o código embarcado na primeira abertura: uma atualização remota não basta. Mova o pedido, gere um novo build e envie de novo.

Qual é o momento certo para pedir uma avaliação?

Logo depois de um sucesso: uma tarefa concluída, uma fase vencida, uma meta atingida. A Apple recomenda um momento que não interrompa nada, quando a pessoa já conhece o app. Evite a abertura do app e o meio de uma ação.