Appearance
Instalação Power ATA
Este guia descreve o processo completo de instalação do Power ATA através do assistente de configuração acessível em https://app.powerata.ai/setup. O processo é dividido em 4 etapas principais representadas pela barra de progresso no topo de cada tela.
Etapa 1: Informações da Empresa
A primeira tela do wizard é acessada pelo navegador em modo InPrivate ou aba anônima para garantir o uso da conta correta da organização.
Campos obrigatórios
| Campo | Descrição |
|---|---|
| CNPJ/CPF | Documento da empresa ou pessoa responsável pela contratação |
| Razão Social | Nome jurídico da empresa |
| Nome Fantasia | Nome comercial da empresa |
Termos de Uso
Antes de prosseguir, é necessário marcar a caixa "Eu li e aceito os Termos de Uso". Um resumo dos termos é exibido diretamente na tela:
Ao aceitar os termos, você concorda com as condições de uso da plataforma, incluindo o processamento de dados pessoais conforme nossa política de privacidade, responsabilidades do usuário e limitações de responsabilidade da empresa.
Clique em Continuar para avançar.
Etapa 2: Configuração de Faturamento
Esta etapa é dividida em duas abas: Pagamentos e Informações da Empresa.
Aba: Pagamentos
| Campo | Descrição |
|---|---|
| E-mails para Faturamento | Um ou mais e-mails que receberão as faturas mensais. Ao menos um e-mail é obrigatório |
| Dias para vencer as faturas mensais | Dia do mês para vencimento (padrão: 20) |
| Método de pagamento | Opções disponíveis: Pix, Cartão e Boleto |
| Observações Adicionais | Campo opcional para informações complementares sobre o faturamento |
Faturamento Mensal
A fatura será enviada mensalmente para o e-mail informado no primeiro dia útil de cada mês.
Clique em Continuar para ir para a aba de Informações da Empresa.
Aba: Informações da Empresa
Aqui você irá adicionar todos os dados solicitados pertinentes a sua organização. Em seguida clique em Criar Organização para finalizar esta etapa.
Etapa 2a: Método de Instalação
Após a configuração da assinatura, o wizard apresenta dois métodos de instalação disponíveis.
| Método | Indicado para | Características |
|---|---|---|
| Instalação Automática (Recomendado) | Maioria dos casos | Configuração em 10-15 min, sem necessidade de conhecimento técnico, criação automática de recursos Azure e configuração de permissões automatizada |
| Instalação Manual | Ambientes personalizados | Controle granular das configurações, requer conhecimento técnico, configuração passo a passo |
Selecione o método desejado e avance. Caso o método selecionado for a instalação manual, siga o passo a passo abaixo antes de seguir com a seleção do método. Caso contrário siga com o procedimento da instalação automática.
Instalação Manual
Validação de Credenciais
Acesse portal.azure.com e navegue até Assinaturas.
Na listagem de assinaturas, clique sobre a assinatura desejada. Na tela de Visão Geral, anote o ID da Assinatura — ele será necessário durante a configuração do wizard.
| Campo | Onde encontrar |
|---|---|
| ID da Assinatura | Portal Azure → Assinaturas → Visão Geral → Fundamentos |
| Diretório | Exibido abaixo do ID, confirma o tenant correto |
| Status | Deve estar como Ativo |
Passo 2: Criar o Grupo de Recursos
No portal Azure, navegue até Grupos de Recursos e clique em + Criar.
Preencha os campos da aba Básico:
| Campo | Valor recomendado |
|---|---|
| Assinatura | Selecione a assinatura identificada no Passo 1 |
| Nome do grupo de recursos | rg-power-ata |
| Região | (US) East US |
Clique em Revisar e criar e depois em Criar.
Passo 3: Criar a Conta de Armazenamento (Storage Account)
No portal Azure, pesquise por Conta de armazenamento e clique em Criar.
WARNING
O nome da conta de armazenamento deve ser único globalmente. Use um padrão como stgpowerata12345, substituindo os números por um sufixo exclusivo da sua organização.
Preencha os campos:
| Campo | Valor recomendado |
|---|---|
| Assinatura | Selecione a assinatura correta |
| Grupo de recursos | rg-power-ata |
| Nome da conta de armazenamento | stgpowerata12345 (deve ser único globalmente) |
| Região | (US) East US |
| Tipo de armazenamento preferencial | Armazenamento de Blobs do Azure ou Azure Data Lake Storage Gen 2 |
| Desempenho | Standard |
| Redundância | LRS (armazenamento com redundância local) |
Clique em Revisar e criar e depois em Criar.
Passo 4: Implantar o Modelo no Microsoft Foundry
No portal Azure, pesquise por Microsoft Foundry e clique em Criar.
Preencha os campos de criação do recurso Foundry:
| Campo | Valor recomendado |
|---|---|
| Assinatura | Selecione a assinatura correta |
| Grupo de recursos | rg-power-ata |
| Nome | foundry-power-ata |
| Região | East US |
| Default project name | proj-default |
Após criar o recurso, acesse o projeto criado dentro do Foundry. Na tela de boas-vindas do projeto você encontrará três informações importantes:
| Dado | Finalidade |
|---|---|
| Chave de API | Autenticação das chamadas à API do Foundry |
| Ponto de extremidade do projeto | Endpoint base do projeto |
| Ponto de extremidade do OpenAI do Azure | Endpoint para chamadas de modelos OpenAI |
Dentro do Foundry, acesse Modelos no menu lateral e pesquise pelo modelo desejado (ex: gpt-4.1-mini). Selecione o modelo e clique em Implantar.
Passo 5: Configurar a Política de Acesso via PowerShell
No portal Azure, abra o Cloud Shell clicando no ícone de terminal na barra superior.
Com o terminal aberto, execute os seguintes comandos na ordem:
5.1. Importar o módulo do Microsoft Teams:
powershell
Import-Module MicrosoftTeams5.2. Autenticar no Microsoft Teams:
powershell
Connect-MicrosoftTeamsUma janela de autenticação será aberta. Faça login com a conta de administrador da organização.
5.3. Criar a política de acesso do Power ATA:
powershell
New-CsApplicationAccessPolicy -Identity "PowerAta-Policy" -AppIds "1b599d0b-c856-4aee-a155-48a29a006d09" -Description "PowerAta"5.4. Aplicar a política globalmente na organização:
powershell
Grant-CsApplicationAccessPolicy -PolicyName PowerAta-Policy -GlobalINFO
Esses comandos criam e aplicam uma política que autoriza o aplicativo Power ATA a acessar os dados de reuniões do Microsoft Teams na organização.
Passo 6: Iniciar a Instalação Manual no Wizard
Com todos os recursos criados no Azure, retorne ao wizard em app.powerata.ai/setup e selecione Instalação Manual. Preencha os campos com os dados dos recursos criados nos passos anteriores e clique em Iniciar Instalação Manual.
Nota
Após iniciar a instalação manual, o sistema enviará uma mensagem para registrar a assinatura na fila de processamento. Essa etapa é necessária para que a plataforma reconheça o ambiente configurado.
Instalação Automática
Após selecionar o método de instalação, você seguirá os passos abaixo e logo os recursos serão criados dentro da sua assinatura do Azure automaticamente.
Validação de Credenciais
Para continuar, é necessário validar as credenciais em quatro serviços clicando em Validar Token em cada um deles:
| Serviço | Finalidade |
|---|---|
| Consentimento Administrador | Autoriza o aplicativo a agir em nome da organização |
| Microsoft Graph | Acesso a dados de usuários, calendários e reuniões |
| Management | Acesso ao gerenciamento de recursos Azure |
| Teams | Acesso às transcrições e eventos do Microsoft Teams |
Após validar todos os tokens, clique em Confirmar.
Etapa 2b: Permissões Solicitadas pela Microsoft
Ao clicar em Validar Token no Consentimento Administrador, a Microsoft exibirá uma tela de consentimento com todas as permissões que o Power ATA solicita para a organização.
Permissões solicitadas pelo aplicativo Power ATA
- Sign in and read user profile
- Read calendars in all mailboxes
- Read all call records
- Read all call transcripts
- Read and write all groups
- Send mail as any user
- Read all AI Insights for online meetings
- Read all recordings of online meetings
- Read online meeting details
- Read all transcripts of online meetings
- Read all users' full profiles
- Access Microsoft Teams and Skype for Business data as the signed in user
- Acessar o Gerenciamento de Serviços do Azure como usuários da organização (versão prévia)
WARNING
Ao aceitar, o aplicativo terá acesso aos recursos específicos de todos os usuários da organização. Ninguém mais será solicitado a analisar essas permissões.
Configuração da Assinatura Azure
Depois de dadas as permissões e consentimentos o wizard abrirá um modal para vincular a assinatura Azure da organização.
Seleção da Assinatura
- Um dropdown exibirá todas as assinaturas Azure disponíveis para a conta autenticada
- Selecione a assinatura correta
- Clique em Confirmar para avançar
Etapa 3a: Revisão das Configurações
Antes de iniciar, o wizard exibe um resumo de todos os recursos que serão criados no ambiente Azure da organização.
| Campo | Descrição |
|---|---|
| Assinatura Azure | Assinatura selecionada na etapa anterior, com o ID exibido abaixo |
| Grupo de Recursos | Nome do grupo de recursos que será criado (gerado automaticamente) |
| Nome do Storage | Nome da conta de armazenamento Azure (gerado automaticamente) |
| Microsoft Foundry | Recurso Azure AI Foundry que será criado |
| Nome do Projeto | Nome do projeto dentro do Foundry |
INFO
O indicador Quota disponível confirma que a região selecionada possui capacidade suficiente para o modelo escolhido.
Clique em Iniciar Instalação Automática para começar.
Etapa 3b: Instalação Automática em Progresso
O wizard executa automaticamente as 10 etapas de configuração da infraestrutura, exibindo o status de cada uma em tempo real.
Etapas de instalação
| Etapa | Nome | Descrição |
|---|---|---|
| 1 | Criar Política | Criação das políticas de acesso e governança |
| 2 | Criar Grupo de Recursos | Provisionamento do Resource Group no Azure |
| 3 | Configurar Azure AI Foundry | Configuração do recurso de IA no Azure |
| 4 | Adicionar Permissões | Atribuição das permissões necessárias aos recursos |
Status por etapa
| Status | Significado |
|---|---|
| Concluído | Etapa finalizada com sucesso |
| Executando | Etapa em andamento no momento |
| Pendente | Etapa aguardando as anteriores serem concluídas |
A barra Progresso Total no rodapé exibe o avanço em formato numérico (ex: 6/10) e visual.
Ao final, quando todas as etapas estiverem com status Concluído, a instalação está completa e a plataforma está pronta para uso em https://app.powerata.ai.
Em caso de dúvidas durante a instalação, entre em contato com a equipe da Azure Brasil pelo portal de Tickets de Suporte.