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

# Notion

> Conecte o Notion à Tess para encontrar páginas, databases e conhecimento no chat e nos agentes.

O conector do **Notion** integra a Tess ao Notion. Depois de conectado, a IA pode buscar páginas e databases, resumir conhecimento e apoiar fluxos de documentação dentro de chats e agentes.

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

## Pré-requisitos

<Info>
  * Conta Notion com acesso às páginas/databases que você precisa.
  * Permissão para autorizar a integração do Notion nesses workspaces.
</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/notion/01-connect-panel.png" alt="PRINT: (Painel de Conectores com Notion em destaque e o botão Connect visível)" />
    </Frame>
  </Step>

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

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/tess-dfe1edf0/images/connectors/notion/02-oauth-consent.png" alt="PRINT: (Tela de autorização / consentimento do provedor para Notion)" />
    </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, **Notion** deve aparecer em **Connected**, pronto para chats e agentes.

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

## O que você pode fazer

* **Buscar páginas e databases** no conteúdo compartilhado do Notion
* **Resumir docs e wikis** em briefs acionáveis
* **Criar ou atualizar páginas** quando houver permissão de escrita
* **Apoiar rotinas de conhecimento** para produto, ops e suporte
* **Manter a documentação interna utilizável dentro da Tess**

## Exemplos de prompt

> 1. Encontre o runbook de onboarding no Notion e resuma o checklist da primeira semana.
> 2. O que mudou recentemente na database Product Specs?
> 3. Crie uma página de meeting notes do sync de hoje com action items.
> 4. Pegue as FAQs de billing e reescreva como um brief interno curto.

## Boas práticas

* Informe nomes de página/database bem distintivos.
* Peça confirmação antes de criar páginas em espaços compartilhados.
* Em agentes, defina se o Notion é para recuperação, resumo ou escrita.

## Troubleshooting

<AccordionGroup>
  <Accordion icon="circle-question" title="Páginas faltando após conectar">
    No Notion, confirme que a integração recebeu acesso às páginas/databases relevantes.
  </Accordion>

  <Accordion icon="circle-question" title="401 / conexão caiu">
    Reconecte o Notion em Conectores e selecione novamente as páginas acessíveis à integração.
  </Accordion>

  <Accordion icon="circle-question" title="Não consigo editar uma página">
    A conta conectada ou o compartilhamento da integração pode ser somente leitura.
  </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>