Se você deseja integrar seu aplicativo da App Store à Buzzmonitor para gerenciar avaliações e interações de forma mais eficiente, este guia é para você. Aqui, mostramos o passo a passo para gerar o Issuer ID e criar a chave de autenticação, elementos essenciais para a integração via App Store Connect API.
Com essas credenciais, a Buzzmonitor poderá acessar, com segurança e dentro das permissões definidas pelo administrador no App Store Connect, dados autorizados do aplicativo, como a coleta e resposta de avaliações dos usuários.
Passo a passo
1. Acesse o App Store Connect
Acesse a App Store Connect utilizando uma conta Apple Developer com permissão de administrador no app.
2. Abra a configuração: Usuários e Acesso
Clique em Usuários e Acesso, localizada no menu superior ou na lista de ícones da página.
3. Acesse a aba Integrações
Na página de Usuários e Acesso, selecione a aba Integrações e, no menu lateral, a opção API do App Store Connect. Aqui já é possível visualizar o Issuer ID e as chaves ativas.
4. Crie uma nova chave de API
Clique no botão +, ao lado do título Ativas, para criar uma nova chave e preencha:
- Nome da chave: um identificador interno para sua organização.
- Nível de acesso: é recomendada a utilização da permissão Administrador.
Lembre-se: após criada, não é possível editar o nome nem o nível de acesso. Para alterar, será necessário revogar e gerar uma nova chave.
Após clicar em Gerar, a nova chave aparecerá na lista de Ativas, exibindo o Key ID e uma opção Baixar que permite o download do arquivo.
⚠️ Faça o download imediatamente! A Apple só permite baixar este arquivo uma única vez. Se ele for perdido, será necessário revogar a chave e criar outra.
5. Registre suas credenciais
Anote os três valores necessários para a integração:
- Key ID (ID da chave criada)
- Issuer ID (exibido na aba de Integrações)
- Team ID (encontrado nas configurações da conta Apple Developer)
Esses dados, junto ao arquivo, serão usados para autenticar a integração na Buzzmonitor.
6. Associando o app à Buzzmonitor
Acesse a aba Gerenciador de Páginas e Perfis nas configurações da sua conta Buzzmonitor. Clique em + Adicionar e selecione o ícone da App Store.
Para concluir a associação, preencha os campos exibidos com os dados anotados no passo 5 e anteriores.
7. Acompanhando os apps
Após concluir a associação, o processo estará finalizado e a Buzzmonitor começará a monitorar as avaliações do seu app. As avaliações coletadas poderão ser visualizadas e acompanhadas diretamente nos relatórios e dashboards da plataforma, permitindo análise contínua do desempenho e do feedback dos usuários.
Avisos e limites importantes
- Download único do
.p8: o arquivo é disponibilizado apenas uma vez no momento da criação. Se perder, revogue e gere outro. - Chaves não podem ser editadas (nome/escopo): revogue e crie uma nova se precisar mudar permissões.
- Permissões mínimas: para a ação de responder avaliações é necessário acesso Admin; para ações simples, como coleta, a permissão de App Manager é suficiente. Verifique a permissão necessária para a ação que deseja realizar na Buzzmonitor.
- Número máximo de chaves: contas têm limite (ex.: até 50 chaves ativas. Confira o limite atual na documentação/console).
Referência
- Documentação oficial: https://developer.apple.com/documentation/appstoreconnectapi/creating-api-keys-for-app-store-connect-api