> 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/integracoes/inteligencia-artificial/recepcao-inteligente.md). # Recepção Inteligente A Recepção Inteligente é um recurso que utiliza IA (Inteligência Artificial) para realizar um pré-atendimento automático aos clientes. ## 📌 O que é A **Recepção Inteligente** realiza um **pré-atendimento automático com IA**. 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. *** ## 📍 Onde acessar Acesse: **Automação e Integrações → IA e Integrações** No primeiro cadastro, o sistema exibe um **wizard guiado** simples, ideal para iniciantes. *** ## 🚀 Como criar sua integração O cadastro é feito pelo wizard **Nova integração Smart Reception** em **7 passos**: 1. **Nome** — como chamar a integração 2. **Modelo** — personalizado ou modelo pronto por segmento 3. **IA** — IA disponibilizada pelo sistema ou sua própria API 4. **Personalidade** — prompt principal (e secundário opcional) 5. **Ações Automáticas** — transferência por palavras-chave e Kanban (opcional) 6. **Fonte de Informações** — base de conhecimento e arquivos (opcional) 7. **Revisão** — confira e crie Depois, o wizard **"Vamos ativar sua integração"** define a **fila** (criada automaticamente), os **canais** e a **confirmação**. 📖 [Passo a passo completo →](/integracoes/integracoes/inteligencia-artificial/recepcao-inteligente/como-ativar-a-integracao.md) *** ## 🗂️ Abas de configuração Após criar, o botão **Editar** abre as **informações avançadas** em abas: | Aba | O que configura | Documentação | | ----------------- | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Personalidade** | Modelo de atendimento, prompt principal e secundário | [Instruções eficientes](/integracoes/integracoes/inteligencia-artificial/recepcao-inteligente/como-criar-instrucoes-eficientes-para-atendimento-automatico-com-ia.md) | | **Comportamento** | Histórico de atendimentos anteriores e tempo de espera para resposta | [Comportamento](/integracoes/integracoes/inteligencia-artificial/recepcao-inteligente/comportamento.md) | | **Automação** | Transferência por filas, usuários, chatbot, etiquetas, Kanban, arquivos, chave PIX e agendamento | [Etiquetas e Kanban](/integracoes/integracoes/inteligencia-artificial/recepcao-inteligente/etiquetas-automaticas-e-kanban-com-ia.md) · [Arquivos](/integracoes/integracoes/inteligencia-artificial/recepcao-inteligente/envio-de-arquivos-via-ia.md) · [PIX](/integracoes/integracoes/inteligencia-artificial/recepcao-inteligente/botao-pix-automatico-no-atendimento.md) · [Agendamento pela IA](/funcionalidades/funcionalidades/agenda/agendamento-pela-recepcao-inteligente.md) | | **Conhecimento** | Base de conhecimento, busca na web, MCP e busca semântica | [Base de conhecimento](/integracoes/integracoes/inteligencia-artificial/recepcao-inteligente/base-de-conhecimento.md) · [Busca na web](/integracoes/integracoes/inteligencia-artificial/recepcao-inteligente/busca-na-web.md) · [MCP](/integracoes/integracoes/inteligencia-artificial/recepcao-inteligente/mcp-e-ferramentas-de-ia.md) · [Busca semântica](/integracoes/integracoes/inteligencia-artificial/recepcao-inteligente/busca-semantica.md) | | **Voz** | Respostas por áudio | [Resposta por áudio](/integracoes/integracoes/inteligencia-artificial/recepcao-inteligente/configuracao-de-resposta-por-audio.md) | | **Followup** | Follow-up automático e ausência de resposta | [Follow-up](/integracoes/integracoes/inteligencia-artificial/recepcao-inteligente/follow-up-recepcao-inteligente.md) | | **Avançado** | Parâmetros técnicos (tokens, temperatura) e Command Analyzer (IA 2) | [Provedor personalizado](/integracoes/integracoes/inteligencia-artificial/recepcao-inteligente/configurando-provedor-de-ia-personalizado-openai-compativel.md) | *** ## ✅ Conceitos importantes * **Prompt principal** — instruções que definem como a IA se comporta, o que ela pode e não pode fazer. * **Transferência por palavras-chave** — a IA direciona a conversa para a fila/setor correto. * **Usuários online** — opção de transferir somente para filas com usuários online. * **Fila de fallback** — fila alternativa quando não há atendentes disponíveis ou ocorre erro. * **Mensagens personalizadas** — mensagem de transferência com ou sem usuários online. * **Parâmetros avançados** — máximo de tokens, temperatura e histórico de mensagens. * **Command Analyzer (IA 2)** — segunda IA que analisa a resposta da IA 1 e decide ações de sistema (transferir para fila/usuário, enviar arquivo, PIX, encerrar). A IA 1 autoriza a ação; a IA 2 escolhe o destino. *** ## 🔀 Transferência inteligente (aba Automação) No card **Transferência** da aba **Automação** ficam as opções que controlam **para quem a IA transfere** e **o que o cliente vê** nessa transferência. ### 👥 Usuários online | Opção | O que faz | | ---------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | | **Transferir apenas para filas com usuários online** | Antes de transferir, o sistema confere se tem alguém disponível na fila | | **Verificar usuários online nesta fila** | Mesma checagem, mas configurada **fila por fila** | | **Fila de fallback** | Se não houver usuários online (quando a verificação estiver ativa) ou o bot não entender a solicitação, o atendimento vai para essa fila de reserva | ### 🕗 Fora do horário de atendimento * **Bloquear transferência fora do horário de atendimento** — quando ativado, a IA não realiza transferências fora do horário configurado. * **Mensagem fora do horário de atendimento** — o texto que o cliente recebe nesse caso. ### 💬 Mensagens personalizadas | Mensagem | Quando é enviada | | ------------------------------------------------------ | ------------------------------------------------------------------------------ | | **Mensagem de transferência** (global) | Quando a fila **tem** usuários online | | **Mensagem quando não há usuários online** (global) | Quando a fila **não tem** nenhum usuário online | | **Mensagem de transferência personalizada** (por fila) | Substitui a global para aquela fila — se ficar vazia, usa a global | | **Mensagem quando não há usuários online** (por fila) | Substitui a global para aquela fila — se ficar vazia, usa a global | | **Mensagem quando usuário está offline** (por usuário) | Enviada se o usuário escolhido estiver offline e a verificação estiver ativada | > 💡 As mensagens personalizadas deixam a transferência mais natural: o cliente lê "Conectando com nossa equipe de vendas..." em vez de um aviso genérico. > ⚠️ Sempre escolha uma **fila de fallback**. É ela que evita que o cliente fique sem resposta quando ninguém está online ou a IA não entende o pedido. *** ### ✅ 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. > 💡 Se a IA parece lenta demais, veja a aba **Comportamento**. O tempo de espera é configurável e está relacionado ao comportamento de agrupar as mensagens do cliente antes de responder. *** ## 🧠 FAQ e comportamento comum Para dúvidas rápidas sobre o comportamento da Recepção Inteligente — especialmente o **tempo de espera**, o **agrupamento de mensagens** e o que fazer quando ela parece não entender — veja o [FAQ](https://github.com/cleitonme/Whazing-SaaS/tree/main/integracoes/inteligencia-artificial/recepcao-inteligente/faq.md). *** ## 🧪 Testando a integração (Simular conversa) Na tela da integração você encontra o botão **Simular conversa**, que abre um chat de teste para conversar com a sua IA. > ⚠️ **O simulador é uma simulação — tem limitações.** Veja o botão **Ver limitações** no próprio teste. | Recurso | Comportamento no simulador | | ---------------------------------- | ----------------------------------------------------------------------------------- | | **Base de Conhecimento** | Itens da KB **não são buscados** — a IA responde apenas com o prompt configurado | | **Busca web (Tavily)** | Nenhuma pesquisa é feita na web durante a simulação | | **Envio de arquivos** | O comando `sendFile` é detectado e exibido, mas o arquivo **não é enviado de fato** | | **PIX** | O comando `SendPix` é detectado e exibido, mas nenhuma chave é enviada | | **Verificação de usuários online** | Transferências acontecem **sem checar** se há atendentes disponíveis | | **Histórico real de tickets** | A conversa começa do zero — sem contexto de atendimentos anteriores do contato | > 💡 **O que funciona fielmente:** prompt principal, filas, usuários e comandos são simulados fielmente. > 💡 Para testar **Base de Conhecimento, busca web, arquivos e PIX de verdade**, faça um teste **real** pelo WhatsApp/canal configurado. *** ## 📌 Exemplo prático de fluxo * Cliente envia mensagem pelo WhatsApp: *"Quero a segunda via do boleto"*. * O canal está vinculado à 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.