> For the complete documentation index, see [llms.txt](https://doc.whazing.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.whazing.com.br/integracoes/inteligencia-artificial/recepcao-inteligente.md).

# Recepção inteligente

***

## 📌 Recepção Inteligente

\
Ela pode:

* Responder clientes de forma automática com base em prompts configurados.
* Encaminhar a conversa para a **fila/setor adequado** (financeiro, suporte, comercial etc.) conforme palavras-chave identificadas.
* Finalizar o atendimento automaticamente, quando for o caso.

Esse recurso ajuda a reduzir a carga da equipe, garantindo que o cliente seja direcionado corretamente antes de falar com um atendente humano.

***

### ⚙️ Configurações

#### 1. Escolha do Serviço de IA

Você pode escolher qual provedor de IA utilizar:

* **Groq**
* **ChatGPT (OpenAI)**
* **Gemini (Google)**
* **Perplexity**
* **DeepSeek**
* **Grok xAI**

Também é possível selecionar o **modelo de linguagem** desejado.

***

#### 2. Definir API KEY

Informe a chave de API do serviço escolhido (Groq, ChatGPT ou Gemini).

***

#### 3. Prompt Principal

É aqui que você **define as instruções** que a IA deve seguir.\
Exemplo de prompt:

```
Você é um assistente virtual especializado em atendimento ao cliente. 
Seja sempre educado e prestativo. 
Somente responda o que estiver no prompt e transfira para o setor adequado conforme as palavras-chave. 
Se identificar que o atendimento deve ser finalizado, faça isso automaticamente
```

***

#### 4. Prompt Adicional

Você pode complementar o comportamento da IA.\
Exemplo:

```
Responda de forma clara e objetiva. 
Se não souber algo, seja honesto sobre isso.
```

***

#### 5. Parâmetros Avançados

* **Máximo de tokens da resposta** → Limita o tamanho das respostas da IA.
* **Temperatura da IA** → Define a criatividade da resposta (0 = respostas mais objetivas, 1 = respostas mais criativas). Dica: Use 0.1 a 0.3 quanto mais baixo menor chance da ia sair do script e inventar respostas.
* **Histórico de mensagens** → Número de mensagens passadas que a IA deve considerar (recomendado: até 10).
* **Intervalo entre mensagens** → Define quanto tempo a IA deve esperar para responder quando o cliente envia mensagens “picadas” (ex: primeiro manda "bom dia", depois manda o assunto).

***

#### 6. Transferência para Filas

A IA pode direcionar a conversa para uma **fila/setor** com base em palavras-chave.

📌 **Exemplo de configuração de fila com palavras-chave**:

* **Fila Financeiro** → boleto, contas a pagar, vencimento, fatura.
* **Fila Suporte Técnico** → erro, não conecta, problema, travando.
* **Fila Comercial** → orçamento, proposta, preços, plano.

***

#### 7. Verificação de Usuários Online

Você pode configurar se a IA deve verificar se existem atendentes disponíveis na fila antes de transferir.

* **Se tiver usuários online** → A IA transfere normalmente.
* **Se não tiver usuários online** → A IA pode usar uma **fila de fallback** ou enviar uma mensagem personalizada para o cliente.

***

#### 8. Fila de Fallback

Caso a IA identifique uma fila mas não haja atendentes disponíveis, você pode definir uma fila alternativa (**fallback**) ou uma mensagem automática.

📌 **Exemplo**:

* Cliente pede “segunda via do boleto”.
* Fila padrão seria **Financeiro**.
* Se não houver usuários online e a opção estiver marcada, a IA transfere para uma **fila de automação** que pede o **CPF** e gera a 2ª via automaticamente.

***

#### 9. Mensagens Personalizadas por Fila

Você pode definir mensagens específicas que serão enviadas de acordo com a situação da fila.

📌 **Exemplo 1 (fila com usuários online):**

> “Estamos transferindo você para o setor financeiro. Aguarde um momento.”

📌 **Exemplo 2 (fila sem usuários online):**

> “No momento, não há atendentes disponíveis. Informe seu CPF para que possamos enviar a segunda via do boleto automaticamente.”

***

### ✅ Sugestões para Melhor Uso

* Use **prompts curtos e objetivos**, evitando instruções confusas.
* Configure **palavras-chave variadas** (ex: boleto, fatura, conta) para melhorar a identificação.
* Sempre defina uma **fila de fallback** para evitar que o cliente fique sem resposta.
* Ajuste o **intervalo entre mensagens** para evitar que a IA responda mensagens curtas isoladamente (“oi”, “bom dia”).
* Teste diferentes **temperaturas** para encontrar o equilíbrio entre objetividade e naturalidade.

***

### 🚀 Como Usar a Recepção Inteligente

1. **Cadastre a integração**
   * Vá até o menu de **Integrações** e crie uma nova configuração de **Recepção Inteligente**.
   * Defina o provedor de IA (Groq ou ChatGPT), informe a **API KEY** e configure o **prompt** e demais parâmetros.
2. **Associe a integração a uma fila**
   * No menu de **Filas**, escolha ou crie a fila desejada (ex: recepcao).
   * Defina que essa fila utilizará a integração da **Recepção Inteligente** cadastrada.
3. **Vincule a fila ao canal**
   * No menu de **Canais**, selecione o canal de atendimento (ex: WhatsApp, Instagram, Facebook).
   * Configure para que as **novas conversas recebidas** nesse canal sejam direcionadas para a fila que contém a integração.
4. **Pronto!**
   * A partir de agora, sempre que chegar uma **nova mensagem nesse canal**, o primeiro atendimento será feito automaticamente pela **Recepção Inteligente**.
   * A IA responderá o cliente conforme o prompt definido, podendo **finalizar o atendimento** ou **transferir para a fila/setor correto**.

***

📌 **Exemplo prático de fluxo**:

* Cliente envia mensagem pelo WhatsApp: *“Quero a segunda via do boleto”*.
* O canal está vinculado à fila **Financeiro**, que usa a integração da **Recepção Inteligente**.
* A IA identifica a palavra-chave “boleto” e automaticamente:
  * transfere para a fila **Financeiro** se houver atendente online, ou
  * envia a mensagem: *“Informe seu CPF para gerar a segunda via do boleto”* se não houver atendente disponível.

***


---

# 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://doc.whazing.com.br/integracoes/inteligencia-artificial/recepcao-inteligente.md?ask=<question>
```

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.
