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

# OpenAI — AI Assist

> Conecte o Attende à OpenAI e turbine o atendimento com sugestões de resposta, melhoria de texto e resumos automáticos — sem sair da conversa.

O AI Assist integra a inteligência da OpenAI diretamente na caixa de resposta do Attende. Com um clique, o atendente recebe uma sugestão de resposta, melhora o texto que já escreveu ou gera um resumo executivo da conversa — tudo em tempo real, dentro do fluxo normal de trabalho.

***

## Conectando a OpenAI

<Steps>
  <Step title="Acesse a integração">
    Vá para **Configurações → Integrações → OpenAI**.
  </Step>

  <Step title="Inicie a conexão">
    Clique em **Configurar** e depois em **Conectar**.
  </Step>

  <Step title="Insira sua chave API">
    Cole sua chave de API da OpenAI (começa com `sk-`). Se ainda não tem uma, acesse [platform.openai.com](https://platform.openai.com), vá em **API Keys** e crie uma nova. A chave é validada automaticamente ao salvar.
  </Step>

  <Step title="Salve">
    Clique em **Salvar**. A integração fica ativa imediatamente para toda a conta.
  </Step>
</Steps>

<Note>
  A chave API fica armazenada de forma criptografada no Attende. Nunca é exibida novamente após salvar — guarde uma cópia no seu gerenciador de senhas.
</Note>

***

## Como usar o AI Assist nas conversas

Com a integração ativa, o ícone de ✦ (sparkles) aparece na barra de ferramentas do editor de mensagens em qualquer conversa. Clique nele para abrir o menu de funções de IA.

Você também pode acessar via **Command Bar** — pressione `Ctrl+K` (Windows/Linux) ou `Cmd+K` (Mac) — e busque por **AI Assist**.

***

## Funções disponíveis

### Sugestão de resposta

O AI Assist analisa o histórico da conversa e gera uma sugestão de resposta completa, pronta para revisar e enviar.

* Para conversas de **chat**, a resposta é breve e conversacional.
* Para conversas de **e-mail**, inclui saudação, corpo e assinatura no formato adequado.
* A IA responde no **idioma do cliente** automaticamente.
* Se você tiver uma Base de Conhecimento configurada no Capitão, o AI Assist consulta ela antes de sugerir.

<Warning>
  A sugestão é um ponto de partida — não uma resposta final. Revise sempre antes de enviar. A IA pode não conhecer detalhes específicos do seu produto, políticas internas ou contexto que não está na conversa.
</Warning>

***

### Melhorar com IA

Escreva um rascunho da sua mensagem e use o AI Assist para aprimorá-lo. O texto melhora em gramática, pontuação, estrutura e tom — sem alterar o significado nem adicionar informações que você não colocou.

O menu oferece opções de tom para reescrever:

| Tom              | Como soa                              |
| ---------------- | ------------------------------------- |
| **Amigável**     | Caloroso, empático, acessível         |
| **Confiante**    | Assertivo, definitivo, com autoridade |
| **Direto**       | Objetivo, sem rodeios                 |
| **Casual**       | Descontraído, informal                |
| **Profissional** | Formal, polido, respeitoso            |

O texto original é preservado no editor — você pode aceitar, editar ou descartar a versão gerada.

***

### Resumir conversa

Para conversas longas, o AI Assist gera um resumo executivo e o insere automaticamente como uma **nota privada** — visível apenas para a equipe, não para o cliente.

O resumo segue uma estrutura padrão:

* **Intenção do cliente** — o que ele veio resolver (em até \~50 palavras)
* **Resumo da conversa** — os pontos principais, com termos importantes em negrito e código em backticks
* **Itens de ação** — tarefas que o atendente se comprometeu a fazer, em ordem de prioridade
* **Pontos de acompanhamento** — o que ainda precisa ser feito ou verificado

Seções sem conteúdo relevante são omitidas automaticamente.

<Tip>
  Use o resumo antes de transferir uma conversa para outro atendente ou equipe. O novo responsável entra no contexto em segundos, sem precisar ler todo o histórico.
</Tip>

***

## Desconectando a OpenAI

Para remover a integração:

1. Vá para **Configurações → Integrações → OpenAI**
2. Clique em **Desconectar**
3. Confirme no diálogo

Após desconectar, o ícone de AI Assist some do editor e as funções de IA ficam indisponíveis até uma nova conexão ser feita.

***

## Dúvidas comuns

<AccordionGroup>
  <Accordion title="A chave API tem custo?">
    Sim. O uso do AI Assist consome créditos da sua conta na OpenAI, cobrados diretamente por eles conforme o modelo e o volume de tokens usados. O Attende não cobra nada adicional pela integração — o custo é inteiramente com a OpenAI.
  </Accordion>

  <Accordion title="Qual modelo da OpenAI é usado?">
    O Attende utiliza os modelos mais recentes da OpenAI disponíveis via API. Não é necessário configurar o modelo manualmente.
  </Accordion>

  <Accordion title="A IA tem acesso ao histórico completo da conversa?">
    Sim. Para gerar sugestões e resumos, o AI Assist envia o histórico da conversa para a OpenAI. Considere sua política de privacidade de dados ao usar a integração com conversas que contenham informações sensíveis.
  </Accordion>

  <Accordion title="O AI Assist usa minha Base de Conhecimento do Capitão?">
    Sim, quando configurada. O AI Assist consulta sua Base de Conhecimento para embasar as sugestões de resposta antes de recorrer ao conhecimento geral do modelo.
  </Accordion>

  <Accordion title="O que acontece se a chave API ficar inválida?">
    O Attende monitora o status da integração. Se a chave expirar ou for revogada, o AI Assist para de funcionar e um aviso aparece na tela de integrações. Basta reconectar com uma chave válida.
  </Accordion>

  <Accordion title="Atendentes podem usar o AI Assist ou só administradores configuram?">
    Administradores configuram a integração uma vez. Depois de ativa, todos os atendentes da conta têm acesso às funções de IA nas conversas — sem configuração adicional por usuário.
  </Accordion>
</AccordionGroup>

***

Com o AI Assist ativo, seu time responde mais rápido, escreve melhor e nunca perde o fio de conversas longas. A IA trabalha junto com o atendente — não no lugar dele. Ponto.

<Note>
  **Outros artigos desta seção:** ▸ [Dashboard de apps](/integracoes/dashboard-apps) ▸ [Webhooks](/integracoes/webhooks) ▸ [Slack](/integracoes/slack)
</Note>