Instalar o Finn no Microsoft Teams

Português

Este guia é para o administrador de TI da organização. Ele descreve como fazer o sideload do aplicativo Finn no tenant da sua empresa pelo Microsoft Teams Admin Center. O processo leva cerca de 10 minutos.

English

This guide is written for your organization's IT admin. It walks through sideloading the Finn Teams app into your tenant via the Microsoft Teams Admin Center. The whole flow takes about 10 minutes.

Pré-requisitos / Prerequisites

Você é administrador global ou administrador de aplicativos do Teams (Teams Administrator) no Microsoft Entra ID.
Sua organização recebeu um convite da Aton para usar o Finn.
Acesso ao Teams Admin Center → Manage apps.

1. Baixar o manifesto / Download the manifest

Baixe o arquivo .zip do aplicativo Finn:

Download finn.zip · finn-2.0.0.zip (versioned)

O arquivo é público por design — o App ID dentro dele não é segredo (Microsoft o transmite em toda atividade do bot). Não modifique o conteúdo do .zip: alterações podem quebrar a validação no Teams Admin Center.

2. Upload no Teams Admin Center

Abra admin.teams.microsoft.com → Teams apps → Manage apps.
Clique em + Upload new app (canto superior direito) → Upload.
Selecione o finn.zip baixado no passo anterior.
Aguarde a validação. O Microsoft Teams verifica:
- esquema do manifesto;
- URLs de Privacidade e Termos (devem responder com 200);
- dimensões dos ícones (192×192 cor, 32×32 outline);
- domínio do publisher (aton-ai.com) verificado.

Se a validação falhar, capture a mensagem de erro do Teams Admin Center e encaminhe para contato@aton-ai.com.

3. Aprovar permissões / Approve permissions

O Finn não solicita nenhuma permissão do Microsoft Graph (sem leitura de e-mail, calendário, diretório ou perfil). A tela de revisão deve aparecer vazia na seção de permissões — esse é o comportamento esperado.

Finn requests zero Microsoft Graph permissions (no mail, calendar, directory, or profile reads). The permission review screen should show an empty permissions section — that's the expected state.

4. Publicar para a organização / Publish to your org

Encontre o aplicativo Finn na lista de Manage apps.
Defina como Allowed no nível da organização.
Em Setup policies ou Permission policies, libere o app para o grupo de usuários piloto inicial (recomendamos começar com 3–5 pessoas).

5. Comunique os usuários / Notify the users

Peça aos usuários piloto que instalem o Finn:

Abrir o Microsoft Teams (desktop, web ou mobile).
Ir em Apps (barra lateral esquerda) → buscar Finn → Add.
Clicar no chat com o Finn e enviar um "olá" para começar.

6. Conclusão do onboarding

A primeira mensagem de um novo tenant aciona um fluxo de cadastro do lado da Aton (a equipe da Aton registra o tenant para que as próximas mensagens recebam respostas reais do Finn). Esse passo é automático na primeira instalação — se passar de 1 dia útil sem o Finn responder normalmente, escreva para contato@aton-ai.com.

The first message from a freshly-installed tenant triggers a tenant-registration step on Aton's side. If Finn doesn't start responding normally within one business day, contact contato@aton-ai.com.

Removing Finn / Removendo o Finn

Para desinstalar, vá em Manage apps → Finn → Blocked, ou remova o app das setup policies em uso. Os dados da organização são tratados conforme a Política de Privacidade.