> For the complete documentation index, see [llms.txt](https://help.ticto.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.ticto.com.br/sou-produtor/agentes-de-ia.md).

# Agentes de IA

***

### Índice

* [O que é o módulo Agentes de IA](#o-que-e-o-modulo-agentes-de-ia)
* [Por que esse módulo existe](#por-que-esse-modulo-existe)
* [Como funciona, do início ao fim](#como-funciona-do-inicio-ao-fim)
* [O agente acompanha o cliente pelo funil](#o-agente-acompanha-o-cliente-pelo-funil)
* [Honestidade como princípio](#honestidade-como-principio)
* [Onde o agente aparece para o comprador](#onde-o-agente-aparece-para-o-comprador)
* [Como acessar o módulo](#como-acessar-o-modulo)
* [O que são personas e como configurar uma nova](#o-que-sao-personas-e-como-configurar-uma-nova)
* [Passo a passo: configurando seu agente](#passo-a-passo-configurando-seu-agente)
* [Acompanhando conversas e vendas assistidas](#acompanhando-conversas-e-vendas-assistidas)
* [Entendendo a tela Visão geral](#entendendo-a-tela-visao-geral)
* [Perguntas frequentes](#perguntas-frequentes)

***

### 🚨 O que é o módulo Agentes de IA

O **Agentes de IA** é o assistente inteligente que conversa com o comprador direto no checkout do seu produto. Ele tira dúvidas com base no que você configurar, ajuda a destravar a decisão de compra e continua disponível para o comprador depois da venda.

A persona padrão é a **Tina da Ticto**, mas você pode criar a sua própria, com nome e foto personalizados.

{% hint style="info" %}
**Módulo em beta.** Você encontra o item **Agentes de IA** no menu lateral do painel, com o selo BETA.
{% endhint %}

***

### 🎯 Por que esse módulo existe

No meio do checkout, uma dúvida sem resposta costuma virar carrinho abandonado. O comprador que trava numa pergunta — *"tem garantia?"*, *"como eu acesso depois de comprar?"*, *"esse pagamento é seguro?"* — não tem a quem perguntar naquele instante, e o produtor não sabe onde a venda escapou.

O Agente de IA cobre esse vão: responde na hora, com base no que você mesmo cadastrou, e registra toda conversa — inclusive quando não sabe responder algo, para você saber exatamente o que está faltando explicar sobre o seu produto.

***

### 🧭 Como funciona, do início ao fim

Este é o caminho do seu agente, na ordem em que acontece — antes de configurar qualquer coisa, vale entender essa lógica.

**1. O agente nasce com o produto**\
Todo produto novo já ganha um agente em **rascunho** automaticamente, com a persona Tina e a base de conhecimento vazia.

**2. A identidade é configurada**\
Você escolhe a persona — a Tina da Ticto ou uma sua, com foto própria — e escreve as instruções de venda e o contato de suporte. As variáveis de nome do produto e do produtor são preenchidas automaticamente.

**3. A base de conhecimento é preenchida**\
São dez seções sobre o seu produto: garantia, forma de acesso, pagamento e outras.

{% hint style="warning" %}
O agente só sabe o que estiver escrito na base de conhecimento. O que faltar, ele admite que não sabe e direciona para o seu suporte — ele nunca inventa uma resposta.
{% endhint %}

Um anel de cobertura mostra visualmente o quanto da base já está preenchido.

**4. A área de atuação é definida**\
Por padrão, o agente aparece em **todas as ofertas** do produto. É possível restringir a atuação dele a uma **lista específica de ofertas**.

**5. Publicar liga, despublicar desliga**\
Só um agente **publicado** aparece no checkout — e publicar exige que as instruções de venda estejam preenchidas. Ao despublicar, o widget some na hora, sem nenhum agente genérico no lugar.

**6. O agente é testado**\
O editor tem um chat de teste que conversa com a configuração que está realmente no ar, permitindo simular perguntas antes de publicar.

**7. As conversas são acompanhadas**\
Cada interação com o comprador fica registrada e organizada por status e desfecho.

**8. As vendas viram receita atribuída**\
Quando uma conversa acontece antes de uma compra paga, essa venda é atribuída ao agente. Oferta principal, order bump e upsell são contados separadamente.

{% hint style="info" %}
💡 **Como funciona a atribuição:** contamos a conversa que existiu *antes* da compra paga — é atribuição por precedência, não por mérito. O painel nunca afirma que "o agente gerou a venda", apenas que a conversa aconteceu antes dela. Boleto pendente e cartão recusado não viram receita.
{% endhint %}

***

### 🛤️ O agente acompanha o cliente pelo funil

Quando o produto principal tem **order bump** ou **upsell** no funil, o agente não fica restrito à oferta inicial: ele **navega junto com o cliente**, permanecendo disponível também nas etapas seguintes da compra.

{% hint style="warning" %}
Por isso é importante enriquecer a base de conhecimento do agente com informações sobre os produtos oferecidos no order bump e no upsell, não só sobre o produto principal. Assim, quando o cliente chegar nessas etapas, o agente já tem argumentos para tirar dúvidas e ajudar a converter também essas ofertas — e não só a oferta principal.
{% endhint %}

Isso é o que permite que a receita assistida seja contabilizada separadamente para oferta principal, order bump e upsell: cada etapa do funil conta com o mesmo agente, mas respondendo com o conhecimento específico daquela oferta.

***

### 🤝 Honestidade como princípio

O agente ajuda a vender, mas dentro de um limite claro:

* Nunca promete o que o produto não pode cumprir
* Não inventa benefício, desconto ou urgência falsa
* Não recomenda concorrente
* Quando não sabe responder, encaminha para o seu suporte real

{% hint style="success" %}
É esse limite que separa um assistente de vendas confiável de uma prática que pode queimar a reputação da sua marca.
{% endhint %}

***

### 📍 Onde o agente aparece para o comprador

| Local                  | Comportamento                                                        |
| ---------------------- | -------------------------------------------------------------------- |
| **Checkout**           | Widget de chat flutuante, com o nome e a foto da persona configurada |
| **Página de obrigado** | Continua o atendimento depois da compr                               |

<div data-with-frame="true"><figure><img src="/files/tJ0J1UbrmDyeR7AJUq2L" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
Se o agente não estiver publicado, nenhum widget aparece — o comprador segue o checkout normalmente, sem qualquer assistente no lugar.
{% endhint %}

***

***

## 🛠️ Como usar

### 🚪 Como acessar o módulo

{% stepper %}
{% step %}
No menu lateral esquerdo da plataforma, clique em **Agentes de IA**.

<div data-with-frame="true"><figure><img src="/files/HVhrDqJTSfYGEr9HgtNM" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Você chega na **Visão geral**, com as abas **Agentes**, **Conversas** e **Personas** no topo.

<div data-with-frame="true"><figure><img src="/files/nKBzxsprZ6Ypp6dyNEcO" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

***

### 🎭 O que são personas e como configurar uma nova

**Persona** é a identidade com quem o comprador conversa: o nome e a foto que aparecem no widget de chat. Toda persona fica reunida na aba **Personas**, dentro do módulo.

| Persona                   | Características                                                                                           |
| ------------------------- | --------------------------------------------------------------------------------------------------------- |
| **Tina da Ticto**         | Persona padrão do sistema, já vem pronta para uso. É somente leitura — não pode ser editada nem excluída. |
| **Persona personalizada** | Criada por você, com nome e foto próprios. Pode ser editada ou excluída a qualquer momento.               |

{% hint style="info" %}
Você pode ter mais de uma persona personalizada e escolher qual delas usar em cada agente — a mesma persona pode até ser reaproveitada em produtos diferentes.
{% endhint %}

Antes de configurar o agente propriamente dito, vale montar a persona que você vai usar:

{% stepper %}
{% step %}
Na tela de **Agentes de IA**, clique na aba **Personas**.

<div data-with-frame="true"><figure><img src="/files/I3Ur2smgqJ975B8nY2FM" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Clique em **Nova persona**.

<div data-with-frame="true"><figure><img src="/files/E5CM4SHJMM2duQ2uxNr5" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Dê um nome à persona e envie uma foto (formatos aceitos: PNG, JPG ou WebP, até 4MB). Por fim defina a personalidade do agent.

<div data-with-frame="true"><figure><img src="/files/rWg4RdinZxcUTVstl2Rv" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Salve. A nova persona já aparece disponível para seleção no editor de qualquer agente.

<div data-with-frame="true"><figure><img src="/files/XGLYrZHlqSm0WInvDMcX" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Se você excluir uma persona personalizada que estava em uso, os agentes que a usavam voltam automaticamente a exibir a persona padrão (Tina).
{% endhint %}

***

### ⚙️ Passo a passo: configurando seu agente

{% stepper %}
{% step %}
Acesse **Agentes de IA** no menu lateral e vá até a aba **Agentes**.

<div data-with-frame="true"><figure><img src="/files/cCy74Wap69XwTSRUWoyS" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Localize o agente do seu produto na lista, ou clique em **Criar agente** caso ainda não exista um.

<div data-with-frame="true"><figure><img src="/files/rYJSvPw2G7hoYdNzmjzp" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
Produto sem agente ainda? Todo produto novo já nasce com um; produtos antigos usam o botão **Criar agente**.
{% endhint %}
{% endstep %}

{% step %}
Abra o editor do agente através  do botão **Configurar.**

<div data-with-frame="true"><figure><img src="/files/6eLzQH9auu1IdyuwMue2" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
Ainda não criou uma persona própria? Veja o passo a passo em [O que são personas e como configurar uma nova](#o-que-sao-personas-e-como-configurar-uma-nova).
{% endhint %}
{% endstep %}

{% step %}
Ao acessar o o botão Configurar, é necessário seguir cada etapa de configuração para enriquecer ainda mais o agente com informações do seu produto e funil de vendas.

<div data-with-frame="true"><figure><img src="/files/qs1LepU2EFbL38xUNzav" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Defina o **Nome do agente** e e selecione qual persona será utizada, por padrão a Tina é escolhida, porém você pode escolher conforme sua identidade.

<div data-with-frame="true"><figure><img src="/files/368VtKqfOG3zO6upZFXG" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Escreva as **instruções de venda** e o **contato de suporte** que o agente deve indicar quando não souber responder.

<div data-with-frame="true"><figure><img src="/files/qByqNJpGJ6kDBVHKnJKW" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Preencha as **dez seções da base de conhecimento** (garantia, acesso, pagamento e afins) até o anel de cobertura refletir o quanto você já configurou.

{% hint style="warning" %}
Se o seu funil tem **order bump** ou **upsell**, inclua também informações sobre esses produtos na base. O agente acompanha o cliente por todo o funil, então precisa de argumentos para responder dúvidas sobre cada oferta que aparecer no caminho — não só sobre o produto principal.
{% endhint %}
{% endstep %}

{% step %}
Em **Onde ele atua**, defina se o agente vale para **todas as ofertas** do produto ou apenas para uma **lista específica**.

<div data-with-frame="true"><figure><img src="/files/rRZLqYZfR7kVnANmTGHn" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Selecione cupons se houver para que o agent possa usar durante a negociação.

<div data-with-frame="true"><figure><img src="/files/5tld6LdotsvxVFV9QlUN" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Use o **chat de teste** do editor para simular perguntas reais de compradores e ajustar a base.

<div data-with-frame="true"><figure><img src="/files/gmB31fhBc9A8Z6nzspIf" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Salve as configurações e clique em **Publicar**.

<div data-with-frame="true"><figure><img src="/files/hb9BXoZ6JksVWDnS8JwM" alt=""><figcaption></figcaption></figure></div>

{% hint style="warning" %}
Se as instruções de venda estiverem vazias, a publicação é bloqueada até você preenchê-las.
{% endhint %}

{% hint style="info" %}
**Recomendação** : Acesse o link do checkout do produto configurado e realize testes antes de publicar campanhas de marketing.
{% endhint %}
{% endstep %}
{% endstepper %}

***

### 📊 Acompanhando conversas e vendas assistidas

Na aba **Conversas**, cada interação aparece organizada por status e por desfecho:

| Status       | O que mostra                          |
| ------------ | ------------------------------------- |
| **Agora**    | Conversas em andamento                |
| **Abertas**  | Conversas ainda sem desfecho definido |
| **Fechadas** | Conversas já concluídas               |

<div data-with-frame="true"><figure><img src="/files/2caprHpCkru1v2EDVGil" alt=""><figcaption></figcaption></figure></div>

| Desfecho             | Significado                                         |
| -------------------- | --------------------------------------------------- |
| **Venda**            | A conversa precedeu uma compra paga                 |
| **Dúvida resolvida** | O agente respondeu com base na base de conhecimento |
| **Lacuna na base**   | O comprador perguntou algo que não está cadastrado  |

<div data-with-frame="true"><figure><img src="/files/K7c6pc3aDtzUTAoEhXcm" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
💡 As lacunas são um ótimo termômetro do que revisar: mostram exatamente o que faltou na sua base de conhecimento para responder o comprador.
{% endhint %}

#### 📊 Entendendo a tela Visão geral

Ao entrar no módulo, a primeira aba que aparece é a **Visão geral** — o resumo do que os seus agentes fizeram por você. Os dados são processados periodicamente, e você pode filtrar o período em **7 dias**, **30 dias** ou **90 dias**.

**Indicadores principais**

| Campo                 | O que mostra                                                                                                                                                   |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Receita assistida** | Soma das compras concluídas depois de uma conversa com o agente. Contamos por posse (a conversa existiu antes da compra), nunca como venda gerada pelo agente. |
| **Vendas assistidas** | Quantidade de compras pagas que tiveram uma conversa antes.                                                                                                    |
| **Conversas**         | Total de conversas iniciadas no período.                                                                                                                       |

**Funil de vendas**

Mostra, em percentual e em número absoluto, quantas conversas avançaram em cada etapa:

| Etapa                  | O que representa                                           |
| ---------------------- | ---------------------------------------------------------- |
| **Conversas**          | Total de conversas no período (base do funil, sempre 100%) |
| **Viraram compra**     | Conversas que resultaram em venda da oferta principal      |
| **Levaram order bump** | Conversas que resultaram também em order bump              |
| **Aceitaram upsell**   | Conversas que resultaram também em upsell                  |

**Vendas por tipo de item**

Lista separando a receita assistida por **produto principal**, **order bump** e **upsell**, com quantidade de vendas e valor de cada um.

**Quando as conversas acontecem**

Um mapa de calor por dia da semana e horário (fuso de Brasília), mostrando em quais janelas de tempo o seu comprador mais conversa com o agente — útil para entender o padrão de atendimento do seu público.

**Por agente**

Tabela com o desempenho de cada produto que tem agente configurado, mostrando **Conversas**, **Vendas** e **Receita assistida** por produto. Ideal quando você tem mais de um produto com agente ativo e quer comparar performance entre eles.

<div data-with-frame="true"><figure><img src="/files/aKYOvlvaJaLuVxD2r9rB" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
💡 Se você tem produtos com agente ainda em rascunho, um aviso aparece na própria Visão geral lembrando que existe um agente pronto para configurar — e que, uma vez publicado, ele já atende no checkout no mesmo dia.
{% endhint %}

***

### ❓ Perguntas frequentes

<details>

<summary>Preciso criar o agente manualmente?</summary>

Não. Todo produto novo já nasce com um agente em rascunho. Você só precisa configurá-lo e publicar. Produtos criados antes do lançamento do módulo podem usar o botão **Criar agente**.

</details>

<details>

<summary>Posso usar minha própria identidade em vez da Tina?</summary>

Sim. Você pode criar uma persona própria, com nome e foto, e usá-la no lugar da Tina padrão.

</details>

<details>

<summary>O que acontece se eu não preencher toda a base de conhecimento?</summary>

O agente responde apenas o que estiver cadastrado. Perguntas fora da base recebem uma resposta honesta de "não sei", com direcionamento para o seu contato de suporte.

</details>

<details>

<summary>Consigo restringir o agente a algumas ofertas apenas?</summary>

Sim, no editor do agente é possível trocar de "todas as ofertas" para uma lista específica.

</details>

<details>

<summary>Como sei se o agente está ajudando a vender?</summary>

Na aba **Visão geral** você acompanha a receita assistida, o número de vendas assistidas e o funil de conversas.

</details>

<details>

<summary>Quanto tempo leva para uma venda aparecer como assistida no painel?</summary>

O processamento é periódico, então pode levar até uma hora para a receita aparecer somada na Visão geral após a compra. Isso é esperado, não um erro.

</details>

<details>

<summary>Despublicar o agente afeta a venda em andamento?</summary>

Não. A compra continua funcionando normalmente mesmo com o widget desligado — apenas o chat deixa de aparecer para novos visitantes.

</details>

{% hint style="info" %}

### **Não encontrou o que precisava? Nos chame pelo WhatsApp.**

Clique no botão abaixo para falar com o suporte humanizado:

<a href="https://api.whatsapp.com/send?phone=5519999191510" class="button primary" data-icon="square-whatsapp">Clique aqui para falar conosco</a>
{% endhint %}
