> For the complete documentation index, see [llms.txt](https://help.hyperflow.global/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.hyperflow.global/docs/desk-hyperflow/copiloto.md).

# Copiloto

Gerencie os atalhos inteligentes dos atendimentos

O **Copiloto** permite que você crie **atalhos de inteligência artificial (IA)** para os seus atendentes. Cada atalho, chamado de **ação**, aparece como um botão pequeno (um **chip**) logo acima do campo de mensagem do atendimento. O atendente clica, e a IA corrige o texto que ele está escrevendo, resume a conversa, registra uma observação para a equipe ou responde uma dúvida, sem sair da conversa.

{% hint style="info" %}
Nada é enviado ao cliente sem o atendente decidir. A IA sempre entrega o resultado para o atendente revisar antes.
{% endhint %}

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FHa2pXOO3ShlUKV12otz9%2Fimage.png?alt=media&amp;token=40cc13c0-44df-43d1-9707-d1dacadd89e5" alt=""><figcaption><p>Imagem 1 - Tela de atendimento com a faixa de atalhos do Copiloto acima do campo de mensagem</p></figcaption></figure>

***

### 🧭 Como acessar

1. No menu lateral, abra a seção **Inteligência Artificial**.
2. Clique em **Copiloto**.
3. Você será direcionado para a tela do Copiloto, onde ficam todas as ações da sua conta.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2F7QPWVzmAriyvnd57IPVA%2Fimage.png?alt=media&amp;token=e31f3aad-6ecd-4270-b8be-66320895773d" alt=""><figcaption><p>Imagem 2 - Menu lateral com a seção Inteligência Artificial aberta e o item Copiloto destacado</p></figcaption></figure>

{% hint style="warning" %}
**Antes de usar este recurso:**

1. **O que precisa existir:** o **Assistente Inteligente** precisa estar contratado na sua conta. O Copiloto usa os créditos dele.
2. **Onde contratar:** na própria tela do Copiloto. Ao clicar em **Nova ação** (ou em **Criar primeira ação**) sem o Assistente Inteligente ativo, a plataforma abre a janela de contratação. Também há o botão **Contratar Assistente Inteligente** na tela.
3. **Como voltar para concluir:** depois de contratar, a plataforma já abre o formulário da ação que você estava criando.

Você também precisa ter permissão no seu perfil para ver a tela, criar, editar e remover ações. Sem essas permissões, os botões correspondentes ficam desabilitados ou não aparecem.
{% endhint %}

***

### 🖥️ Conhecendo a tela

#### 1️⃣ Primeiro acesso (tela sem ações)

Quando ainda não existe nenhuma ação, você vê uma tela de boas-vindas.

* **Chamada principal:** "Atalhos de IA a um clique do atendente", com uma explicação rápida do que o Copiloto faz.
* **Botão Criar primeira ação:** abre o formulário. Abaixo dele, uma dica avisa que você começa por um modelo pronto e ajusta o que quiser.
* **Exemplo visual:** uma conversa de exemplo mostrando um texto corrigido pela IA, com os botões **Desfazer** e **Aplicar**.
* **O que uma ação pode fazer:** quatro cartões, um para cada tipo de ação, com os nomes de alguns modelos prontos de cada tipo.
* **Contratação e cobrança:** um quadro com três colunas explicando o que é preciso ter, como funciona a cobrança e como definir um teto de consumo (veja a seção **Limites de consumo**, mais abaixo).

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FvzDE7qQ3IYJ0VE4eMaC5%2Fimage.png?alt=media&amp;token=3a91c6c2-0fca-481a-a0b2-0b7df2ac7d96" alt=""><figcaption><p>Imagem 2 - Os quatro tipos de ações disponíveis</p></figcaption></figure>

**🧩 Os quatro tipos de ação**

| Tipo                    | O que acontece quando o atendente clica                                                                          |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------- |
| **Reescrever o input**  | Devolve o texto corrigido para o campo de mensagem. O atendente vê a diferença e decide se aplica.               |
| **Resultado em painel** | Mostra o resultado em um painel somente de leitura, com botões para copiar e aplicar no campo de mensagem.       |
| **Comentário interno**  | Gera um comentário que o atendente revisa e salva na linha do tempo da conversa. O cliente nunca vê.             |
| **Mini-chat**           | Abre uma pequena conversa de apoio com a IA, com histórico próprio e perguntas prontas. Nada vai para o cliente. |

#### 2️⃣ Lista de ações

Depois de criar a primeira ação, a tela passa a mostrar a lista.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FQDvqIhVHcqANzpWrv7Pf%2Fimage.png?alt=media&amp;token=538f4134-510c-4757-a069-917478ca9b4c" alt=""><figcaption><p>Imagem 3 - Tela do Copiloto com a lista de ações, o cabeçalho e os botões no canto superior direito</p></figcaption></figure>

**🔝 Cabeçalho**

No topo você vê o título **Copiloto** e a frase "Crie atalhos de IA que o atendente aciona no rodapé do chat." À direita ficam os botões:

* **Como funciona:** reabre o painel de três passos, caso você o tenha ocultado. Só aparece quando o painel está oculto.
* **Limites:** abre a janela de limites de consumo.
* **Reordenar:** define a ordem dos atalhos na tela de atendimento. Só aparece quando há ações e você tem permissão de edição.
* **Nova ação:** abre o formulário para criar uma ação. Só aparece com permissão de criação.

**⚠️ Aviso de contratação**

Se o Assistente Inteligente não estiver contratado, aparece uma faixa amarela no topo da lista explicando que as ações só vão funcionar depois da contratação, com o botão **Contratar Assistente Inteligente**.

**💡 Painel "Como funciona"**

Um painel com os três passos do recurso: **1. Você cria a ação**, **2. Ela vira um chip no chat** e **3. O atendente clica e recebe o resultado**. Para ocultá-lo, clique no **X** no canto. Para vê-lo de novo, clique em **Como funciona** no cabeçalho.

**📋 Tabela de ações**

Use o campo de busca acima da tabela para encontrar uma ação pelo nome. A tabela tem as colunas:

| Coluna            | O que mostra                                                                       |
| ----------------- | ---------------------------------------------------------------------------------- |
| **Nome**          | Ícone, nome e descrição da ação. Clique no título da coluna para ordenar.          |
| **Tipo**          | Um dos quatro tipos de ação.                                                       |
| **Departamentos** | Os departamentos que podem usar a ação. Aparece **Todos** quando não há restrição. |
| **Status**        | **Ativa** (verde) ou **Inativa**.                                                  |
| **Ações**         | Menu com três pontinhos, com as opções **Editar** e **Remover**.                   |

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FvXBDEt2ek0Kt2af56hQx%2Fimage.png?alt=media&amp;token=9cfd2bef-9e74-4dd0-ab83-01720abd82d8" alt=""><figcaption><p>Imagem 4 - Tabela de ações com o menu dos três pontinhos aberto mostrando Editar e Remover</p></figcaption></figure>

***

### 🛠️ Criando e editando ações

#### 1️⃣ Criar uma nova ação

**🎯 Propósito**

Cadastrar um atalho de IA novo para os atendentes.

**✅ Como fazer na tela**

1. Na tela do Copiloto, clique em **Nova ação** (ou em **Criar primeira ação**, se a lista estiver vazia).
2. Se o Assistente Inteligente não estiver contratado, a janela de contratação abre primeiro. Conclua a contratação para seguir.
3. O formulário abre em uma janela com um passo a passo. À esquerda ficam as etapas e, na parte de baixo, os botões **Cancelar**, **Voltar** e **Próximo**.
4. Percorra as seis etapas descritas abaixo: **Modelo**, **Básico**, **Instrução**, **Ferramentas**, **Acesso** e **Revisar**.
5. Na última etapa, clique em **Salvar**.

**📌 Resultado esperado**

Uma mensagem **Ação criada com sucesso** aparece, a janela fecha e a nova ação entra na lista. Se algo falhar, aparece **Não foi possível salvar a ação**.

{% hint style="info" %}
Ao criar, você avança uma etapa por vez. Só é possível ir para a etapa seguinte depois de preencher o que é obrigatório na atual. Ao **editar** uma ação existente, a etapa **Modelo** não aparece, todas as outras ficam liberadas e o botão **Salvar** está disponível em qualquer etapa.
{% endhint %}

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FnrwZCIHc9f0StnE53agO%2Fimage.png?alt=media&amp;token=24873fdb-b65f-45e0-b67f-061604e46933" alt=""><figcaption><p>Imagem 5 - Janela de criação da ação com a lista de etapas à esquerda e os botões Cancelar, Voltar e Próximo no rodapé</p></figcaption></figure>

#### 2️⃣ Etapa Modelo

Aqui você escolhe um ponto de partida. A tela mostra o texto "Começar por um modelo" e os modelos prontos agrupados por tipo. Um modelo preenche nome, ícone, tipo e instrução, e tudo pode ser ajustado nas próximas etapas.

| Tipo                    | Modelos prontos                                                                                                     |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------- |
| **Reescrever o input**  | **Corrigir ortografia**, **Tom mais formal**, **Tom mais cordial**, **Encurtar mensagem**, **Traduzir para inglês** |
| **Resultado em painel** | **Resumir conversa**, **Sugerir resposta**, **Sentimento e risco**, **Próximos passos**                             |
| **Comentário interno**  | **Insight do atendimento**, **Nota de transferência**                                                               |
| **Mini-chat**           | **Tira-dúvidas** (já vem com três perguntas prontas)                                                                |

Para criar sem modelo, clique em **Começar do zero**. Se você trocar de modelo depois de já ter preenchido algo, o novo modelo substitui o que foi preenchido, e a tela avisa isso.

#### 3️⃣ Etapa Básico

Define a identidade da ação e como ela se comporta.

| Campo                                   | O que preencher                                                                                                                                                                                                                                                                                      |
| --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Ícone e cor**                         | Clique no ícone para abrir a lista (com campo **Buscar ícone**, agrupada em Escrita, Notas e resumos, Conversa, Pesquisa e Operação) e escolha também uma cor.                                                                                                                                       |
| **Nome**                                | Obrigatório, até 40 caracteres. É o texto que aparece no chip. Se ficar vazio, a tela mostra **Informe um nome**.                                                                                                                                                                                    |
| **Descrição**                           | Opcional, até 120 caracteres. Vira a dica que aparece quando o atendente passa o mouse sobre o chip.                                                                                                                                                                                                 |
| **Tipo**                                | Escolha um dos quatro tipos de ação. Abaixo dos cartões há uma explicação do que o tipo escolhido faz.                                                                                                                                                                                               |
| **Aplicar direto no campo de mensagem** | Só aparece no tipo **Reescrever o input**. Desmarcado, o atendente vê a diferença e escolhe **Aplicar**. Marcado, o texto é substituído na hora e ele tem alguns segundos para desfazer.                                                                                                             |
| **Tamanho do modelo**                   | **Lite** (rápido e econômico, ideal para corrigir, reescrever e resumir), **Standard** (equilíbrio entre qualidade e custo) ou **Pro** (máxima qualidade para tarefas que exigem mais raciocínio). Cada uso consome créditos de acordo com o tamanho escolhido. A opção **Lite** já vem selecionada. |

Na parte de baixo você encontra a **Prévia no chat**, que mostra como o chip vai aparecer, e o quadro **O que o atendente vai ver**, que explica em poucas linhas o que acontece quando ele clica.

{% hint style="warning" %}
O **tipo não pode ser mudado depois que a ação é criada**, porque ele define como o resultado chega ao atendente. Para outro comportamento, crie uma nova ação.
{% endhint %}

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FrwyPQSOYrwaGSs29KlPd%2Fimage.png?alt=media&amp;token=428331fc-f5e5-40d8-a471-21556c94d525" alt=""><figcaption><p>Imagem 6 - Etapa Básico com ícone, nome, descrição, tipos, tamanho do modelo e prévia do chip</p></figcaption></figure>

#### 4️⃣ Etapa Instrução

Esta etapa tem duas colunas.

**✍️ Instrução para o modelo (coluna da esquerda)**

Escreva aqui o que a IA deve fazer, por exemplo "Você corrige a ortografia de mensagens de atendimento…". A instrução é obrigatória. Se ficar vazia, a tela mostra **Informe a instrução para o modelo**. Se você começou por um modelo pronto, a instrução já vem preenchida.

Um aviso lembra que o conteúdo do rascunho e do histórico é tratado como informação, nunca como ordem para a IA.

**📥 O que o modelo recebe (coluna da direita)**

Marque o que a IA pode ler para fazer o trabalho:

| Opção                     | O que a IA recebe                                                                                          |
| ------------------------- | ---------------------------------------------------------------------------------------------------------- |
| **Rascunho**              | O texto que o atendente já digitou no campo de mensagem.                                                   |
| **Histórico da conversa** | As mensagens da conversa, somente em texto. Áudios e imagens entram apenas como marcação, sem transcrição. |
| **Notas internas**        | As anotações do atendimento e os insights já salvos na linha do tempo. Só a equipe vê.                     |
| **Dados do contato**      | O cadastro do contato: nome, telefone, e-mail, etiquetas e informações adicionais.                         |

Alguns bloqueios existem de propósito:

* No tipo **Mini-chat**, a opção **Rascunho** fica desabilitada, porque o mini-chat lê o que o atendente digita nele, não o campo de mensagem.
* No tipo **Reescrever o input**, **Notas internas** fica desabilitada, porque o resultado vai para o cliente e as notas nunca podem chegar a ele.
* Ainda no **Reescrever o input**, se você marcar **Histórico da conversa**, aparece um alerta explicando que o texto do próprio cliente passaria a influenciar a IA. Prefira deixar apenas o **Rascunho**.

Ao marcar **Histórico da conversa** ou **Notas internas**, aparecem dois campos:

| Campo                                 | O que preencher                                                                                      |
| ------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| **Mensagens do histórico**            | Quantas mensagens recentes a IA lê. O máximo é 100. O padrão é 20.                                   |
| **Limite de caracteres do histórico** | Tamanho máximo do texto lido. As mensagens mais antigas são descartadas primeiro. O padrão é 12.000. |

O quadro **Por que isso importa** lembra que quanto menos informação você enviar, mais rápida e barata é a resposta, e que textos do cliente podem conter instruções disfarçadas.

**💬 Atalhos do mini-chat (só no tipo Mini-chat)**

Abaixo das duas colunas, aparecem os atalhos do mini-chat. Eles são botões que surgem quando a conversa com a IA está vazia.

1. Clique em **Adicionar atalho**.
2. Preencha **Título do botão** (até 40 caracteres), **Descrição (opcional)** (até 80 caracteres) e **Prompt enviado**, que é a mensagem que a IA realmente recebe.
3. Para apagar um atalho, clique no ícone de lixeira dele.

O atendente enxerga apenas o título e a descrição. O texto do campo **Prompt enviado** nunca aparece para ele, por isso título e mensagem não precisam ser iguais.

{% hint style="info" %}
Se você trocar o tipo da ação e já tiver atalhos cadastrados, a tela avisa que os atalhos só são salvos no tipo **Mini-chat**.
{% endhint %}

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FraFRD5jjq9aUNIIJeL3X%2Fimage.png?alt=media&amp;token=133030b8-2fb5-4169-b1d7-5b8c0b322b74" alt=""><figcaption><p>Imagem 7 - Etapa Instrução com o editor de instrução à esquerda e as opções de contexto à direita</p></figcaption></figure>

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FsDXih7aPKioocGXlJMeu%2Fimage.png?alt=media&amp;token=8f50f6dc-98bd-4377-bf6b-86d17c7f6db3" alt=""><figcaption><p>Imagem 8 - Seção Atalhos do mini-chat com um atalho preenchido</p></figcaption></figure>

#### 5️⃣ Etapa Ferramentas

Ferramentas deixam a ação consultar dados, além do que já foi enviado pelas opções da etapa anterior. Habilite apenas as que a ação realmente usa, pois cada ferramenta aumenta o consumo de cada execução.

A etapa tem duas abas, as mesmas usadas na edição de um agente, em **Inteligência Artificial > Agentes**:

* **Ferramentas:** lista de ferramentas disponíveis para marcar.
* **MCPs:** servidores externos de ferramentas, que você pode adicionar. Enquanto o formulário de um servidor estiver aberto, os botões do rodapé ficam bloqueados para você não perder o que digitou.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FcdVVQFsv3Cus9OJ2Ke46%2Fimage.png?alt=media&amp;token=98586301-8874-47cb-8024-8e2aedbabc20" alt=""><figcaption><p>Imagem 8 - Etapa Ferramentas com as abas Ferramentas e MCPs</p></figcaption></figure>

#### 6️⃣ Etapa Acesso

Define quem vê o chip na tela de atendimento.

| Campo             | O que preencher                                                                                             |
| ----------------- | ----------------------------------------------------------------------------------------------------------- |
| **Departamentos** | Escolha um ou mais departamentos. Vazio significa todos.                                                    |
| **Atendentes**    | Escolha um ou mais atendentes. Vazio significa todos.                                                       |
| **Ação ativa**    | Liga ou desliga a ação. Desligada, ela some da tela de atendimento, mas continua na lista como **Inativa**. |

Quando você preenche departamentos e atendentes ao mesmo tempo, o atendente precisa estar em um dos departamentos e também na lista de atendentes para ver o chip. Perfis sem restrição de departamento, como administradores, não são barrados pela lista de departamentos, mas continuam sujeitos à lista de atendentes.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FJvV63exDxaZ4Q8ZDaVZu%2Fimage.png?alt=media&amp;token=749ba2c6-e17c-476f-b9de-9db781d88e6a" alt=""><figcaption><p>Imagem 9 - Etapa Acesso com os campos Departamentos, Atendentes e o botão Ação ativa</p></figcaption></figure>

#### 7️⃣ Etapa Revisar

A última etapa, **Revise antes de salvar**, mostra um resumo dividido em **Básico**, **Instrução e contexto**, **Acesso** e **Ferramentas**. Cada bloco tem o botão **Editar**, que leva direto à etapa correspondente.

Também aparece o resumo de como o resultado chega ao atendente e um lembrete de custo: cada uso da ação consome créditos do Assistente Inteligente, no preço do tamanho de modelo escolhido, e **criar e manter a ação não tem custo**.

Clique em **Salvar** para concluir.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FYl5xmHWf9ZeohvcTMqVJ%2Fimage.png?alt=media&amp;token=07e8ed7a-cd61-4976-aaa5-899e45265972" alt=""><figcaption><p>Imagem 10 - Etapa Revisar com o resumo e o botão Salvar</p></figcaption></figure>

#### 8️⃣ Editar uma ação existente

**🎯 Propósito**

Ajustar o nome, a instrução, o acesso ou qualquer outra configuração de uma ação já criada.

**✅ Como fazer na tela**

1. Na lista, clique nos três pontinhos da linha da ação.
2. Clique em **Editar**.
3. Navegue entre as etapas, faça as mudanças e clique em **Salvar**.

**📌 Resultado esperado**

Aparece **Ação atualizada com sucesso** e a lista reflete o que mudou. A tela de atendimento passa a usar a versão nova.

***

### 🔀 Reordenar e remover ações

#### 1️⃣ Reordenar

**🎯 Propósito**

Definir a ordem em que os chips aparecem na tela de atendimento.

**✅ Como fazer na tela**

1. Clique em **Reordenar** no cabeçalho.
2. Na janela, arraste as ações pela alça à esquerda de cada uma. A janela mostra todas as ações, na ordem atual dos chips.
3. Clique em **Salvar**.

**📌 Resultado esperado**

Aparece **Ordem atualizada com sucesso**, e os chips passam a aparecer na nova ordem.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FoFgK9Psip0d59ZFcqIbD%2Fimage.png?alt=media&amp;token=97b0920a-2243-4fcb-9110-b2f4c26580e0" alt=""><figcaption><p>Imagem 11 - Janela Reordenar com a lista de ações e as alças de arrastar</p></figcaption></figure>

#### 2️⃣ Remover

**🎯 Propósito**

Apagar uma ação que não será mais usada.

**✅ Como fazer na tela**

1. Clique nos três pontinhos da linha da ação e escolha **Remover**.
2. Leia a pergunta "Deseja realmente remover a ação…" e clique em **Remover**.

**📌 Resultado esperado**

Aparece **Ação removida com sucesso** e a ação some da lista e da tela de atendimento.

{% hint style="info" %}
Se quiser apenas pausar uma ação por um tempo, em vez de remover, edite a ação e desligue **Ação ativa** na etapa **Acesso**.
{% endhint %}

***

### 📊 Limites de consumo

#### 🎯 Propósito

Definir um teto de uso da IA, para que o consumo dos créditos do Assistente Inteligente não passe do que você planejou.

#### ✅ Como fazer na tela

1. Clique em **Limites** no cabeçalho (ou em **Configurar limites** no quadro de cobrança da tela inicial).
2. Preencha os campos:

| Campo                                          | O que preencher                                                                                                     |
| ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| **Janela**                                     | **Diária** ou **Mensal**. O contador zera à meia-noite, no horário de Brasília.                                     |
| **Tokens por atendente**                       | Quanto cada atendente pode consumir na janela. **0** significa sem limite.                                          |
| **Tokens do tenant**                           | Quanto a conta inteira pode consumir na janela. **0** significa sem limite.                                         |
| **Exceções por atendente**                     | Opcional. Clique em **Adicionar exceção**, escolha o atendente e o limite dele. Vale só para quem estiver na lista. |
| **Liberar se o contador estiver indisponível** | Quando ligado, uma falha técnica no contador não bloqueia o recurso. O consumo continua sendo cobrado do plano.     |

3. Clique em **Salvar**.

Um **token** é a unidade de consumo da IA, proporcional ao tamanho dos textos lidos e escritos.

Cada atendente só pode ter uma exceção. Se você deixar uma linha sem atendente ou repetir um atendente, a tela avisa e não deixa salvar.

#### 📌 Resultado esperado

Aparece **Limites atualizados com sucesso**. Quando um atendente (ou a conta) atinge o limite, os chips ficam desabilitados com o aviso **Limite de IA atingido** até o período virar.

{% hint style="info" %}
O limite é um controle interno entre os atendentes. O desconto no plano acontece de qualquer forma, inclusive para a execução que já estava em andamento quando o limite foi atingido.
{% endhint %}

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2Fbl7s9l96w5QcpopYj6Cj%2Fimage.png?alt=media&amp;token=4871b3af-eb75-4241-a1c2-ac430e5c160e" alt=""><figcaption><p>Imagem 12 - Janela Limites com janela, tokens por atendente, tokens do tenant e exceções</p></figcaption></figure>

***

### 💬 Como aparece na tela de atendimento

É aqui que o atendente usa o que você configurou. Os chips aparecem na tela de atendimento da Hyperflow Conversas, em uma faixa logo acima do campo de mensagem.

#### 1️⃣ Quem vê os chips

Um chip aparece para o atendente quando todas as condições abaixo são verdadeiras:

* A ação está **Ativa**.
* O atendente está na lista de **Atendentes** da ação (ou a lista está vazia).
* O departamento do atendente está na lista de **Departamentos** da ação (ou a lista está vazia).
* O atendente tem permissão para usar o Copiloto e a conversa é uma a que ele tem acesso.

Os chips seguem a ordem definida em **Reordenar**. Ao passar o mouse sobre um chip, aparece a **Descrição** que você cadastrou. Em telas pequenas, a faixa rola para o lado. Também é possível navegar entre os chips com as setas do teclado.

Se uma ação está em andamento, os demais chips ficam desabilitados até ela terminar, e o chip em uso mostra um indicador de carregamento. Se o limite de consumo foi atingido, todos ficam desabilitados com a dica **Limite de IA atingido**. Quando o consumo passa de 80% do limite, aparece o uso atual ao lado do resultado (por exemplo, "8,5k / 10k").

#### 2️⃣ Reescrever o input

O atendente escreve a mensagem no campo e clica no chip.

**✅ Como funciona na tela**

1. O chip mostra um indicador de carregamento enquanto a IA trabalha.
2. Abre um cartão acima do campo com o nome da ação e o texto sugerido. O texto original continua no campo, sem alteração.
3. O atendente escolhe uma opção:
   * **Ver alterações** (ou **Ocultar alterações**): destaca o que mudou em relação ao texto original.
   * **Tentar novamente**: gera outra versão.
   * **Aplicar**: coloca o texto sugerido no campo de mensagem, para ele ler e enviar quando quiser.
   * **Aplicar e enviar**: aplica e já envia a mensagem ao cliente.
   * **X**: fecha o cartão sem aplicar nada.

**📌 Se a opção "Aplicar direto no campo de mensagem" estiver marcada**

Não aparece o cartão de prévia. O texto do campo é substituído na hora, e surge uma barra com **Aplicado** e o botão **Desfazer**, que fica disponível por cerca de 20 segundos.

**📌 Se o campo de mensagem estiver vazio**

Em vez de recusar o clique, abre uma pequena caixa com o nome da ação, um campo **Digite uma mensagem** e o aviso **Este texto não é enviado ao cliente**. O atendente digita, clica em **Gerar** e o resultado segue o mesmo caminho acima. Assim ele não precisa escrever no campo que fica a um Enter de distância do cliente.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2Flg3wkY1dDgVNGz26tHWi%2Fcopiloto-1-reescrever-input.gif?alt=media&amp;token=deb287eb-4f54-4808-a531-e2be63e33793" alt=""><figcaption><p>Vídeo 1 - Corrigir ortografia ativo. </p></figcaption></figure>

#### 3️⃣ Resultado em painel

**✅ Como funciona na tela**

1. O atendente clica no chip. Um painel abre junto dele na hora e o texto vai aparecendo aos poucos, enquanto a IA gera (com a indicação **Carregando…**).
2. Quando termina, o painel mostra três botões em ícone:
   * **Copiar**: copia o texto.
   * **Aplicar**: coloca o texto no campo de mensagem.
   * **Tentar novamente**: gera de novo (fica desabilitado enquanto o texto está sendo gerado).
3. O **X** fecha o painel. Se fechar no meio da geração, os créditos já usados continuam contando para o limite, e o painel avisa isso.

Nada é escrito na conversa. O painel é só para leitura.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FISeu12IdJ0XNYdnOS4le%2Fcopiloto-2-resultado-em-painel.gif?alt=media&amp;token=9c771946-33cc-4479-ba60-8a28b1a054f9" alt=""><figcaption><p>Vídeo 2 - Resultado em painel ativo.</p></figcaption></figure>

#### 4️⃣ Comentário interno

**✅ Como funciona na tela**

1. O atendente clica no chip e a IA gera um comentário.
2. Um cartão mostra o comentário, com o aviso **Toda a equipe vê isto na timeline**.
3. O atendente pode:
   * **Editar**: mudar o texto (e voltar com **Preview** para conferir).
   * **Tentar novamente**: gerar outro.
   * **Salvar insight**: registrar o comentário na linha do tempo da conversa.

**📌 Resultado esperado**

Aparece **Insight salvo na conversa** e o comentário fica na linha do tempo, visível para toda a equipe. O cliente nunca vê.

{% hint style="warning" %}
Depois de salvo, o comentário não pode ser editado. Por isso a plataforma sempre pede a revisão antes de salvar.
{% endhint %}

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FaD40mtmB2VgBog2UZC9C%2Fcopiloto-3-comentario-interno.gif?alt=media&amp;token=656608b1-c518-4c0c-aad6-45d87398c2b4" alt=""><figcaption><p>Vídeo 3 - Opção do comentário/insight interno e seu funcionamento.</p></figcaption></figure>

#### 5️⃣ Mini-chat

**✅ Como funciona na tela**

1. O atendente clica no chip e abre uma pequena janela de conversa com a IA.
2. Com a conversa vazia, aparecem os atalhos que você cadastrou, sob o texto **Comece por aqui**. Cada um mostra o título e a descrição. O atendente clica em um deles, ou digita a própria pergunta no campo **Perguntar à IA…**.
3. A resposta vai aparecendo aos poucos. Em cada resposta há os botões **Copiar** e **Aplicar** (coloca o texto no campo de mensagem).
4. No topo da janela há botões para **Abrir** (mostra a conversa em um painel lateral, que reduz o espaço da conversa principal, e **Fechar** o devolve), **Nova conversa** (apaga o histórico e começa do zero), **Cancelar** (aparece durante a geração) e **Fechar**.

O histórico do mini-chat é guardado enquanto o atendente trabalha na mesma aba do navegador. Se ele fechar a janela ou visitar outra conversa e voltar, a conversa continua de onde parou.

Quando o atendente pede para a IA redigir uma resposta para o cliente, o texto é colocado no campo de mensagem e aparece o aviso **Texto colocado no campo de mensagem para você revisar.** Quando pede para registrar algo sobre o atendimento, abre o cartão de comentário interno, com o aviso **Comentário interno aberto para você revisar.** Em ambos os casos, nada é enviado nem salvo sem o atendente confirmar.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2Fs2YsORg4BD4ys1mplqL0%2Fcopiloto-4-mini-chat.gif?alt=media&amp;token=8d4b0135-a4a6-4cc3-b5b3-96a04b53312c" alt=""><figcaption><p>Vídeo 4 - Minichat (Tira dúvidas) ativo. </p></figcaption></figure>

***

### 💡 Dicas úteis

* **Comece pelos modelos prontos.** Eles já trazem instruções bem escritas. Ajuste o tom e as regras para o jeito de falar da sua empresa.
* **Envie só o necessário.** Quanto menos informação a ação receber (rascunho, histórico, notas, contato), mais rápida e barata ela fica.
* **Comece pelo tamanho Lite.** Ele resolve a maior parte das ações de corrigir, reescrever e resumir.
* **Use as exceções de limite** para dar mais folga a quem usa muito o recurso, como um supervisor, sem aumentar o limite de todos.
* **Nome curto.** O nome precisa caber no chip, e a **Descrição** serve para explicar o que ele faz.
* **Criar e manter ações não custa nada.** A cobrança acontece apenas a cada clique do atendente.

***

### 📝 Resumo

* O **Copiloto** (menu **Inteligência Artificial > Copiloto**) cria atalhos de IA que aparecem como chips acima do campo de mensagem do atendimento.
* Existem **quatro tipos** de ação: **Reescrever o input**, **Resultado em painel**, **Comentário interno** e **Mini-chat**. O tipo não muda depois de criado.
* A criação é um passo a passo de seis etapas: **Modelo**, **Básico**, **Instrução**, **Ferramentas**, **Acesso** e **Revisar**. Você pode começar por um dos 12 modelos prontos.
* Você escolhe **quem vê** cada chip (departamentos e atendentes) e define **limites de consumo** diário ou mensal, por atendente e para a conta.
* Para usar, é preciso ter o **Assistente Inteligente** contratado. Criar ações não custa nada, e a cobrança é por uso. O atendente sempre revisa o resultado antes de qualquer coisa ir para o cliente ou para a linha do tempo.
