Conectando suas plataformas

Elas não dão todas o mesmo trabalho, e é melhor saber disso antes de começar.

Plataforma	O que ela precisa	Esforço
Apple App Store	Uma chave de API do App Store Connect com acesso Admin ou App Manager: Issuer ID, Key ID, arquivo .p8	A chatinha, 10 minutos
Google Play	Login com o Google, escolher os aplicativos, mais a permissão Reply to reviews no Play Console	Minutos
Google Business Profile	Login com o Google como proprietário ou gerente do local, escolher os locais	Minutos
Facebook, Instagram, TikTok	Ainda não disponíveis	Em breve

Tudo acontece em Integrations no AI Review Sensor. As conexões pertencem apenas ao AI Review Sensor: os outros sensores do ScaleSensor conectam suas próprias fontes com suas próprias credenciais.

Você escolhe quais aplicativos ou locais adicionar. Conecte um, deixe sincronizar e depois adicione o próximo. É muito mais fácil dizer o que veio de onde quando a caixa de entrada não está enchendo de todas as fontes ao mesmo tempo.

Adicione um segundo aplicativo em uma plataforma que você já conectou e a credencial que você salvou será oferecida (na Apple, Use a saved API key; no Google, a conta com que você já entrou), em vez de pedir de novo a mesma chave ou consentimento.

Uma chave por equipe é mais fácil de rotacionar do que uma cópia dela em cada conector. As credenciais salvas são listadas pelo nome, com o Key ID ou o e-mail parcialmente mascarado. A chave privada e os tokens em si nunca são exibidos de novo, nem mesmo para você.

A primeira puxada traz as avaliações mais recentes de cada aplicativo (até 100) para que a caixa de entrada não fique vazia enquanto você dá uma olhada. É uma fatia, não todo o seu histórico.

Depois disso, cada conector é verificado a cada 30 minutos, aproximadamente. Novas avaliações são classificadas e traduzidas conforme chegam, e rascunhadas se o seu modo de automação for AI Drafts ou Auto-send.

Você não precisa esperar o cronômetro. Sync now puxa imediatamente. Se uma sincronização não encontra nada novo, ela diz isso ("Up to date"), em vez de alegar um sucesso que não teve.

Conectores ficam obsoletos por motivos comuns: uma chave é revogada no App Store Connect, uma conta do Google perde o acesso ou as permissões mudam do lado da plataforma.

Quando isso acontece, use Reconnect no conector. Para uma conta do Google, reconectar refaz o login e reúne de novo todos os aplicativos daquela conta, com uma sincronização de teste para confirmar que funciona. Toda avaliação já coletada permanece vinculada.

Excluir e adicionar de novo também funciona, e joga fora o histórico. Reconecte primeiro, sempre.

Duas coisas diferentes, de propósito.

Desconectar interrompe a sincronização de novas avaliações daquela fonte. Seus dados existentes ficam intactos, e você pode reconectar depois sem precisar entrar de novo.

Excluir remove o aplicativo e todas as suas avaliações e rascunhos do AI Review Sensor. Excluir uma conta inteira (a credencial salva) também remove todos os aplicativos dela. Os registros de cobrança são mantidos; os dados de avaliação não. Isso não pode ser desfeito, e só o Owner pode fazer.

Se você está em dúvida sobre qual quer, desconecte. É o reversível.

O Owner, os Managers e os Developers podem conectar e gerenciar integrações. A função Sales & Marketing não pode: ela é limitada à caixa de entrada, às análises e às respostas, que costuma ser o que você quer para as pessoas que atendem clientes o dia todo. Exclusões permanentes são só do Owner.

Você também precisa de acesso suficiente do lado da plataforma. Você não pode nos conceder um acesso que você mesmo não tem.

Quando uma sincronização ou uma resposta falha, o conector e a avaliação mostram o motivo em linguagem simples. O que cada um significa e o que fazer:

O que você vê	O que significa	O que fazer
A conexão expirou	A plataforma não aceita mais o acesso salvo	Use Reconnect no conector e depois envie a resposta de novo
Sem permissão para ler avaliações ou responder	A conta ou a chave não tem a permissão na plataforma	Verifique o acesso dela na plataforma (por exemplo, Reply to reviews no Play Console) e depois reconecte
A avaliação ou o aplicativo não foi encontrado	A avaliação foi removida, ou o aplicativo não está mais publicado ou visível para esta conta	Verifique se o aplicativo continua publicado e visível para a conta conectada
A plataforma está limitando a velocidade com que podemos publicar	Um limite de taxa do lado da plataforma	Nada. Continuamos tentando automaticamente; tente a resposta de novo em alguns minutos
Não foi possível acessar a plataforma	Uma falha de rede ou da plataforma	Nada. Continuamos tentando automaticamente
O prazo para responder terminou	A plataforma não aceita mais uma resposta para este item	Nada pode ser enviado para este item

Em um aplicativo da Apple, uma mensagem sobre a loja (storefront) significa que o aplicativo não está listado na App Store daquele país, ou que o feed de avaliações da Apple para aquela loja não pôde ser carregado. Verifique a loja que você escolheu para o aplicativo.

Se os erros continuarem voltando, reconecte o conector. Se isso não resolver, mande um e-mail para [email protected].