# Configuração do agente de IA

> Defina a personalidade, o conhecimento, as regras de classificação e os gatilhos de transferência da sua IA em cada canal.

Source: https://waslo.io/pt-BR/docs/ai-agent-configuration · Last updated: 2026-10-16

## A seção AI Agent

Abra **AI Agent** na barra lateral — ela é uma seção própria, sem ficar escondida em Configurações. Tem cinco subpáginas:

- **AI Personality** — prompt do sistema e mensagem de boas-vindas
- **Classification** — como a IA pontua leads (HOT / WARM / COLD, ou etapas com os nomes que você escolher)
- **Auto Follow-up** — quando e como a IA reativa leads sem resposta
- **Transferência para uma pessoa** — quando a IA dá um passo atrás e chama seu time
- **Voice Replies** (Growth) — a IA responde com um áudio

O catálogo de produtos não está nesta lista: ele fica em **Trabalho → Catálogo** na barra lateral. Veja [Catálogo de produtos](/docs/product-catalog).

Cada subpágina tem um **Context Selector** no topo. É lá que você escolhe se a configuração vale para o padrão da organização, para um número específico de WhatsApp ou para um canal específico (Telegram, Instagram, Messenger, Outlook; o Gmail está em acesso antecipado).

## AI Personality

Aqui você define *quem* é sua IA: identidade, tom e regras que ela deve seguir.

### Easy Setup (assistente)

1. Abra **AI Agent → AI Personality**
2. Vá para a aba **Easy Setup**
3. Escolha um template (14 segmentos disponíveis):

| Template | Indicado para |
|----------|---------------|
| Sales & Lead Closing | Qualificar leads, contornar objeções, fechar venda |
| Customer Support | Suporte técnico, FAQ, resolução de chamados |
| Appointment Booking | Agendamento genérico |
| Real Estate Agent | Consultas imobiliárias, visitas, preços |
| E-commerce Store | Dúvidas de produto, pedidos, trocas |
| Restaurant | Reservas, cardápio, viagem (take-away) |
| Beauty Salon / Spa | Agenda de serviços, remarcações |
| Clinic / Medical | Consultas, FAQ, convênio |
| Auto Dealer | Test drive, comparativos, financiamento |
| Education / Tutoring | Cursos, matrículas |
| Travel Agency | Roteiros, suporte de última hora |
| Hotel e hospitalidade | Dúvidas sobre quartos, links de reserva, retornos para eventos |
| Academia e fitness | Planos, agendamento de teste gratuito, grade de aulas |
| General Assistant | Assistente versátil para qualquer negócio |

4. Preencha os dados do seu negócio — nome, serviços, horário de funcionamento e localização. Eles viram `[PLACEHOLDERS]` no prompt gerado
5. Visualize as instruções geradas
6. Clique em **Salvar Configuração de AI**

### Modo avançado

Escreva o prompt do sistema do zero. Recomendado para negócios muito específicos ou ajuste fino. Limite de 20.000 caracteres.

**Preencha todos os campos em branco.** Os templates têm lacunas entre colchetes, como `[SEU ENDEREÇO]`. O Waslo mostra um aviso listando cada uma e não salva instruções que ainda tenham uma lacuna; do contrário, o agente inventaria a resposta.

### Mensagem de boas-vindas

Uma saudação que o Waslo envia somente quando você mesmo adiciona um lead pela página de **Leads** (há uma opção ali para pulá-la nesse lead). Ela não é enviada a leads importados por CSV nem a leads que chegam pelo webhook de leads de entrada, e nunca é enviada como resposta a um cliente que escreve primeiro; esses o agente responde diretamente, com sua resposta normal. Use `{{name}}` para inserir o nome do cliente quando ele for conhecido.

## Knowledge Base

Item de nível superior na barra lateral, dentro da seção **AI**. É o que a sua IA *sabe* sobre o seu negócio: preços, horários, catálogo, políticas, perguntas frequentes.

Fontes suportadas:
- **Upload** de PDF, DOCX, TXT e CSV (≤50 MB cada)
- **Notion** — compartilhe páginas com a integração do Waslo

Limites: 50 documentos no PAYG, 200 no Growth.

