> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://ajuda.teamculture.com.br/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Notificações da TeamCulture no Google Chat

Guia de instalação para administradores

Com esta integração, cada colaborador passa a receber a pesquisa de engajamento como uma **mensagem direta no Google Chat**, com um botão que abre a pesquisa na plataforma TeamCulture. O e-mail continua funcionando normalmente, em paralelo. O Chat é um canal a mais, no lugar onde o time já trabalha.

A instalação é feita uma única vez e leva cerca de 15 minutos.

**Neste artigo:**
* [Antes de começar](#3-antes-de-comecar)
* [Etapa 1: Liberar a permissão na TeamCulture](#3-etapa-1-liberar-a-permissao-na-teamculture)
* [Etapa 2: Conectar o Google Workspace na TeamCulture](#3-etapa-2-conectar-o-google-workspace-na-teamculture)
* [Etapa 3: Instalar o aplicativo no Google Workspace](#3-etapa-3-instalar-o-aplicativo-no-google-workspace)
* [Etapa 4: Validar a instalação](#3-etapa-4-validar-a-instalacao)
* [Comandos disponíveis para o colaborador](#3-comandos-disponiveis-para-o-colaborador)
* [Privacidade: o que dizer ao time](#3-privacidade-o-que-dizer-ao-time)
* [Solução de problemas](#3-solucao-de-problemas)
* [Como desativar a integração](#3-como-desativar-a-integracao)

### Antes de começar

| Requisito | Por quê |
| ---- | ---- |
| Acesso de **administrador do Google Workspace** (super admin) | Só um super admin pode autorizar o domínio e instalar o aplicativo para os usuários |
| Acesso de **administrador na TeamCulture**, com permissão no módulo Configurações | Necessário para abrir a tela de Integrações e conectar o workspace |
| **Google Chat ativo** no seu Google Workspace | O aplicativo é entregue dentro do Chat |
| **O e-mail da pessoa na TeamCulture deve ser igual ao e-mail no Google Workspace** | É a única informação usada para localizar cada pessoa e entregar a mensagem |

> **Sobre o e-mail:** este é o ponto que mais causa falha silenciosa. Quem estiver cadastrado na TeamCulture com um e-mail diferente do e-mail corporativo do Google **não receberá** a notificação no Chat: continuará recebendo apenas por e-mail. Vale conferir a base antes de começar.

#### As três etapas

| Etapa | Onde | O que acontece |
| ---- | ---- | ---- |
| **1** | TeamCulture > Permissões | Liberar quem pode conectar a integração |
| **2** | TeamCulture > Integrações | Conectar o domínio do Google Workspace |
| **3** | Google Workspace Marketplace | Instalar o aplicativo para os colaboradores |

As etapas 2 e 3 são complementares: a etapa 2 autoriza a TeamCulture a localizar as pessoas pelo e-mail; a etapa 3 coloca o aplicativo no Chat de cada uma. **Sem as duas, a notificação não chega.**

### Etapa 1: Liberar a permissão na TeamCulture

Se o botão de conectar não aparecer para você na Etapa 2, é porque o seu grupo de permissionamento ainda não tem essa permissão liberada.

1. Acesse **Configurações > Permissões**
2. Em **Gestão de permissionamento**, selecione o módulo **Configurações**
3. Abra a seção **Integrações**
4. Ative **Google Chat - Conectar** e **Google Chat - Remover** para o grupo de administração

As permissões `Google Chat - Conectar` e `Google Chat - Remover` ficam logo abaixo das permissões equivalentes do Slack, na mesma seção.

### Etapa 2: Conectar o Google Workspace na TeamCulture

> ⚠️ Faça esta etapa **logado no navegador com a conta de administrador do Google Workspace**. A autorização é concedida em nome do domínio inteiro, não da sua conta pessoal.

#### 2.1 Abra a tela de integrações

Acesse **Configurações > Conta > Integrações**. Na seção **Comunicação**, localize o **Google Chat** e clique em **Ir para detalhes**.

#### 2.2 Adicione o aplicativo

Na tela de configuração da integração, clique em **Adicionar ao Google Chat**.

#### 2.3 Autorize o acesso

O Google abrirá a tela de consentimento. O aplicativo **Axel da TeamCulture** solicita uma única permissão: **ver informações sobre usuários no seu domínio**. Clique em **Permitir**.

**O que essa permissão faz, e o que ela não faz:**

- ✅ Permite **apenas leitura** do diretório de usuários, para casar o e-mail corporativo de cada pessoa com o cadastro na TeamCulture
- ❌ **Não** dá acesso ao conteúdo de conversas do Chat
- ❌ **Não** permite enviar mensagens em nome de ninguém
- ❌ **Não** acessa e-mails, arquivos, agenda ou qualquer outro dado do Workspace

#### 2.4 Confirme a conexão

Ao voltar para a plataforma, você verá a mensagem **"Integração realizada com sucesso"** e o domínio conectado listado no card.

O ícone de lixeira ao lado do domínio remove a conexão a qualquer momento.

### Etapa 3: Instalar o aplicativo no Google Workspace

Agora o aplicativo precisa ser instalado no Chat dos colaboradores. Isso é feito pelo Google Workspace Marketplace, com a conta de super admin.

#### 3.1 Abra a página do aplicativo

Acesse diretamente:

https://workspace.google.com/marketplace/app/appname/248082335192

Ou busque por **Axel** no Marketplace, com o filtro **Compatível com Chat** ativo.

#### 3.2 Escolha "Instalação do administrador"

Na página do **Axel da TeamCulture**, clique em **Instalação do administrador**.

> Use **Instalação do administrador**, não "Adicionar ao espaço". A instalação de administrador é o que coloca o aplicativo no Chat de todos os colaboradores escolhidos, sem que cada um precise instalar por conta própria.

#### 3.3 Aceite os termos e escolha o alcance

Na **Etapa 1 de 2**, marque o aceite dos Termos de Serviço e escolha para quem o aplicativo será instalado automaticamente.

**Opção A: Todos na sua organização**

Marque **Todos na sua organização** e clique em **FINALIZAR**.

**Opção B: Grupos ou unidades organizacionais específicos**

Marque **Certos grupos ou unidades organizacionais** e clique em **AVANÇAR**.

Na **Etapa 2 de 2**, selecione os grupos ou as unidades organizacionais e clique em **CONCLUIR**.

> **Recomendação:** comece por uma unidade organizacional piloto: um time pequeno, de preferência com pessoas que possam dar retorno. Valide o recebimento com uma pesquisa real e só depois amplie para toda a organização. A ampliação é feita voltando a esta mesma tela.

### Etapa 4: Validar a instalação

#### 4.1 O aplicativo aparece no Chat

Após a instalação, o **Axel da TeamCulture** passa a aparecer para os colaboradores na busca do Google Chat e na seção **Apps** da barra lateral.

> A propagação para todos os usuários pode levar **até 24 horas**. Se o aplicativo não aparecer imediatamente, aguarde antes de abrir um chamado.

#### 4.2 A mensagem de boas-vindas

Quando a pessoa abre a conversa com o aplicativo pela primeira vez, ela recebe uma mensagem explicando o que vai acontecer e quais comandos existem.

#### 4.3 A notificação da pesquisa

No dia do disparo, cada pessoa recebe a mensagem com o botão **Responder pesquisa**, que abre a pesquisa na plataforma TeamCulture.

### Comandos disponíveis para o colaborador

O colaborador pode enviar estes comandos na conversa com o aplicativo:

| Comando | O que faz |
| ---- | ---- |
| `/help` | Mostra o que o aplicativo faz e lista os comandos |
| `/notifications` | Alterna o envio de pesquisas por este canal |
| `/notifications on` | Liga o envio de pesquisas no Chat |
| `/notifications off` | Desliga o envio de pesquisas no Chat |

> **Importante:** desligar as notificações no Chat **não** exclui a pessoa da pesquisa. Ela continua recebendo o convite por e-mail e sua participação segue contando normalmente.

### Privacidade: o que dizer ao time

Três pontos costumam responder à maior parte das dúvidas:

1. **As respostas continuam confidenciais.** O botão da mensagem abre a pesquisa na plataforma TeamCulture, pelo mesmo link enviado por e-mail. Cada pessoa responde com o próprio acesso, e as respostas viram indicadores agregados, nunca respostas individuais identificadas.
2. **O aplicativo não lê conversas.** Ele não tem acesso ao conteúdo do Chat de ninguém. Ele apenas envia a notificação na conversa individual.
3. **A única informação usada é o e-mail corporativo.** Sem nomes, fotos ou dados de organograma.

### Solução de problemas

| Sintoma | Causa provável | O que fazer |
| ---- | ---- | ---- |
| O botão **Adicionar ao Google Chat** não aparece na plataforma | Permissão não liberada para o seu grupo | Refaça a **Etapa 1** |
| A tela de consentimento do Google recusa a autorização | Você não está logado com a conta de super admin do Workspace | Saia da conta e repita a **Etapa 2** com a conta de administrador |
| O aplicativo não aparece no Chat de ninguém | Instalação de administrador não concluída, ou propagação em andamento | Confirme a **Etapa 3** e aguarde até 24 h |
| O aplicativo aparece para uns e não para outros | A instalação foi feita para grupos/UOs específicos | Volte à **Etapa 3** e amplie o alcance |
| A pessoa não recebe a notificação da pesquisa, mas recebe por e-mail | E-mail na TeamCulture diferente do e-mail no Google Workspace | Corrija o e-mail no cadastro da pessoa na TeamCulture |
| O aplicativo responde que não reconhece a conta | Mesmo caso acima: o e-mail do Chat não foi encontrado no cadastro | Corrija o e-mail no cadastro e peça para a pessoa enviar `/help` novamente |
| A pessoa parou de receber no Chat de um dia para o outro | Ela enviou `/notifications off` | Peça para enviar `/notifications on` |

### Como desativar a integração

| Onde | Como | Efeito |
| ---- | ---- | ---- |
| **TeamCulture** | Configurações > Conta > Integrações > Google Chat > ícone de lixeira ao lado do domínio | A plataforma para de enviar notificações pelo Chat |
| **Google Workspace** | Marketplace > página do aplicativo > **Desinstalar** | O aplicativo é removido do Chat dos colaboradores |

Em ambos os casos, o envio por e-mail continua funcionando normalmente. *Em caso de dúvida, fale com o time de Customer Success da TeamCulture.*