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

# Créditos de IA

{% hint style="warning" %}
**Disponível para o perfil:** Administrador
{% endhint %}

Os **Créditos de IA** são um saldo pré-pago para usar a IA do sistema **sem precisar contratar um provedor nem cadastrar uma chave própria**. Você adiciona saldo e cada resposta da IA desconta o valor dela.

Neste artigo você vai ver como adicionar saldo, escolher onde usar a IA da plataforma, acompanhar o extrato e o consumo, consultar os preços e configurar o aviso de saldo baixo.

{% hint style="info" %}
**Pré-requisitos:**

* Acesso de **Administrador** na empresa.
* Créditos de IA **incluídos no seu plano** e **liberados** para a sua empresa pelo responsável pela plataforma. Se a opção não aparecer no menu, fale com ele.
  {% endhint %}

[*Documentação sobre como cadastrar a IA no superadmin*](https://ajuda.zdg.com.br/configuracao-superadmin/tenants-e-licenca/ia-da-plataforma.md)

***

### Como funciona

* Cada resposta da IA tem um custo, que é descontado do seu saldo na hora.
* O custo depende do **modelo** usado e do **tamanho** da conversa: entram a mensagem, o histórico, as instruções, as imagens e o texto que a IA gera. Modelos que "pensam" antes de responder também cobram esse raciocínio.
* Áudio é cobrado à parte: a **transcrição** por minuto e a **voz** pela quantidade de caracteres.
* Os preços aparecem **já em reais**, com tudo incluído.
* Ter créditos não muda nada sozinho: em cada recurso de IA você escolhe se usa a **chave própria** ou a **IA da plataforma** (Etapa 3). Só o que estiver na IA da plataforma desconta do saldo.

{% hint style="warning" %}
**Atenção ao saldo:** quando o saldo acaba, a IA termina a resposta em andamento e o atendimento vai para a fila. Ela **não** passa a usar a sua chave própria no lugar. Configure o aviso de saldo baixo (Etapa 7) para não ser pego de surpresa.
{% endhint %}

***

### Etapa 1: Acessar a página

No menu lateral, acesse **Configuração > Créditos de IA**.

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FYUN4Ari5NkMRHmdc4yZY%2Fimage.png?alt=media&amp;token=4e7d3180-faa7-4cc8-943c-a60fad77f0d4" alt="" width="248"><figcaption></figcaption></figure>

No topo da página fica o seu **Saldo** atual e o botão **Adicionar saldo**. Logo abaixo, as abas **Extrato**, **Consumo**, **Preços** e **Avisos**.

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FGBXYeeay0GKyysIgfUvQ%2Fimage.png?alt=media&amp;token=152d2203-4710-4aa7-a9bb-ba865430ff73" alt=""><figcaption></figcaption></figure>

***

### Etapa 2: Adicionar saldo

1. Clique em **Adicionar saldo**.
2. Escolha o valor da recarga. Dependendo da configuração da plataforma, você digita o valor que quiser (respeitando a recarga mínima) ou escolhe um dos pacotes disponíveis, que podem vir com bônus.
3. Conclua o pagamento. A recarga usa o mesmo meio de pagamento do seu plano:
   * **Asaas:** escolha **Pix**, **boleto** ou **cartão**. A cobrança vence em 3 dias e vale por 7.
   * **Stripe:** pague na página de pagamento. O link vale cerca de 24 horas.

O saldo entra **depois que o pagamento é confirmado**:

| Forma de pagamento | Quando o saldo entra                 |
| ------------------ | ------------------------------------ |
| Pix                | Em segundos.                         |
| Cartão             | Quando o pagamento é aprovado.       |
| Boleto             | Quando o boleto é compensado.        |
| Stripe             | Quando a página de pagamento é paga. |

Se o saldo não aparecer depois de pagar, clique em **Verificar pagamento**. O sistema também confere sozinho ao longo do dia.

{% hint style="info" %}
Em pacote com bônus, entra o valor de crédito do pacote. Só existe **uma recarga pendente por vez**: gerar uma nova cancela a anterior.
{% endhint %}

***

### Etapa 3: Usar a IA da plataforma nos recursos

Ter saldo não basta: em cada recurso que deve consumir do saldo, escolha **IA da plataforma** na opção **Chave própria / IA da plataforma** e salve. São quatro lugares.

#### Agente de IA

1. Abra o agente em **Editar** e vá à aba **Provedor**.
2. Escolha **IA da plataforma** e salve.

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2F3LJrEnLInVnH4AymffyU%2Fimage.png?alt=media&amp;token=39f83164-178e-48ad-990a-cf499ad8099c" alt="" width="375"><figcaption></figcaption></figure>

**Desconta do saldo:** respostas, resumo do atendimento, base de conhecimento (montar e consultar) e o áudio, a imagem e a resposta em voz nas conversas que o agente atende. Veja Agentes de IA.

#### Conexão (robô ChatGPT)

1. Acesse **Sessões**, clique em **editar** na conexão e vá à seção **ChatGPT**.
2. Escolha **IA da plataforma** e salve.

**Desconta do saldo:** o robô ChatGPT da conexão, com o áudio, a imagem e a voz dele.

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FOpE2xIfExNZR6CebVNrh%2Fimage.png?alt=media&amp;token=ef0de850-7acd-4370-9d5e-4660c088c03a" alt=""><figcaption></figcaption></figure>

#### Bloco ChatGPT no fluxo

1. No fluxo, abra o bloco **ChatGPT**.
2. Escolha **IA da plataforma** e salve o fluxo.

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FGSRThUedr26oehdVzSSE%2Fimage.png?alt=media&amp;token=76f13aee-d46d-49f2-ac6c-520fa69c89b7" alt="" width="375"><figcaption></figcaption></figure>

**Desconta do saldo:** as respostas daquele bloco.

#### Copiloto

1. Acesse **Configurações > Copiloto**.
2. Em provedor, escolha **IA da plataforma** e salve.

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FHcCgjycB9cMPVhaWPImc%2Fimage.png?alt=media&amp;token=a2cbbeb2-bd1c-4cfc-903f-2ce3cae11722" alt=""><figcaption></figcaption></figure>

**Desconta do saldo:** as sugestões que o atendente pede. Veja Copiloto de IA.

#### Regras gerais

* **Transcrição** de áudio não é escolhida à parte: ela acontece quando o robô ou o agente precisa entender um áudio do cliente, e só desconta do saldo se esse robô ou agente estiver na IA da plataforma.
* Chave própria e IA da plataforma **convivem**: cada lugar usa só o que foi escolhido nele. Ex: o agente na IA da plataforma e a conexão na chave própria.
* No mesmo atendimento, o **agente** e o **bloco ChatGPT do fluxo** têm prioridade sobre a conexão.

{% hint style="warning" %}
**Não funcionam com a IA da plataforma:** o **Assistente da OpenAI** (ID de assistente na conexão), que solta o atendimento para a fila, e o **Gemini**, que usa a chave própria.
{% endhint %}

{% hint style="info" %}
**Copiloto:** se ele estiver na IA da plataforma e a sua empresa perder a liberação dos créditos, ele passa a usar a chave própria de uma das suas conexões (nunca uma conexão que esteja na IA da plataforma).
{% endhint %}

***

***

### Etapa 4: Acompanhar o extrato

A aba **Extrato** mostra todas as entradas e saídas do saldo:

| Coluna         | O que mostra                                                                         |
| -------------- | ------------------------------------------------------------------------------------ |
| **Data**       | Data e hora do lançamento.                                                           |
| **Tipo**       | Ex: recarga, crédito manual, débito manual.                                          |
| **Descrição**  | Detalhe do lançamento. Em ajustes feitos pela plataforma, mostra o motivo informado. |
| **Valor**      | Entradas em verde (+) e saídas em vermelho (−).                                      |
| **Saldo após** | Como ficou o saldo depois do lançamento.                                             |

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FaaEmz80FeLilpC07amR7%2Fimage.png?alt=media&amp;token=4afa421b-45d9-4d5d-85fc-517ee1c61126" alt="" width="375"><figcaption></figcaption></figure>

1. Abra a aba **Consumo**.
2. Escolha o período em **De** e **Até**, ou use os atalhos **Hoje**, **7 dias**, **30 dias** ou **90 dias**.
3. Escolha a visão:
   * **Por dia:** quanto foi gasto em cada dia.
   * **Por chamada:** cada uso da IA, um por linha.
4. Confira o **Total no período**, no canto direito.

***

### Etapa 6: Consultar os preços

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FbJZ5ud3OeIKHICknOoqw%2Fimage.png?alt=media&amp;token=6d3937c6-296d-4581-878f-ca5ae1132a69" alt="" width="375"><figcaption></figcaption></figure>

A aba **Preços** lista os modelos de IA disponíveis e quanto cada um custa, em **valores finais, já em reais**. Clique em **Atualizar** para carregar a tabela mais recente.

{% hint style="info" %}
O preço aparece por **1 milhão de tokens de saída** e serve para **comparar os modelos** entre si. O valor descontado de cada resposta considera a conversa inteira (entrada e saída), por isso não é uma conta direta a partir dessa tabela. Para saber quanto você gastou de fato, use a aba **Consumo**.
{% endhint %}

***

### Etapa 7: Configurar o aviso de saldo baixo

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FDPRzZBZcrkqBvHtMgHJ1%2Fimage.png?alt=media&amp;token=8983d263-6947-4c06-9e28-150734290d6d" alt="" width="375"><figcaption></figcaption></figure>

1. Abra a aba **Avisos**.
2. Em **Avisar quando o saldo ficar abaixo de**, informe o valor em reais.
3. Clique em **Salvar**.

Deixe o campo em branco para usar o valor padrão definido pela plataforma.

***

### Resumo das Funcionalidades

| Funcionalidade                 | Onde acessar                                                                                      |
| ------------------------------ | ------------------------------------------------------------------------------------------------- |
| Ver o saldo e recarregar       | **Configuração > Créditos de IA > Adicionar saldo**                                               |
| Usar o saldo num recurso       | Opção **Chave própria / IA da plataforma** no agente, na conexão, no bloco ChatGPT ou no Copiloto |
| Histórico de entradas e saídas | Aba **Extrato**                                                                                   |
| Gasto por dia ou por chamada   | Aba **Consumo**                                                                                   |
| Preço de cada modelo           | Aba **Preços**                                                                                    |
| Aviso de saldo baixo           | Aba **Avisos**                                                                                    |

***

### Encerramento

Com os Créditos de IA, sua empresa usa IA no atendimento sem contratar um provedor nem gerenciar chaves, e acompanha cada real gasto pelo extrato e pelo consumo.

***

### Possíveis Erros e Soluções

#### A opção Créditos de IA não aparece ou está bloqueada

**Causa:** o recurso ainda não foi liberado para a sua empresa. **Solução:** peça a liberação ao responsável pela plataforma.

#### A IA parou de responder e o atendimento foi para a fila

**Causa:** o saldo acabou. **Solução:** confira o saldo no topo da página e clique em **Adicionar saldo**.

#### O saldo não desconta (a IA usa a minha chave)

**Causa:** o recurso está configurado com **Chave própria**. **Solução:** escolha **IA da plataforma** no recurso (Etapa 3) e salve.

#### Paguei e o saldo não entrou

**Causa:** o pagamento ainda não foi confirmado (boleto leva até a compensação) ou você gerou outra recarga depois, o que cancela a anterior. **Solução:** clique em **Verificar pagamento**. Se pagou uma recarga cancelada, fale com o responsável pela plataforma.

#### Aparece "Nenhum meio de pagamento disponível para recarga"

**Causa:** o meio de pagamento do seu plano não aceita recarga avulsa e a plataforma ainda não configurou uma alternativa. **Solução:** fale com o responsável pela plataforma.

#### O consumo foi maior do que o esperado pela tabela de preços

**Causa:** a tabela mostra só o preço de saída, como referência. Cada resposta também cobra a entrada (histórico da conversa, instruções e imagens), e conversas longas ou modelos que "pensam" custam mais. **Solução:** veja o gasto real na aba **Consumo**, com a visão **Por chamada**. Se o gasto estiver alto, use um modelo mais barato ou reduza as instruções e a base de conhecimento enviadas à IA.

#### A aba Preços está vazia

**Causa:** a lista ainda não foi carregada ou não há modelos disponíveis. **Solução:** clique em **Atualizar**. Se continuar vazia, fale com o responsável pela plataforma.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://ajuda.zdg.com.br/configuracao-administrador/configuracao/creditos-de-ia.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
