Este documento fornece um guia completo, passo a passo, para gerar o ID de Emissor e criar a chave de autenticação (.p8) necessária para integrar aplicações da App Store com o Buzzmonitor através da API do App Store Connect.
Estas credenciais permitem que a plataforma aceda de forma segura aos recursos autorizados da aplicação (como a recolha e resposta a avaliações), de acordo com as permissões definidas pelo administrador da conta no App Store Connect
1️⃣ Aceder ao App Store Connect
Inicie sessão em https://appstoreconnect.apple.com com uma conta de programador Apple que tenha privilégios de administrador na aplicação.
2️⃣ Abrir as definições de “Utilizadores e Acesso”
Clique em "Usuários e Acesso", disponível no menu superior ou na lista de ícones da página:
3️⃣ Aceder ao separador Integrações
Na página "Usuários e Acesso", seleccione o separador Integrações e, no menu lateral, a opção API do App Store Connect.
Aqui poderá visualizar o ID do emissor e as chaves activas.
4️⃣ Criação de uma nova chave API
Clique no botão "+" para criar uma nova chave e preencha os seguintes dados:
Nome da chave: identificador interno da sua organização.
Nível de acesso: recomenda-se a utilização da permissão de Administrador.
Nota: após a criação, não é possível editar o nome nem o nível de acesso. Para efectuar alterações, será necessário revogar a chave e gerar uma nova.
Depois de clicar em "Gerar", a nova chave aparecerá na lista de chaves activas, apresentando o ID da chave e a opção de Transferência, que permite descarregar o ficheiro .p8.
⚠️ Atenção: descarregue o ficheiro imediatamente. A Apple apenas permite o download deste ficheiro uma única vez. Caso o perca, terá de revogar a chave e criar uma nova.
5️⃣ Registar as credenciais
Tome nota dos três valores necessários para a integração:
ID da chave (da chave criada)
ID do emissor (disponível no separador Integrações)
ID da equipa (disponível nas definições da conta de programador Apple)
Estes dados, juntamente com o ficheiro .p8, serão utilizados para autenticar a integração com a Buzzmonitor.
6️⃣ Associar a aplicação à Buzzmonitor
Aceda a página de Gerenciador de Páginas e Perfis na sua conta da Buzzmonitor. Clique em "+ Adicionar" e seleccione o ícone da App Store.
Para concluir a associação, preencha os campos apresentados com os dados recolhidos no passo 5 e nos passos anteriores.
7️⃣ Monitorização das aplicações
Após concluir a associação, o processo ficará finalizado e a Buzzmonitor começará a monitorizar as avaliações da sua aplicação.
As avaliações recolhidas poderão ser consultadas e acompanhadas directamente nos relatórios e painéis da plataforma, permitindo uma análise contínua do desempenho e das opiniões dos utilizadores.
Avisos e limitações importantes
Transferência única do ficheiro .p8
O ficheiro só pode ser descarregado uma vez aquando da criação da chave. Em caso de perda, será necessário revogar a chave e gerar outra.
As chaves não podem ser editadas (nome/permissões)
Para alterar estes dados, é necessário revogar a chave existente e criar uma nova.
Permissões mínimas
Para determinadas acções (por exemplo, responder a avaliações), pode ser necessário o nível de Administrador. Para muitas outras operações, o perfil de Administrador de aplicações poderá ser suficiente. Verifique sempre as permissões exigidas pela integração com a Buzzmonitor.
Número máximo de chaves
As contas têm um limite de chaves activas (por exemplo, até 50). Consulte o limite actual na documentação ou consola da Apple.