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

# YouTube

> Conecte o YouTube à Tess para encontrar vídeos, dados de canal e contexto de conteúdo no chat e nos agentes.

O conector do **YouTube** integra a Tess ao YouTube. Depois de conectado, a IA pode ajudar a encontrar vídeos e informações de canal e transformar esse contexto em resumos úteis dentro de chats e agentes.

O conector **YouTube** 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 aos dados do YouTube que você precisa.
  * Permissão para autorizar escopos OAuth relacionados ao YouTube.
</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/youtube/01-connect-panel.png" alt="PRINT: (Painel de Conectores com YouTube em destaque e o botão Connect visível)" />
    </Frame>
  </Step>

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

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

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

## O que você pode fazer

* **Buscar vídeos e canais** relevantes para um tema
* **Obter metadados de vídeos**, como títulos, descrições e estatísticas básicas quando disponíveis
* **Apoiar research de conteúdo** para marketing, educação e produto
* **Resumir achados** em briefs ou recomendações de próximos passos
* **Manter a pesquisa na Tess** em vez de trocar de abas

## Exemplos de prompt

> 1. Encontre os 5 vídeos mais relevantes no YouTube sobre agentes de IA para enterprise e resuma cada um.
> 2. Quais são os uploads mais recentes do canal da nossa marca?
> 3. Crie um brief curto a partir de vídeos sobre automação HubSpot para times de vendas.
> 4. Compare os principais resultados de 'automação Google Sheets' e liste dicas comuns.

## Boas práticas

* Seja específico sobre tema, idioma e recência.
* Peça fontes/títulos na resposta quando for reutilizar a pesquisa.
* Em agentes, deixe claro se o YouTube é para research, monitoramento de canal ou briefs.

## Troubleshooting

<AccordionGroup>
  <Accordion icon="circle-question" title="A autorização falha">
    Reconecte com a conta Google que possui ou acessa os dados do YouTube necessários.
  </Accordion>

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

  <Accordion icon="circle-question" title="Resultados limitados">
    Alguns dados de canal ou conteúdo privado podem ficar indisponíveis conforme as permissões da conta.
  </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>