O que são os Agentes de IA
Os Agentes de IA atendem os clientes automaticamente, antes da equipe humana entrar em ação. Diferente do Chat Flow, que segue uma árvore fixa de perguntas e opções, um Agente de IA responde de forma livre, com base no conteúdo que você cadastra (a base de conhecimento), seguindo o tom de voz que você define, podendo agir sozinho sobre o funil e as etiquetas do contato, consultando automações externas quando necessário e transferindo a conversa para a fila certa quando o assunto exige um atendente humano. De forma resumida, depois de ativo e vinculado a um canal (ou a uma interação do Chat Flow), o agente:- Recebe as mensagens do cliente e responde usando o tom de voz e as instruções definidas no seu perfil.
- Consulta a base de conhecimento (artigos e fontes importadas) para montar as respostas.
- Pode etiquetar o contato, movê-lo entre as colunas do Kanban de atendimento ou criar uma oportunidade no Funil de Vendas sozinho, no meio da conversa, sem interromper o atendimento.
- Pode acionar uma automação externa (webhook) quando o cliente pede algo que exige uma consulta, e usa a resposta recebida para responder ao cliente.
- Pode usar as ferramentas de servidores MCP (n8n, Zapier, Make, loja ou CRM) que você cadastrou e liberou, como consultar um pedido ou criar um cadastro.
- Pode consultar e reservar horário direto na Agenda do PanÐá Zap e programar o envio de uma mensagem para depois, quando o cliente pedir.
- Pode registrar, na ficha do contato, os dados que o cliente informar ao longo da conversa, e deixar anotações no próprio atendimento.
- Pode avisar a equipe (uma fila e/ou atendentes específicos) e parar de atender um contato sozinho quando a situação pedir.
- Pode consultar outro Agente de IA especialista antes de responder, sem passar a conversa para ele.
- Transfere para a equipe quando identifica um assunto que precisa de humano, quando o cliente digita a palavra de saída configurada, ou quando você definiu um destino específico para aquele tema. O destino pode ser uma fila, um fluxo do Chat Flow ou outro Agente de IA, que assume a conversa na hora.
- Se a chave da IA vencer ou a conta do provedor ficar sem crédito, transfere o atendimento na hora para a fila de emergência, com uma nota no ticket explicando o motivo, para o cliente nunca ficar sem resposta.
- Depois de transferir para um atendente, pode reservar o cliente com o mesmo destino por um tempo, para que ele volte direto para lá sem passar pela IA de novo.
- Quando o cliente para de responder, pode mandar um aviso e depois encerrar o atendimento ou transferi-lo para uma fila (com a regra Sem resposta do cliente ligada).
- Ao transferir, registra um resumo da conversa como nota interna no ticket (se essa opção estiver ligada).
Pré-requisitos
- Acesso de Administrador (ou um Perfil Personalizado com o módulo Agentes de IA e a permissão Gerenciar agentes de IA).
- Uma chave de API de um provedor de IA compatível com o padrão OpenAI (a própria OpenAI, ou serviços como LiteLLM, LocalAI e Ollama). A conta e os créditos desse provedor são de responsabilidade do assinante, não do PanÐá Zap.
- Pelo menos uma fila já criada no painel, para receber as transferências.
- Se for usar a aba Ferramentas para consultar sistemas externos: o endereço (webhook) da automação já publicado e pronto para receber requisições.
- Se for usar Servidores MCP: o endereço MCP do serviço (começando com https) e, se ele pedir, o token de acesso.
- Se for deixar o agente marcar horários: uma página de agendamento já criada no PanÐá Zap.
Criar a partir de um Modelo Pronto
Se você prefere não começar do zero, use os Modelos prontos: em poucos cliques o PanÐá Zap cria um agente pronto para usar ou uma equipe completa, já com instruções, perguntas de exemplo e dados a registrar preenchidos.Escolher o que criar
- Um agente: em Escolha um modelo, clique em um dos seis modelos da tabela abaixo.
- Equipe pronta: a Recepção entende o que o cliente precisa e passa a conversa para o especialista certo. Ela já vem marcada e fixa (“Faz a triagem e encaminha para os especialistas”); em Escolha os especialistas da equipe, marque pelo menos um.
Informar a empresa, a conexão de IA e a fila
- Mesma conexão de outro agente: usa a mesma chave, endereço e modelo de um agente que você já tem; escolha-o em Escolha o agente. A chave não é exibida. Só aparece quando já existe pelo menos um agente.
- Informar a chave: preencha a Chave da IA (obrigatória), a URL Base da API (opcional) e o Modelo (vem preenchido com
gpt-4o-mini), do mesmo jeito que na aba Provedor do agente.
Criar
- Nome, descrição e instruções de atendimento do modelo, com o nome da sua empresa já aplicado.
- Três perguntas e respostas de exemplo na base de conhecimento, desativadas, com partes entre colchetes para você completar (horários, endereço, prazos, políticas). Complete e ative cada uma na aba Conhecimento.
- Dois dados a registrar na ficha do contato, com o registro ligado (por exemplo, a Recepção registra o assunto e como o cliente conheceu a empresa).
- No Roteamento, o destino Atendimento humano, apontando para a fila de emergência que você escolheu (“Quando o cliente pedir para falar com uma pessoa ou quando você não conseguir resolver”), e a Mensagem padrão ao transferir (“Vou te encaminhar para a nossa equipe. Em instantes alguém continua o atendimento por aqui.”).
- Na equipe, a Recepção ganha um destino para cada especialista marcado, e cada especialista ganha um destino para os outros especialistas, sem voltar para a Recepção (uma troca por mudança de assunto).
Criando um Agente de IA
Abrir a tela de Agentes de IA
Preencher a aba Perfil
- A contagem começa quando a mensagem do cliente chega, então o tempo que a IA leva para responder já entra na conta.
- Com só um dos campos preenchido, o tempo é sempre o mesmo. Com os dois vazios (o padrão), o agente responde na hora.
- Os dois valores precisam ser números inteiros de 0 a 120 e o mínimo não pode ser maior que o máximo; do contrário, o agente não salva e a tela avisa.
- Durante a espera, o cliente vê “digitando…” nas conexões Baileys, Zapo, WebJs e WhatsApp oficial (WABA). Nos outros canais, o agente só espera.
- Se um atendente assumir, transferir ou encerrar o atendimento durante a espera, a resposta da IA não é enviada e o texto dela fica numa nota interna. Quando é a própria IA que transfere ou encerra, a mensagem dela sai na hora.
- O campo não aparece em agente Só base, que não atende.
Configurar a aba Provedor
- Compatível: LiteLLM (proxy de balanceamento e custos), LocalAI e Ollama (modelos locais), Vercel AI Gateway, OpenRouter, Together.ai e qualquer proxy que implemente a API da OpenAI.
- Limitações: o sufixo
/v1é obrigatório (o sistema não o adiciona sozinho); transcrição de áudio (Whisper) e voz só funcionam se o endereço aceitar/audio/*(LiteLLM: sim; Ollama e LocalAI: geralmente não); em endereços sem autenticação, como o Ollama, preencha a Chave da IA com qualquer texto; o Azure OpenAI direto não é aceito (use o LiteLLM como intermediário). - Não compatível: Anthropic Claude e Google Gemini diretos.
gpt-4o-mini). Clique em Salvar: o agente passa a aparecer na lista com o selo Ativo ou Inativo, conforme a chave Ativo da aba Perfil.Montar a base de conhecimento (aba Conhecimento)
- O bloco só funciona com Usar base de conhecimento ligado; com ela desligada, a tela avisa “Ligue a opção de usar a base de conhecimento para consultar a base de outros agentes.”
- Na Busca inteligente, a base de um agente que usa outra conexão de IA é consultada só por palavras.
- No Mapa, cada base escolhida aparece como “Base de” seguido do nome do agente. Ao excluir um agente, a confirmação lista quem usa a base dele, quem transfere para ele, quem o consulta e os canais vinculados; esses continuam funcionando, sem o agente excluído.
- Adicionar documento (PDF, DOCX, XLSX, CSV, TXT, JSON ou Markdown
.md, até 10 MB; o texto do arquivo é lido e indexado, mas documentos digitalizados, ou seja, imagens sem texto selecionável, não são aceitos) - Adicionar link: informe o Endereço da página do seu site; o texto visível da página é lido e indexado (páginas que carregam o conteúdo por script não são lidas). Ative Atualizar diariamente para a página ser lida de novo uma vez por dia e o conteúdo atualizado se tiver mudado. Documentos e links já importados têm o botão Reprocessar, para ler o conteúdo de novo.
- Importar FAQ (CSV ou JSON) (perguntas e respostas prontas). No CSV, a coluna 1 é a pergunta e a coluna 2 é a resposta, uma por linha; também dá para colar o conteúdo direto na janela. Em JSON, envie uma lista de objetos com
perguntaeresposta(ouquestioneanswer), por exemplo[{"pergunta": "Vocês entregam no mesmo dia?", "resposta": "Sim, para pedidos até as 14h."}]. A janela mostra uma prévia das primeiras linhas e avisa quando reconhece o formato JSON.
Definir o Roteamento
1 Horas) e escolha Para onde vai: Último atendente, Quem encerrou, Uma fila, Um atendente ou Um fluxo. Se o atendimento for encerrado e o cliente voltar dentro desse prazo, a conversa vai direto para o destino escolhido, sem passar pela IA de novo.Sem resposta do cliente: no fim da aba, ligue Agir quando o cliente parar de responder para o agente agir sozinho quando o cliente deixa de responder. A regra começa desligada. Ligada, preencha:Configurar a aba Ações
- Qualificação: Aplicar etiqueta ao contato, Mover o contato no funil e Criar oportunidade.
- Equipe: Anotar no atendimento e Avisar a equipe.
- Encerrar conversa: Parar a IA para este contato (só fica disponível depois de escolher uma Fila de emergência na aba Roteamento).
email; use letras e números, alguns nomes são reservados pelo sistema) e o que registrar (ex: “E-mail do cliente para envio da proposta”). Repita para cada informação relevante, até 10 dados por agente. Clique em Salvar.Configurar a aba Ferramentas
- Quando o atendimento não tem telefone (WebChat, Instagram, Messenger, Telegram ou contato sem número), a IA não reserva: envia o link da página de agendamento para o cliente escolher o horário. No WebChat, quem entrou pelo convite enviado no WhatsApp reserva normalmente. Em grupos, a Agenda não aparece para o agente.
- A mensagem agendada só é criada quando o cliente pede, sempre dentro do prazo máximo; nos canais oficiais, só dentro de 24 horas. Ela é enviada mesmo que o cliente responda antes, e, se o atendimento já estiver encerrado, a resposta do cliente abre um atendimento novo.
- Cada consulta é uma chamada de IA a mais, feita com a chave do agente consultado (o custo cai na conta do provedor dele).
- O agente consultado responde só com as próprias instruções e base de conhecimento, sem executar ações (não etiqueta, não move no funil, não transfere).
- São no máximo 2 consultas por mensagem do cliente.
- Clique em Adicionar servidor e, em Escolha o servidor, selecione o servidor (só aparecem os ativos). As ferramentas já liberadas dele vêm marcadas; desmarque as que este agente não deve usar.
- Cada agente usa até 3 servidores e até 15 ferramentas no total; o contador mostra quantas estão marcadas (por exemplo, 3/15 ferramentas).
- Ferramenta que o serviço alterou depois da liberação aparece riscada como Pausada (mudou no servidor) e deixa de ser usada até ser liberada de novo; a que saiu do servidor aparece como Não está mais liberada. Use Gerenciar servidores para abrir o cadastro sem sair do agente.
- O selo Pode alterar dados indica a ferramenta marcada como Altera dados no cadastro.
numero_pedido, marcando como Obrigatório quando não puder faltar); deixe a lista vazia para o agente mandar a pergunta do cliente em texto livre. Cada agente tem até 5 ferramentas deste tipo, com até 6 informações cada uma. Clique em Salvar.Servidores MCP
Um servidor MCP é um serviço externo (n8n, Zapier, Make, o sistema da sua loja ou o seu CRM) que oferece ferramentas prontas para a IA usar durante o atendimento, como consultar um pedido ou criar um cadastro. Você cadastra o servidor uma vez, libera uma a uma as ferramentas que a IA pode usar e, depois, escolhe na aba Ferramentas de cada agente quais delas ele usa.Abrir o cadastro
Preencher o servidor
Testar e salvar
Liberar as ferramentas
- Marque Liberada para permitir o uso.
- Ligue Altera dados quando a ferramenta grava, altera ou apaga algo no sistema de destino (por exemplo, criar um pedido). Cada uso gera uma nota interna no atendimento, a IA não repete a mesma operação sem um novo pedido do cliente e, se o resultado não for confirmado, ela avisa o cliente que está verificando e a nota pede para conferir no sistema de destino.
- Abra O que a IA recebe para ver exatamente o texto e os parâmetros que a IA recebe: é só isso que ela enxerga da ferramenta.
- Endereços da sua rede interna (como um n8n no mesmo servidor) e endereços com http só funcionam com a opção Ferramentas do agente em rede interna ligada em Configurações → Geral.
- Ao excluir um servidor, a tela lista os agentes que usam as ferramentas dele, e elas saem desses agentes.
- Alterações podem levar até 1 minuto para valer em todos os atendimentos.
Ativar e Vincular um Agente
Abra o agente em Editar, vá à aba Perfil, ligue a chave Ativo e salve. Em seguida, coloque o agente na linha de frente de uma das duas formas:- Em um canal: no menu Administração → Canais, editando o canal desejado, abrindo a seção “Agente de IA” e escolhendo o agente no campo “Agente vinculado ao canal” (a partir daí, toda conversa nova daquele canal é atendida primeiro por ele; se o canal tiver um fluxo padrão, a tela avisa que o agente terá prioridade e atenderá as conversas novas). Nos atendimentos novos, o agente fica no lugar do ChatGPT ligado para todos os atendimentos; os que já estavam abertos antes do vínculo seguem como estavam (a seção mostra esse aviso). Na tela Canais, o cartão do canal passa a mostrar o selo Agente de IA; com o agente inativo, o nome dele aparece seguido de (inativo: não assume atendimentos). Vale também para o WebChat: o chat do seu site passa a ser atendido pelo agente vinculado, e o visitante nunca vê as notas internas da equipe.
- Em um fluxo: no próprio Chat Flow (Automação → Chat Flow), editando o passo em que o pré-atendimento deve começar, clicando em “Adicionar interação” e escolhendo “Agente de IA” (ele assume a conversa a partir daquele ponto do fluxo).
Ver o Agente no Mapa
Na lista de agentes, o botão Mapa abre o Mapa do agente: um desenho só de leitura com tudo o que já foi montado nele, em um lugar só:- os canais vinculados (ou o aviso de que nenhum canal está vinculado);
- o provedor, o estilo de atendimento e quantas mensagens o agente lembra;
- a base de conhecimento (artigos e trechos importados, ou “Base desligada”);
- os destinos de transferência (fila, atendente, fluxo ou outro Agente de IA), a palavra de saída e a fila de reserva;
- as ações configuradas (etiqueta, funil, oportunidade, anotação, aviso à equipe, parar a IA), os dados a registrar e as ferramentas (Agenda, mensagem agendada, agentes consultados, ferramentas de servidores MCP, automações externas).
Duplicar um Agente
O botão Duplicar, na lista de agentes, cria uma cópia do agente junto com a base de conhecimento. A cópia aparece com o mesmo nome e o sufixo “(cópia)”.Duplique
Renomeie e ajuste
Ative quando aprovar
Agente Só Base de Conhecimento
Um agente Só base não atende clientes: ele serve apenas como uma biblioteca de conhecimento para outros agentes usarem. É a forma de manter em um lugar só o que vários agentes precisam saber, como políticas, preços e horários.Criar o agente só de base
Montar a base
Escolher a base nos agentes que atendem
- Ativo fica desligado e travado (“Agente só de base fica sempre inativo.”), e a lista de agentes mostra o selo Só base no lugar de Ativo ou Inativo.
- As abas Roteamento, Ações e Ferramentas e o campo Atraso na resposta não aparecem, porque o agente não responde nem executa nada. Ficam as abas Perfil, Provedor e Conhecimento.
- Na aba Conhecimento, o interruptor Usar base de conhecimento não aparece (a base vale para quem a escolher); a Busca inteligente continua disponível.
- Ele não aparece na lista para vincular a canais (Agente vinculado ao canal) nem no campo Agente de IA da interação do Chat Flow. Se um canal ou fluxo já estava vinculado a ele antes, o Mapa do agente mostra o alerta.
Agentes Trabalhando Juntos
Você pode montar uma equipe de Agentes de IA, cada um especialista em um assunto (por exemplo: um de pré-atendimento, um de vendas e um de suporte técnico). Há duas formas de um agente contar com outro:Monitorando Conversas ao Vivo
Enquanto o agente conversa com o cliente, o ticket fica na aba Pendentes de Atendimentos, com um ícone indicando que quem está respondendo é o Agente de IA. A equipe pode abrir o ticket e assumir a conversa a qualquer momento, respondendo normalmente no lugar da IA, ou simplesmente deixar em Pendentes e o agente continua atendendo sozinho. Para tirar a IA de um atendimento específico sem esperar que ela transfira, use Desligar agente de IA no menu de três pontinhos da conversa (ou o botão Desligar do cartão Agente de IA, na aba Linkar do painel de detalhes do contato): a IA para de responder aquele contato na hora, só naquele atendimento, e não volta sozinha ali (só por um fluxo do Chat Flow com o bloco do agente). Para só interromper a IA por um tempo, use Pausar agente de IA no mesmo menu, o botão Pausar do cartão Agente de IA ou o ícone do robô no card do atendimento em Pendentes: o agente para de responder só neste atendimento e não gasta nada enquanto estiver pausado, e o cartão mostra Pausado neste atendimento. Retomar agente de IA (ou o botão Retomar) faz ele voltar a responder. Já o Bloquear chatbot do contato (cartão na aba Gestão do painel de detalhes, ou coluna Bl. Chatbot em Contatos) vale para o fluxo e para o agente de IA: se o agente estiver atendendo, ele é desligado na hora, e desbloquear não religa: o agente volta só num atendimento novo. O passo a passo está na página Caixa de Entrada. Quando o agente transfere a conversa (pela palavra de saída, por identificar que o assunto exige humano, ou por um destino configurado no Roteamento) e o “Resumo automático na transferência” está ligado, ele registra uma nota interna no ticket neste formato:- Motivo (IA): explicando por que a conversa foi transferida.
- Um resumo em texto corrido dos principais assuntos tratados.
- Fontes usadas: os artigos ou fontes da base de conhecimento que embasaram as respostas.
Resumo das Funcionalidades
Benefícios e Quando Usar
Com o agente ativo, o pré-atendimento roda sozinho: o cliente é respondido na hora, no tom da sua empresa e com base no seu próprio conteúdo, pode ter o funil e a ficha de contato atualizados automaticamente, e só chega à equipe humana quando realmente precisa, já com um resumo da conversa registrado na nota interna. É a ferramenta certa quando:- a operação tem grande volume de perguntas variadas (que um menu fixo do Chat Flow não cobre bem);
- você quer capturar dados em conversa livre em vez de um roteiro rígido de perguntas;
- é necessário consultar sistemas externos (como status de pedido) respondendo em linguagem natural.
Solução de Problemas
Copiloto de IA
Sobre o Painel Bots e IA
- Construtores de Fluxo e Automação: Typebot, N8N, Dify e DialogFlow.
- Modelos de Inteligência Artificial (LLMs): ChatGPT, Grok, Gemini, Qwen, Claude, Deepseek, Ollama e LM Studio.
Abra a aba Bots IA
Defina o idioma padrão da IA
Escolha o provedor
Habilite o provedor
Automação total (opcional)
Vincule as credenciais ao canal (passo final obrigatório)
Principais Funções do Copiloto
Configurando o Copiloto de IA
Abra a sub-aba Copiloto de IA
Habilite o Copiloto
Escolha o Provedor de IA
Gere a chave de API
platform.openai.com, vá em “API Keys” e crie uma nova; no Google (Gemini), acesse o Google AI Studio e clique em “Get API Key”; para os demais, acesse o portal de desenvolvedor do provedor.Cole a API Key
/v1) de um serviço compatível, como LiteLLM, LocalAI ou Ollama. Depois de salva, a chave fica oculta e o campo avisa Valor salvo e oculto por segurança. Para trocar, digite um novo. Com uma chave salva, trocar o Provedor de IA ou a URL Base da API apaga a chave: digite a chave de novo (a tela avisa Trocar o endereço ou o provedor apaga a chave salva; depois, digite a chave de novo.).Escolha o Modelo
Personalize o comportamento
Ative os extras e teste
Usando o Copiloto no Atendimento
Analisar sentimento ou pedir sugestão
Reescrever uma mensagem
Resumir uma conversa longa