Depois de indexado, cada resposta da IA traz e cita automaticamente os trechos mais relevantes. A IA enxerga um bloco "KNOWLEDGE BASE — sua fonte autorizada" no topo de cada prompt.

## Classificação de leads

Treina a IA para pontuar cada novo lead como **HOT**, **WARM** ou **COLD** com base na análise da conversa. Edite os critérios em **AI Agent → Classification**.

Os padrões já são razoáveis; refine conforme acompanhar conversas reais.

## Follow-up automático

Quando ativado: a IA reativa qualquer lead que fique em silêncio depois que o agente falou por último, seja qual for a etapa, após o intervalo que você configurar (padrão 24 h). Envia até N follow-ups (padrão 2) e depois para. Veja [Follow-up automático](/docs/automated-follow-up).

Quando desativado: a IA responde uma vez e deixa o lead esfriar se não houver retorno.

## Transferência para humano

A IA recua quando:
- O cliente pede para falar com uma pessoa ("atendente", "humano", "agent" ou outras palavras configuradas por você)
- O tom da conversa demonstra frustração
- A classificação vira HOT e você quer assumir pessoalmente

Quando disparada: a IA para de responder naquela conversa, o lead é sinalizado na **caixa de entrada** e, se o Telegram estiver configurado, você recebe um aviso na hora.

## Como o agente escreve

- **Dialetos árabes nas respostas em texto**: o agente acompanha o dialeto do cliente quando consegue identificá-lo (do Golfo, egípcio, levantino e outros) e usa o árabe padrão moderno quando não tem certeza. Se o seu prompt disser qual árabe usar, vale o seu prompt.
- **Sem saudações repetidas**: no meio de uma conversa o agente não cumprimenta de novo nem se apresenta outra vez.
- **Idioma de resposta**: por padrão o agente responde no idioma em que cada cliente escreve ou fala. Para atender um único mercado em um único idioma, abra **Agente IA → Personalidade da IA** e escolha **Idioma de resposta**, para toda a organização ou para um número de WhatsApp ou canal. O idioma escolhido ali prevalece sobre qualquer linha de idioma das suas instruções.

## Configuração por canal + por número

Toda subpágina do AI Agent tem um **Context Selector**. Ele define o escopo:

- **Org default** — vale para tudo
- **Um número específico de WhatsApp** — sobrescreve prompt, classificação ou follow-up apenas naquele número
- **Um canal específico** — prompt diferente para o bot do Telegram, DMs do Instagram, e-mail etc.

Útil quando você quer um Telegram bot informal e uma IA do Outlook formal, por exemplo.

**Desligue o agente em um único número.** Com um número de WhatsApp selecionado, o botão **O AI agent responde neste número** na página AI Personality interrompe as respostas automáticas somente nesse número. As mensagens continuam chegando à sua caixa de entrada.

## Respostas em voz (Growth)

No plano **Growth** a IA pode responder com um áudio real, não apenas texto.

- **Modo espelho**: o áudio de um cliente recebe uma resposta falada (no idioma dele); mensagens de texto continuam em texto.
- Ative em **AI Agent → Voice Replies**, escolha uma voz por idioma (feminina / masculina + opções) e ouça antes de salvar.
- Uma cópia em texto de cada resposta falada é salva na conversa.
- Disponível hoje no WhatsApp (QR + Cloud). O árabe falado acompanha o dialeto do cliente quando consegue identificá-lo (do Golfo, egípcio, levantino e outros), como nas respostas em texto.

## Catálogo de produtos

Em todos os planos você pode dar à IA um catálogo de produtos para vender.

- Adicione produtos em **Catálogo** (barra lateral): nome, preço, botão de estoque e uma foto que você envia (e também um folheto em PDF). Você também pode importar um CSV ou sincronizar o catálogo da sua loja Shopify, Salla, Zid ou ikas.
- A IA responde perguntas de produto / preço / disponibilidade — citando só o que você adicionou, e dizendo que vai verificar quando algo não está no catálogo.
- Envia uma foto do produto quando o cliente quer ver (inline no WhatsApp / Telegram / Instagram / Messenger; um link no e-mail).
- Controle o estoque por produto para a IA não oferecer o que está esgotado.

## Próximos passos

- [Gerenciamento de leads](/docs/lead-management)
- [Integrações](/docs/integrations)
- [Transferência para humano](/docs/human-handoff)