> For the complete documentation index, see [llms.txt](https://help.curseduca.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.curseduca.com/conteudos/agentes-a.i./pre-vendas-a.i..md).

# Pré-Vendas A.I.

#### 🧩 O que é o Agente A.I. de Pré-Vendas

O **Agente A.I. de Pré-Vendas** é um agente inteligente especializado em realizar a **triagem e o primeiro contato com potenciais clientes**.\
Ele foi desenvolvido com um **prompt base focado em qualificação comercial**, permitindo que ele conduza conversas que ajudam a identificar o perfil, a necessidade e o interesse do lead — **antes mesmo de chegar ao time de vendas**.

#### ⚙️ Como funciona

Ele já vem com um **modelo de prompt especializado** preparado para lidar com o processo de **pré-venda**.

🔹 O agente já vem com parâmetros de linguagem e comportamento configurados para:

* Fazer a **triagem de leads**;
* Identificar o **nível de interesse e perfil do cliente**;
* Encaminhar leads qualificados para o time de vendas;
* Manter uma **conversa natural e consultiva**.

#### 🛠️ Como configurar o seu Agente de Pré-Vendas

Faça seu login no Curseduca e navegue até a seção Agente A.I., no painel administrativo, conforme a imagem:

<figure><img src="/files/cbFe9eMy8K5FPZAFUf6K" alt=""><figcaption><p>Home</p></figcaption></figure>

Em seguida clique em **'Pré-Vendas A.I.'**

<figure><img src="/files/tIxpsryjJnjmua3HXNZX" alt="" width="200"><figcaption><p>Home</p></figcaption></figure>

#### Dashboard - Primeira tela

Por padrão, a tela de dashboard é a primeira que será aberta neste Agente

<figure><img src="/files/KFFRKDLtivU7b1sKdzRe" alt="" width="537"><figcaption><p>Home > Pré-Vendas A.I. > Dashboard</p></figcaption></figure>

A guia “Dashboards” transforma todas as
&#x20;interações do Agente em gráficos simples de interpretar. Sendo possível acompanhar o uso, engajamento e qualidade sem precisar de planilhas ou consultas técnicas.

Sendo possível acompanhar: interações e avaliações.

<figure><img src="/files/SMTsQFgYFQdG96CDVwrq" alt=""><figcaption><p>Home > Pré-Vendas A.I. > Dashboard</p></figcaption></figure>

#### Histórico&#x20;

* A aba “Histórico” é o arquivo de todas as conversas realizadas com o Agente. Ela existe para que gestores possam rever atendimentos, entender dúvidas mais frequentes e acompanhar a qualidade das respostas – tudo em um só lugar.&#x20;
* Em poucos cliques você navega pelas interações, abre qualquer diálogo e usa essas informações para melhorar conteúdos ou ajustar o comportamento do seu agente.
* Você pode ver o assunto, local, o membro e a data. Clicando em 'ver conversa', você terá acesso a conversa na íntegra:&#x20;

<figure><img src="/files/HfMN3Yuo5bE7ACvUduPc" alt=""><figcaption><p>Home > Pré-Vendas A.I. > Histórico</p></figcaption></figure>

#### Aparência

Nesta seção você irá definir as informações básicas, a personalização geral e a personalização do widget:

<figure><img src="/files/w2krICoi2UITaQ08DjWN" alt=""><figcaption><p>Home > Pré-Vendas A.I. > Aparência</p></figcaption></figure>

#### Definir Informações Básicas

* Imagem de perfil: Selecione uma imagem para personalizar o seu agente. Pode ser um personagem, a logo da sua empresa, entre outros.
* Nome de Exibição: Escolha um nome claro para identificar o agente. Por padrão, ele vem com um nome mas pode ser alterado.
* Descrição: Adicione uma descrição complementar ao nome, que especifique a funcionalidade do seu agente. Essa descrição aparecerá para membros e administradores. Por padrão, ele vem com um nome mas pode ser alterado.

<figure><img src="/files/HLlTzKeTKc3iW0a9LBd6" alt=""><figcaption><p>Home > Pré-Vendas A.I. > Aparência</p></figcaption></figure>

&#x20;Personalização geral

* Cores: Escolha as cores do tema do chat (claro ou escuro) e, a cor de resposta do membro (essa será a cor de fundo da caixa de resposta do membro).

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdf3qSrBcPnw94hmVM7PTZia2RPJ1Dt0gK7xS8KT-hhvobxiP8WRgo_y8Ig8H7Fc45bTk7GHBU8PTMyt_MQ-_UkzMV-Ab9GDfqXY3XBu6jSy7AgeSbyXJ01PXbR3hrh6VA_tVuK7Q?key=ZuIr7E6867B284ntAQP80w" alt=""><figcaption><p>Home > Pré-Vendas A.I. > Aparência</p></figcaption></figure>

#### Personalização widget

* Ícones e Cores

Personalize o ícone: Basta clicar no ícone e escolher algum que já esteja pré definido na plataforma, ou é possível carregar uma imagem.

Cor do botão: Selecione uma cor para o botão que irá aparecer no canto inferior esquerdo da área de membros.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcSLBlcHO5Yhghablh7RAcOCpNVEqPigr70rqnr31glxvDPKJhRdt81hqoHKvB0fB6iktaN_vbl8CRymAPcbLcbuV1tbBMst_Lf1KmxLFRRvKSBAQ3gHuong-o4wsIUu3faomk7?key=ZuIr7E6867B284ntAQP80w" alt=""><figcaption><p>Home > Pré-Vendas A.I. > Aparência</p></figcaption></figure>

#### Configurar

Na aba de ‘configurações’

<figure><img src="/files/G9bwbQlcJYuiNX7cjy2d" alt=""><figcaption><p>Home > Pré-Vendas A.I. > Configurações</p></figcaption></figure>

Temos aqui as opções de mensagem inicial e instruções. Por padrão, essas configurações já estão definidas para manter a expertise de 'pré-vendas' do nosso Agente. Não impedimos que você realize alterações. Porém, indicamos que mantenha para que ele possa responder do modo esperado.

<figure><img src="/files/gumGI6XyjBpfiLwZ652Z" alt=""><figcaption><p>Home > Pré-Vendas A.I. > Configurações</p></figcaption></figure>

#### Selecionar o Modelo de IA

Escolha entre os modelos disponíveis:&#x20;

* Cuseduca (Gemini) é um modelo disponibilizado por nós.

Já as opções:

* Gemini e OpenAI é necessário ter a sua conta em uma destas plataformas e arcar com os custos referentes a cada uma delas.

<details>

<summary>Validação de chaves customizadas da OpenAI e Gemini</summary>

<figure><img src="/files/QHrvbILePtVHW1YYiGjl" alt="" width="563"><figcaption></figcaption></figure>

1. **Insira a chave de API no campo indicado**

   * Para **OpenAI**: a chave deve começar com `sk-`
   * Para **Gemini**: a chave deve começar com `AIza`\
     \&#xNAN;*(O sistema já verifica automaticamente se o formato está correto.)*

   <figure><img src="/files/QhcQfXJduMZVb80k4jwG" alt="" width="563"><figcaption></figcaption></figure>
2. **Aguarde a validação automática**\
   Após inserir a chave, o sistema:\
   ✅ Verifica se o formato corresponde ao modelo selecionado\
   ✅ Envia uma solicitação de teste para validar se a chave está ativa e com créditos disponíveis
3. **Confira o resultado da validação**
   * Se a chave for válida, o botão **“Salvar alterações”** será liberado automaticamente.
   * Se a chave for inválida (mesmo com formato correto), aparecerá a mensagem:\
     \&#xNAN;*“Chave API inválida para o modelo selecionado.”*
4. **Salve a configuração**\
   Clique em **“Salvar alterações”** para finalizar.

***

**Por que isso é necessário?**

* Evita erros de digitação e chaves mal formatadas
* Garante que a integração com o modelo de IA funcione corretamente
* Assegura que a chave possui créditos e está ativa antes de permitir o uso
* Melhora a segurança e a experiência de configuração

</details>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdOH69hbbX7EZ3YnWgddbrpn49c-1hxb1cE1FkrZU4YeVop0qRN5zbDRNbVjbVvxcFECITxBrddSlbI8nZ-kOxPAVA-wj-rYOGJRe3W6U8tJqepiMdLyiyE6zQhMtWgcpFCVnedZg?key=ZuIr7E6867B284ntAQP80w" alt=""><figcaption><p>Home > Pré-Vendas A.I. > Configurações</p></figcaption></figure>

#### &#x20;Definir disponibilidade e exibição

* ‘áreas de membros’: Selecione quais áreas de membros devem ter acesso ao seu Agente
* 'grupo de acesso': Mostra todos os grupos de acesso onde este agente está ativo e disponível para os membros.

<figure><img src="/files/GV9ub8LBqNThmGBSZQkg" alt=""><figcaption><p>Home > Pré-Vendas A.I. > Configurações</p></figcaption></figure>

**Locais de Exibição**

* Widget no canto direito da plataforma.
* Página Agente AI uma página dedicada ao agente (mostra todos os  agentes disponíveis).

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXel6BeJBB4ul8hDxu7gX5bKqAa4aoqA8JbE5FMpZ8aY74NWX7BmhlItc9txvu-YHc8mLEgkW05sEpLVsQ0SQzLPofiyM67n0InJP59JlswAggpf5kg2LAkaZLs7bWK9hKNzgWDISQ?key=ZuIr7E6867B284ntAQP80w" alt=""><figcaption><p>Home > Pré-Vendas A.I. > Configurações</p></figcaption></figure>

#### Permissão

Habilite e configure a permissão de visibilidade do agente. Você poderá deixar o seu agente aberto apenas para membros matriculados ou para o público em geral.

<figure><img src="/files/sOblV71GCno7WvqkkyJI" alt=""><figcaption><p>Home > Pré-Vendas A.I. > Configurações</p></figcaption></figure>

#### Dados&#x20;

Na aba de ‘Dados’ alimente o Agente com informações relevantes para melhorar suas respostas:

<figure><img src="/files/u7gEVcfvZNe8cGQc3vBO" alt=""><figcaption><p>Home > Pré-Vendas A.I. > Dados</p></figcaption></figure>

* Arquivos: Faça upload de documentos com conhecimentos específicos para complementar as informações.

{% hint style="info" %}
Formatos aceitos: .pdf, .doc, .docx
{% endhint %}

<figure><img src="/files/C0g1PreWYO9fXPDZXgrH" alt=""><figcaption><p>Home > Pré-Vendas A.I. > Dados</p></figcaption></figure>

* ‘Texto’: Redija seu próprio texto para oferecer mais informações e contexto ao seu chat.

<figure><img src="/files/rtwQwP18n6nuiYthHNLO" alt=""><figcaption><p>Home > Pré-Vendas A.I. > Dados</p></figcaption></figure>

* ‘Vídeos’: Filtre o(s) vídeo(s) que você gostaria de vincular a esse agente, em seguida selecione-os. Coletamos os dados dos vídeos por meio da transcrição por IA do Cplayer. (Para essa função, é necessário utilizar a IA de transcrição do  Cplayer).

<figure><img src="/files/YDHysiCuKxqzidq25613" alt=""><figcaption><p>Home > Pré-Vendas A.I. > Dados</p></figcaption></figure>

#### Conectar

A aba “Conectar” mostra como levar o Agente para fora da plataforma ou integrar-se a outros canais. Ela é dividida em dois cartões principais:&#x20;

* **Incorporação:** Gera um trechinho de código (script) que você cola no HTML de qualquer site. Assim, o mesmo chat que aparece na área de membros pode ser exibido na página institucional, blog, landing page, entre outros.

{% hint style="warning" %}
Pré-requisitos: o Agente precisa estar com widget ativo e  configurado como “acesso público”.&#x20;
{% endhint %}

<figure><img src="/files/M85UgKndaqTKz8E8iQTJ" alt=""><figcaption><p>Home > Pré-Vendas A.I. > Conectar</p></figcaption></figure>

* **Integração (WhatsApp via Z-API)** Conecta o Agente a um número de WhatsApp. Ele passa a responder mensagens recebidas nesse número automaticamente, usando o mesmo conhecimento que tem no chat. Depois de preencher as três chaves e clicar em “Gerar link de webhook”, o sistema cria um link já copiado para a área de transferência. Esse link deve ser configurado na conta Z-API para finalizar a integração.

<figure><img src="/files/Ie1OiwuGT7ceJAnluywA" alt=""><figcaption><p>Home > Pré-Vendas A.I. > Conectar</p></figcaption></figure>

<details>

<summary>Como integrar a <strong>Z-API? Siga o passo a passo</strong></summary>

**Configuração:**

Na aba conectar, clique em integração e em “Z-API”

<figure><img src="/files/lEsBLmhKh7tXQqaq599o" alt="" width="431"><figcaption></figcaption></figure>

Ao clicar em “Habilitar“  você será redirecionado para o preenchimento de credenciais do Z-API

<figure><img src="/files/rnxbYCz2ZP136zxaYd07" alt="" width="563"><figcaption></figcaption></figure>

O ID e Token da instância podem ser coletados na listagem de instâncias no Z-API (<https://app.z-api.io/app/instances>):

<figure><img src="/files/sFjUp11G86TuX6HBszML" alt=""><figcaption></figcaption></figure>

Já o token do cliente deve ser coletado na aba “Segurança“ (<https://app.z-api.io/app/security>):

<figure><img src="/files/MDVtlrLH2YgLU8re61fJ" alt=""><figcaption></figcaption></figure>

Após o preenchimento, clique em “Gerar link do webhook“

<figure><img src="/files/BmpldFLnpXWR5X65Cq2f" alt=""><figcaption></figcaption></figure>

A partir disso será gerado um link de webhook e será copiado automaticamente para área de transferência. Use esse link gerado para configurar os webhooks da respectiva instância no z-api

<figure><img src="/files/7Ri17bCEddqD50rCSVek" alt=""><figcaption></figcaption></figure>

**Pontos de atenção:**

* O administrador é responsável pela contratação da plataforma **z-api.** A Curseduca oferece apenas a possibilidade de integração.
* A Z-API é uma plataforma não oficial do WhatsApp, então números cadastrados podem estar sujeitos a restrições pela plataforma. No entanto, ressaltamos que essa possibilidade não está sob nosso controle.
* Em nossa parte, não há cobranças adicionais por essa integração – apenas é necessário contratar o plano da própria plataforma Z-API.
* As mensagens trocadas via WhatsApp consomem créditos exatamente do mesmo jeito que mensagens trocadas pelo chat da plataforma.

</details>

Com as configurações feitas, basta clicar em ‘salvar alterações’

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXed7-jAuXOVIrCTQCFnoM_UN219KifyxsRD_Tz0-Gy9oWvrfGBaoysDvsqt-XsD4TnvGE21GquxGq0H-sypgIShzShbvJJZXa94obD6x8jLN5iLnvuDUHUK5kJVHCoDcz8R8JHxsg?key=ZuIr7E6867B284ntAQP80w" alt=""><figcaption><p>Home > Pré-Vendas A.I. > Conectar </p></figcaption></figure>

Aparecerá um histórico das alterações realizadas. Verifique se os elementos alterados estão corretos, em seguida salve. Caso tenha algo que você editou errado e queira retornar, basta clicar em ‘cancelar’

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdIX1YYOWX-alJBVwImvCwmqJ1MYdhABi_LsDy9MFY2g7s08-3ZM1avOHiuu1ofUO1V3nnY7zpPDzNbrmhXyhMaVmMT-nUraoX4yHTEcpjoeLE23Hpd7ykJAo9xt5gjW4wP7LGF?key=ZuIr7E6867B284ntAQP80w" alt=""><figcaption><p>Home > Pré-Vendas A.I. > Conectar</p></figcaption></figure>

Nos 3 pontinhos, você pode:

* visualizar o agente&#x20;
* copiar o link do agente para colocar no seu menu, por exemplo, ou em alguma outra página externa
* Ou, excluir o agente (escolha essa opção apenas se você tiver certeza disso).

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcmEzFbA9hxoh5ZamGVy8urQmWXjiiFq47D2qz5njZY3SHFpiaQwc8GxNafWJ2bTkEaTelaSyj3fJh0PU6HE5C0wrUSX426k76dnrs842kqO5oRD1croqO7l81cXG_HizzbZLYYuA?key=ZuIr7E6867B284ntAQP80w" alt=""><figcaption></figcaption></figure>

#### &#x20;Testar e Publicar

* Visualize seu agente
* Ajuste o prompt ou os dados conforme necessário.

***

#### 💬 Dicas de uso

O Agente de Pré-Vendas pode ser utilizado de diversas formas estratégicas:

* **Em seu site**: para fazer a triagem inicial dos visitantes e identificar oportunidades de venda.
* **Em páginas de captura ou checkout**: para ajudar o visitante a entender o produto e gerar mais leads qualificados.
* **No WhatsApp ou redes sociais**: como um assistente que acolhe e filtra contatos antes de repassar ao time humano.

***

#### 📌 Observações importantes

* O **Agente de Pré-Vendas** faz parte do conjunto de **Agentes A.I. especializados** (Pré-Vendas, Vendas e Suporte).
* Disponibilidade e quantidade de agentes variam conforme o **plano contratado**.
* O consumo é contabilizado em **tokens**. Cada conversa equivale, em média, a **700 tokens**, considerando a troca total de mensagens entre o usuário e o agente.
* Você pode adquirir **créditos adicionais** de tokens, conforme sua necessidade.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.curseduca.com/conteudos/agentes-a.i./pre-vendas-a.i..md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.