# 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](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.

<figure><img src="/files/X531PkFzJezb8HOiYMv6" alt=""><figcaption></figcaption></figure>

#### Campos obrigatórios

<table><thead><tr><th width="184">Campo</th><th>Descrição</th></tr></thead><tbody><tr><td><strong>CNPJ/CPF</strong></td><td>Documento da empresa ou pessoa responsável pela contratação</td></tr><tr><td><strong>Razão Social</strong></td><td>Nome jurídico da empresa</td></tr><tr><td><strong>Nome Fantasia</strong></td><td>Nome comercial da empresa</td></tr></tbody></table>

#### 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

<figure><img src="/files/VCBcd5eP8cDOsnBKPQdO" alt=""><figcaption></figcaption></figure>

| 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

<figure><img src="/files/U1rcNk4C9FBTI0HlnMhP" alt=""><figcaption></figcaption></figure>

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.

<figure><img src="/files/R3a9XJsqC4q5bMGlVaZ5" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="120">Método</th><th width="101">Indicado para</th><th width="331">Características</th></tr></thead><tbody><tr><td><strong>Instalação Automática</strong> <em>(Recomendado)</em></td><td>Maioria dos casos</td><td>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</td></tr><tr><td><strong>Instalação Manual</strong></td><td>Ambientes personalizados</td><td>Controle granular das configurações, requer conhecimento técnico, configuração passo a passo</td></tr></tbody></table>

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](#instalacao-automatica).

***

## Instação Manual

### Validação de Credenciais

Acesse [portal.azure.com](http://portal.azure.com) e navegue até **Assinaturas**.

<figure><img src="/files/NQl1BK3cEIqYfKVc54ao" alt=""><figcaption></figcaption></figure>

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.

<figure><img src="/files/M8uGqE6q1xBbRCBteE0Q" alt=""><figcaption></figcaption></figure>

| 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**.

<figure><img src="/files/R45wH4UNVpWf6VIsmg3Z" alt=""><figcaption></figcaption></figure>

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`                                 |

<figure><img src="/files/BbDHSkXWdT8YH8xru743" alt=""><figcaption></figcaption></figure>

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**.

<figure><img src="/files/sII9nByUDFWSTJGOgSQX" alt=""><figcaption></figcaption></figure>

> ⚠️ 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)                        |

<figure><img src="/files/EOdboYsC8QSbIhPUhWaE" alt=""><figcaption></figcaption></figure>

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**.

<figure><img src="/files/B7vSmdUcPNysVyotnH7f" alt=""><figcaption></figcaption></figure>

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`                 |

<figure><img src="/files/efbF2q8uBBq5ROwXuPEE" alt=""><figcaption></figcaption></figure>

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   |

<figure><img src="/files/RP30WSoeZu818S8nXZid" alt=""><figcaption></figcaption></figure>

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**.

<figure><img src="/files/a4IADmzr6knC2TvqZH33" alt=""><figcaption></figcaption></figure>

***

#### 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.

<figure><img src="/files/JEhJJBPaBFtKppKtZgmR" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/OJ8jUybYMzsCzcJQs60L" alt=""><figcaption></figcaption></figure>

Com o terminal aberto, execute os seguintes comandos na ordem:

**5.1. Importar o módulo do Microsoft Teams:**

```powershell
Import-Module MicrosoftTeams
```

**5.2. Autenticar no Microsoft Teams:**

```powershell
Connect-MicrosoftTeams
```

Uma 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 -Global
```

> 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](http://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**.

<figure><img src="/files/z1nrTb2bde9ld9HnFeB7" alt=""><figcaption></figcaption></figure>

> ℹ️ **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:

<figure><img src="/files/PyNEam3YGGVWO1WRv2OQ" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="190">Serviço</th><th>Finalidade</th></tr></thead><tbody><tr><td><strong>Consentimento Administrador</strong></td><td>Autoriza o aplicativo a agir em nome da organização</td></tr><tr><td><strong>Microsoft Graph</strong></td><td>Acesso a dados de usuários, calendários e reuniões</td></tr><tr><td><strong>Management</strong></td><td>Acesso ao gerenciamento de recursos Azure</td></tr><tr><td><strong>Teams</strong></td><td>Acesso às transcrições e eventos do Microsoft Teams</td></tr></tbody></table>

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.

<figure><img src="/files/Piaol46v56KIhP4x6Hx3" alt=""><figcaption></figcaption></figure>

#### Permissões solicitadas pelo aplicativo PwtATA

* 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)

> 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

<figure><img src="/files/jkodvkgKVCSBXdA7giWC" alt=""><figcaption></figcaption></figure>

1. Um dropdown exibirá todas as assinaturas Azure disponíveis para a conta autenticada
2. Selecione a assinatura correta
3. 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.

<figure><img src="/files/SprJiLnSYqVrksO7QSgC" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="195">Campo</th><th>Descrição</th></tr></thead><tbody><tr><td><strong>Assinatura Azure</strong></td><td>Assinatura selecionada na etapa anterior, com o ID exibido abaixo</td></tr><tr><td><strong>Grupo de Recursos</strong></td><td>Nome do grupo de recursos que será criado (gerado automaticamente)</td></tr><tr><td><strong>Nome do Storage</strong></td><td>Nome da conta de armazenamento Azure (gerado automaticamente)</td></tr><tr><td><strong>Microsoft Foundry</strong></td><td>Recurso Azure AI Foundry que será criado</td></tr><tr><td><strong>Nome do Projeto</strong></td><td>Nome do projeto dentro do Foundry (padrão: default)</td></tr><tr><td><strong>Região</strong></td><td>Região Azure onde os recursos serão provisionados (ex: eastus)</td></tr><tr><td><strong>Nome do Modelo</strong></td><td>Identificador do modelo de IA a ser implantado (ex: gpt-4.1-mini)</td></tr><tr><td><strong>Modelo AI</strong></td><td>Versão completa do modelo com data e custo por token de entrada/saída</td></tr></tbody></table>

> 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.

<figure><img src="/files/tAV2JSURb9BetoOwhP5h" alt=""><figcaption></figcaption></figure>

#### Etapas de instalação

<table><thead><tr><th width="97">Etapa</th><th>Nome</th><th>Descrição</th></tr></thead><tbody><tr><td>1</td><td><strong>Criar Política</strong></td><td>Criação das políticas de acesso e governança</td></tr><tr><td>2</td><td><strong>Criar Grupo de Recursos</strong></td><td>Provisionamento do Resource Group no Azure</td></tr><tr><td>3</td><td><strong>Configurar Azure AI Foundry</strong></td><td>Configuração do recurso de IA no Azure</td></tr><tr><td>4</td><td><strong>Adicionar Permissões</strong></td><td>Atribuição das permissões necessárias aos recursos</td></tr><tr><td>5</td><td><strong>Implantar Modelo</strong></td><td>Deploy do modelo de IA selecionado no Foundry</td></tr><tr><td>6</td><td><strong>Criar Armazenamento de Dados</strong></td><td>Criação da conta de Storage para dados da plataforma</td></tr><tr><td>7</td><td><strong>Adicionar Permissões ao Armazenamento</strong></td><td>Configuração de acesso ao Storage</td></tr><tr><td>8</td><td><strong>Vincular aos eventos do Teams</strong></td><td>Integração com o Microsoft Teams para captura de transcrições</td></tr><tr><td>9</td><td><strong>Implantar Agente</strong></td><td>Deploy do agente de IA responsável pelo processamento das reuniões</td></tr><tr><td>10</td><td><strong>Finalizar Instalação</strong></td><td>Conclusão e validação de toda a infraestrutura</td></tr></tbody></table>

#### 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**](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.*


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://azbr.gitbook.io/power-ata/instalacao-power-ata.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.