> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tess.im/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Sheets

> Conecte o Google Sheets à Tess para ler, analisar e atualizar planilhas no chat e nos agentes.

O conector do **Google Sheets** integra a Tess ao Google Sheets. Depois de conectado, a IA pode consultar dados de planilhas, ajudar a estruturar relatórios e apoiar atualizações operacionais dentro de chats e agentes.

O conector **Google Sheets** faz parte do ecossistema de [Connectors](/pt/connectors) da Tess e usa autenticação **OAuth** para conectores de Apps.

## Pré-requisitos

<Info>
  * Conta Google com acesso às planilhas que você precisa.
  * Permissão para autorizar escopos OAuth do Google Sheets.
</Info>

## Como conectar

<Tip>
  Em alguns conectores de Apps, a tela de consentimento OAuth pode exibir o nome de uma ponte de conexão de terceiros em vez da Tess. Isso é normal—revise as permissões solicitadas e continue se fizerem sentido para o uso.
</Tip>

<Steps>
  <Step title="Abra o painel de Conectores">
    No chat, clique no **+** ao lado da caixa de mensagem e selecione **Connectors**.
    Você também pode gerenciar conectores na edição do agente no Agent Studio.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/tess-dfe1edf0/images/connectors/google-sheets/01-connect-panel.png" alt="PRINT: (Painel de Conectores com Google Sheets em destaque e o botão Connect visível)" />
    </Frame>
  </Step>

  <Step title="Localize Google Sheets e clique em Connect">
    Em **Apps**, encontre **Google Sheets** e clique em **Connect** para iniciar a autenticação.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/tess-dfe1edf0/images/connectors/google-sheets/02-oauth-consent.png" alt="PRINT: (Tela de autorização / consentimento do provedor para Google Sheets)" />
    </Frame>
  </Step>

  <Step title="Autorize o acesso">
    Faça login na conta desejada e revise as permissões solicitadas antes de confirmar.
  </Step>

  <Step title="Confirme que está ativo">
    Ao voltar para a Tess, **Google Sheets** deve aparecer em **Connected**, pronto para chats e agentes.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/tess-dfe1edf0/images/connectors/google-sheets/03-connected.png" alt="PRINT: (Callback da Tess ou lista de Conectores mostrando Google Sheets como Connected com estado de sucesso)" />
    </Frame>
  </Step>
</Steps>

## O que você pode fazer

* **Ler dados de planilhas** em arquivos e abas acessíveis
* **Analisar métricas e tendências** para gerar resumos
* **Atualizar células ou acrescentar linhas** quando houver permissão de escrita
* **Apoiar reporting operacional** com dados vivos da planilha
* **Ajudar times a transformar tabelas em decisões** mais rápido

## Exemplos de prompt

> 1. Analise a planilha de leads e diga quais contatos não tiveram follow-up nos últimos 7 dias.
> 2. Leia a planilha de métricas mensais e gere um resumo executivo dos principais desvios.
> 3. Acrescente uma linha com o total de vendas de hoje na aba Fechamento Diário.
> 4. Quais colunas parecem incompletas no tracker de onboarding?

## Boas práticas

* Informe o nome da planilha ou contexto do link quando houver arquivos parecidos.
* Peça uma prévia antes de escritas em massa.
* Em agentes, defina se o Sheets é para análise, reporting ou entrada de dados.

## Troubleshooting

<AccordionGroup>
  <Accordion icon="circle-question" title="App bloqueado / erro de API">
    Reconecte e confirme que a conta Google pode autorizar o Sheets. Admins de Workspace podem precisar liberar o app.
  </Accordion>

  <Accordion icon="circle-question" title="401 / conexão caiu">
    Reconecte o Google Sheets em Conectores após mudanças de credencial ou política.
  </Accordion>

  <Accordion icon="circle-question" title="Não consigo editar a planilha">
    A conta conectada pode ser somente visualização. Use uma conta com acesso de edição.
  </Accordion>
</AccordionGroup>

<Note>
  A Tess age com as permissões da conta conectada. Ela não amplia acessos além do que essa conta já pode fazer.

  Conectores envolvem acesso a sistemas externos. Conecte apenas contas adequadas ao uso e revise as permissões com cuidado.
</Note>