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

# Chaves e leitura de mídia da IA

> Cadastre as chaves dos provedores de IA e ligue a leitura de áudios, imagens e PDFs.

## Para que serve

Em **Ajustes › Inteligência artificial** você cadastra a chave de cada provedor de IA (**OpenAI**, **Groq**, **Gemini**, **Fish Audio**) e liga a **leitura de mídia** do Copiloto: transcrever áudios, descrever imagens e resumir PDFs que o cliente manda.

A chave serve ao Copiloto, aos Agentes e à IA do Voicer. Configure uma vez por provedor.

## Quem pode

**Dono e Admin** alteram. Os demais papéis só veem. Os itens **Agentes** e **IA do Voicer** dessa área dependem dos módulos liberados pela agência: quando faltam, a tela diz "Fale com a sua agência".

## Onde clicar

**Ajustes › Inteligência artificial**: **Copiloto**, **Agentes**, **IA do Voicer** e **Chaves e provedores**. A **Copiloto · leitura de mídia** abre pelo link dentro da página do Copiloto. Atalho: nos Agentes de IA, **Chaves e provedores ficam em Ajustes**. As chaves ficam guardadas por WhatsApp; escolha o WhatsApp no seletor.

## Passo a passo

**1. Abra Chaves e provedores**

Escolha o WhatsApp em **Selecione o WhatsApp**.

**2. Cole a chave**

No provedor, clique em **Adicionar**, em **Cole a chave** e salve. Aparece "Chave salva". Depois de salva, ela nunca é mostrada inteira de novo.

**3. Ligue a leitura de mídia**

Em **Copiloto · leitura de mídia**, ative por tipo: **Áudios (Transcrição)**, **Imagens (Descrição)** e **PDFs (Resumo)**. Escolha o **Provedor de IA** de cada um.

## O que acontece depois

Quando ativado, o conteúdo recebido é processado e o texto aparece junto da mensagem. Os Agentes usam as **Chaves da organização**, que valem para todas as caixas e têm prioridade sobre a chave da caixa. De uma chave só aparecem os 4 últimos caracteres.

## Erros comuns

* **Sem chave de API configurada para o provedor.** Adicione em **Chaves e provedores**; sem a chave, o provedor não aparece para escolher.
* **Essa chave não parece válida.** Confira e tente de novo.
* **Falha ao salvar chave** / **Falha ao remover a chave.**
* **Remover a chave** faz o Copiloto e os Agentes da caixa pararem até você adicionar outra.
* **Não deu para carregar as chaves** ou **a leitura de mídia.** Use **Tentar de novo**.
* **Falta a chave de busca.** A base de conhecimento do agente precisa de uma chave da OpenAI ou do Gemini.

## Próximo passo

* [Agentes de IA](https://docs.stchat.app/subcontas/agentes-de-ia.md)
* [Flows: visão geral](https://docs.stchat.app/subcontas/flows.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.