> For the complete documentation index, see [llms.txt](https://docs.zapi.tools/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zapi.tools/interface/inteligencia-artificial.md).
# Atendimento (IA)
Nesta página é possível criar diferentes atendentes IA para sua operação. Cada atendente possui uma série de instruções que poderão ser definidas individualmente.
1. **Contador**: Mostra a quantidade de tokens IA disponíveis de acordo com o uso e o plano contratado.
2. **Adicionar**: Permite a criação de novos atendentes IA.
***
### Criando um novo atendente
Para criar um novo atendente, basta preencher e salvar o menu com as perguntas sobre seu negócio. Quanto mais informações detalhadas forem fornecidas, melhores serão as respostas da Inteligência Artificial.
***
### Ativando a IA
Para ativar o atendente de IA, clique em `Configurações > Conexões` e em seguida clique no ícone com três pontos `⋮` e selecione a opção `Assistente IA` .
Selecione qual atendente você quer que responda nesta conexão e em quais momentos ele deve agir:
1. **Boas vindas:** O atendente IA irá responder a primeira mensagem do seu lead.
2. **Resposta padrão:** O atendente IA irá responder por padrão novas mensagens enviadas pelo seu lead.
3. **Conversa finalizada**: O atendente IA irá responder apenas mensagens enviadas após a conversa ser marcada como finalizada.
É possível configurar um atendente diferente para cada etapa.
***
### Entendendo os custos
#### O que são tokens?
Tokens são as unidades básicas de texto que um modelo de linguagem (como o ChatGPT ou Gemini) processa para gerar respostas. Um token pode ser uma palavra, parte de uma palavra ou até mesmo um caractere, dependendo do idioma e da estrutura do texto. Em inglês, palavras curtas como "a" ou "is" podem ser um único token, enquanto palavras mais longas podem ser divididas em vários tokens. Em português, a separação de tokens segue a mesma lógica.
Nossos planos de IA são cobrados por pacotes de tokens disponibilizados (independente da utilização total ou parcial). Tokens não utilizados não são reembolsáveis.
| Pacote | Preço | Tokens (total) | Preço (total) |
| ------------------------------------------------------- | -------------- | -------------- | ------------- |
| Plano PRO (Recursos de IA + 5.000.000 tokens incluídos) | R$329,90/mês | 5.000.000 | R$329,90/mês |
| 5.000.000 tokens adicionais | + R$64,90/mês | 10.000.000 | R$ 394,80 |
| 10.000.000 tokens adicionais | + R$99,90/mês | 15.000.000 | R$429,80 |
| 25.000.000 tokens adicionais | + R$179,90/mês | 30.000.000 | R$509,80 |
| 45.000.000 tokens adicionais | + R$279,90/mês | 50.000.000 | R$609,80 |
#### Quantos tokens são usados por mensagem?
O número de tokens por mensagem varia dependendo do comprimento e complexidade do texto. Aqui estão algumas estimativas médias:
* **Mensagem curta (exemplo: "Oi, tudo bem?")** → Aproximadamente **5 a 10 tokens**
* **Mensagem comum (exemplo: "Olá, gostaria de saber mais sobre os seus serviços.")** → Aproximadamente **10 a 20 tokens**
* **Mensagem longa (exemplo: "Olá, estou interessado no seu produto e gostaria de entender melhor como funciona a integração com outros sistemas.")** → Aproximadamente **20 a 40 tokens**
#### O que dá pra fazer com 1 milhão de tokens?
Com base na média de tokens por mensagem:
1. **Mensagens curtas (5-10 tokens)**
* 1 milhão de tokens permite entre **100.000 e 200.000 mensagens curtas**.
2. **Mensagens comuns (10-20 tokens)**
* Permite entre **50.000 e 100.000 mensagens**.
3. **Mensagens longas (20-40 tokens)**
* Permite entre **25.000 e 50.000 mensagens**.
**Atendimento ao cliente automatizado**
* Se cada conversa envolver 10 trocas de mensagens (média de 15 tokens por mensagem), você poderia sustentar cerca de **6.600 a 10.000 atendimentos completos**.
**Respostas automáticas para FAQs e suporte**
* Um sistema de FAQ com respostas médias de 25 tokens poderia processar cerca de **40.000 perguntas respondidas**.
#### Como calcular tokens?
* **Espaços contam?** Sim, espaços entre palavras são considerados ao dividir tokens.
* **Pontuação conta?** Sim, vírgulas, pontos e outros caracteres especiais podem ser tokens separados.
* **Mensagens longas gastam mais tokens?** Sim, quanto maior a mensagem, mais tokens são necessários.
### Recursos de áudio
Contratando um plano com recursos de IA, também é possível ativar a transcrição e resposta de áudios. Ao ativar este recurso, novos áudios recebidos pelo bot são transcritos pela IA e podem ser lidos através do chat, além disso os atendentes IA também são capazes de ouvir e responder os áudios recebidos.
Cada áudio transcrito ou respondido consome entre 100 a 1500 tokens de IA, de acordo com a duração.
***
### Bring Your Own Keys
**BYOK (Bring Your Own Keys)** é um modelo de uso que permite que o usuário use sua própria chave de API para usar os recursos ao invés do faturamento gerenciado pela ferramenta.
Embora os recursos avançados de IA do [zAPI.tools](https://zapi.tools) não sejam compatíveis com BYOK, no Plano Base é possível configurar seu próprio fluxo de IA utilizando uma chave de API própria através do bloco de Integração, sem pagar diretamente na ferramenta por tokens utilizados.
---
# 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:
```
GET https://docs.zapi.tools/interface/inteligencia-artificial.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.