Pular para o conteúdo principal
Funcionalidade em Beta. Os Agentes de IA ainda estão em fase beta no PanÐá Zap: use com acompanhamento próximo, revise as respostas com frequência e trate eventuais comportamentos inesperados como esperados de uma funcionalidade em evolução.
Quem usa: Administrador (configuração completa do agente exige acesso de Administrador). Supervisores e Atendentes participam do resultado no dia a dia: podem abrir e assumir, a qualquer momento, um ticket que está sendo atendido pela IA, na aba Pendentes de Atendimentos.

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.
Atenção ao consumo: cada resposta do agente consome créditos/tokens na conta do provedor de IA (OpenAI ou equivalente), e cada consulta a outro agente é uma chamada a mais, na chave do agente consultado. Com Decidir etiquetas e funil depois de cada mensagem ligado (aba Ações, já vem ligado), cada mensagem do cliente gera também uma chamada de IA a mais. O custo é cobrado diretamente pelo provedor: monitore o uso no painel dele, não apenas dentro do PanÐá Zap. Se os créditos acabarem, o agente transfere os atendimentos para a Fila de emergência até a conta ser recarregada.

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.
Onde fica: no menu Automação → Agentes de IA, o botão Modelos prontos aparece ao lado de Novo Agente, no topo da tela. Como os demais botões de criação, ele exige acesso de Administrador ou a permissão Gerenciar agentes de IA.
1

Escolher o que criar

Clique em Modelos prontos. A janela abre com dois modos:
  • 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.
Clique em Continuar.
2

Informar a empresa, a conexão de IA e a fila

Na segunda etapa, preencha:As opções de Conexão de IA são:
  • 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.
A janela já abre com uma opção marcada: confira antes de seguir.
3

Criar

Clique em Criar (ou em Voltar para mudar a escolha anterior). Se for um agente só, a tela confirma “Agente criado. Revise as instruções antes de ligá-lo a um canal.” e abre o agente no editor, para você revisar. Se for a equipe, a tela confirma “Equipe criada com N agentes.” e abre o Mapa da Recepção, que mostra as ligações entre os agentes.
O que cada agente criado já traz:
  • 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).
O que dá para editar depois: tudo. Os agentes criados pelos modelos são agentes comuns: aparecem na lista, e você ajusta instruções, base de conhecimento, dados a registrar, destinos e conexão em Editar, como em qualquer outro, além de poder duplicar ou excluir.
O modelo não liga o agente a nenhum canal nem fluxo. Antes de colocá-lo para atender, revise as instruções, complete as perguntas de exemplo e siga os passos de Ativar e Vincular um Agente.

Criando um Agente de IA

1

Abrir a tela de Agentes de IA

No menu lateral, abra o grupo Automação, clique em Agentes de IA e depois em Novo Agente, no canto superior direito.A janela “Novo Agente de IA” tem seis abas: Perfil, Provedor, Conhecimento, Roteamento, Ações e Ferramentas. Só a aba Conhecimento fica bloqueada até o agente ser salvo pela primeira vez (a janela avisa “Salve o agente para cadastrar a base de conhecimento.”): preencha as demais abas, clique em Salvar e reabra o agente em Editar para montar a base de conhecimento.
2

Preencher a aba Perfil

Defina a identidade e o comportamento do agente:Como funciona o Atraso na resposta: a cada resposta, o agente espera um tempo sorteado entre o mínimo e o máximo, para a conversa parecer mais natural. O ícone de ajuda ao lado do rótulo abre o quadro “Como funciona o atraso na resposta”.
  • 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.
  • Com a opção Habilitar espera no processamento de mensagens com integrações externas ligada, o que o cliente escrever durante a espera é ignorado pela IA, inclusive a palavra de saída. Com a opção desligada, cada mensagem do cliente recebe a própria resposta, uma depois da outra.
  • No WhatsApp oficial (WABA), o “digitando…” marca a mensagem do cliente como lida.
  • Tempos altos deixam o cliente esperando. O limite é de 120 segundos, e se o sistema for reiniciado durante a espera, aquela resposta não é enviada.
3

Configurar a aba Provedor

Informe as credenciais do modelo de linguagem e o ajuste fino do comportamento:Endereço próprio (URL Base da API): o ícone de ajuda ao lado do rótulo abre o quadro URL Base da API (OpenAI-compatible), com o que funciona e o que não funciona:
  • 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.
Com endereço próprio, o agente usa esse endereço e o modelo escolhido também para ler imagens, transcrever áudios e responder em voz. Para ver imagens, o modelo precisa aceitar imagens: se não aceitar, o agente recebe só o texto escrito na imagem. Se o endereço não oferecer transcrição ou voz, o agente pede ao cliente para escrever e a resposta sai em texto. Agente sem endereço próprio, num canal com URL Base da API (OpenAI) preenchida na seção ChatGPT: esse endereço recebe só a chave da conexão. Se a chave do agente for diferente, ela vai ao endereço padrão do provedor, salvo quando o endereço do canal é local (localhost, rede interna) ou um dos gateways públicos OpenRouter, DeepSeek, Together, Groq, Mistral e xAI. Para o agente usar um endereço próprio, preencha a URL Base da API (OpenAI) na aba Provedor dele.Para gerar a chave da OpenAI, acesse o site oficial da OpenAI, vá em “API Keys” e crie uma nova; use o nome do modelo exatamente como o provedor documenta (o campo Modelo sugere uma lista de modelos e vem preenchido com 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.
4

Montar a base de conhecimento (aba Conhecimento)

Reabra o agente em Editar e vá até a aba Conhecimento.Ative Usar base de conhecimento (com ela ligada, o agente responde usando os artigos e fontes cadastrados como fonte principal) e, opcionalmente, ative Busca inteligente para o agente entender sinônimos e o sentido da pergunta, não apenas as palavras exatas (essa busca usa a mesma chave de IA do agente).Usar também a base de outros agentes: junto com a própria base, o agente consulta a base dos agentes que você escolher (até 3), inclusive de agentes inativos ou Só base. É bom para políticas, preços e horários que vários agentes precisam saber. Clique em Adicionar base, escolha o agente em Escolha um agente e repita para cada base; o ícone Remover base tira uma da lista. O agente em edição não aparece como opção.
  • 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.
Para adicionar artigos: clique em Adicionar artigo, preencha Título e Conteúdo (obrigatório, escrito como você explicaria ao cliente), deixe o artigo Ativo, salve, e repita para cada dúvida frequente ou informação relevante do negócio.No bloco Fontes importadas você pode aproveitar conteúdo já pronto:
  • 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 pergunta e resposta (ou question e answer), 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.
Clique em Salvar.
5

Definir o Roteamento

Ative Transferência inteligente para a IA identificar o assunto da conversa e transferir para o destino certo, no momento adequado.Clique em Adicionar destino e preencha, para cada um:Adicione quantos destinos forem necessários. Em Mensagem padrão ao transferir, escreva a mensagem usada pelos destinos que não têm mensagem própria, para o cliente nunca ficar sem resposta no momento da transferência. Mantenha Resumo automático na transferência ligado, para o agente registrar um resumo da conversa como nota interna para a equipe. Em Fila de emergência, escolha uma fila para receber a conversa caso a IA falhe, garantindo que o cliente nunca fique sem resposta; deixe em Nenhuma apenas se você já tiver outro tratamento para falhas. Isso vale também quando a chave da IA é inválida ou venceu e quando a conta do provedor fica sem crédito: o atendimento é transferido na hora para essa fila, com uma nota no ticket explicando o motivo.
Outro agente de IA: são no máximo 3 trocas entre agentes por atendimento. Depois disso, a conversa vai para a Fila de emergência. Por isso, configure a Fila de emergência em todos os agentes que passam conversas entre si.
Ao encerrar: em Motivos que a IA pode escolher, marque as demandas que a IA pode registrar quando encerrar o atendimento (até 10). A lista mostra as demandas cadastradas em Gestão Comercial → Fechamento, aba Demandas. Sem nenhuma marcada, o atendimento é encerrado sem motivo.Depois de transferir para um atendente: ative Reservar o cliente por um tempo, defina o Prazo (número e unidade, por exemplo 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:Os tempos são minutos inteiros de 1 a 1440 (até 24 horas) e as mensagens aceitam até 1.000 caracteres; com um tempo fora disso, o agente não salva e a tela avisa Use um tempo de 1 a 1440 minutos. Se o cliente responder, a conversa segue normal com o agente. O ícone de ajuda ao lado do título Sem resposta do cliente explica a contagem.
  • Nos canais oficiais, no Instagram e no Messenger com a janela de 24 horas fechada, e nos canais de comentário (YouTube, TikTok, LinkedIn), a ação acontece sem mandar mensagem. Atendimento com reclamação do Mercado Livre fica fora da regra.
  • Atendimento pausado ou com mensagem agendada ainda por sair não entra.
  • Com esta regra ligada, o encerramento automático do canal ou da empresa não age nos atendimentos deste agente.
  • Se o atendimento já tiver atendente, Transferir para uma fila só desliga o agente.
Clique em Salvar.
6

Configurar a aba Ações

Na aba Ações você define o que o agente pode fazer sozinho durante a conversa, além de responder. Clique em Adicionar ação (até 10 por agente) e, em O que fazer, escolha o tipo. As opções ficam em três grupos:
  • 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).
Decidir etiquetas e funil depois de cada mensagem: interruptor no topo da aba, que já vem ligado. Com ele ligado, depois que o agente responde, uma chamada curta à IA lê a conversa e aplica as etiquetas e a etapa do funil das ações Aplicar etiqueta ao contato e Mover o contato no funil, sem atrasar a resposta ao cliente. Essas ações passam a mostrar a nota Decidida depois de cada mensagem do cliente, sem atrasar a resposta. e ficam sem o campo Mensagem ao cliente (o texto já salvo fica guardado). Desligado, o agente volta a decidir etiquetas e funil durante a resposta. Aqui, “funil” é a coluna do Kanban de atendimento, e a decisão só avança o contato, seguindo a ordem das colunas em Configurações → CRM → Colunas.
  • Consome uma chamada de IA a mais por mensagem do cliente. Se a empresa usa os Créditos de IA, essa chamada aparece no consumo como Qualificação do agente.
  • A etiqueta aparece alguns segundos depois da resposta.
  • Cada etiqueta e cada etapa entram no máximo uma vez por atendimento: o que alguém da equipe tirar não volta naquele atendimento.
  • O funil só avança, na ordem em que o quadro mostra as etapas.
  • Não roda em grupos.
  • Se o provedor de IA avisar limite de uso ou ficar fora do ar, a decisão pausa sozinha por 10 minutos.
Os campos mudam conforme o tipo escolhido:Em todas as ações preencha também:Em Mensagem padrão das ações, cadastre uma mensagem de reserva para qualquer ação sem mensagem própria; sem ela, a ação pode acontecer silenciosamente.Dados a registrar (no fim da mesma aba Ações): o agente anota, na ficha do contato, o que o cliente informar durante a conversa, para quem assumir depois já encontrar tudo preenchido. Ative Registrar dados na ficha do contato, clique em Adicionar dado e preencha o nome do dado (ex: 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.
  • Criar oportunidade não cria uma segunda oportunidade se o contato já tiver uma aberta no mesmo funil.
  • Anotar no atendimento grava no máximo 3 anotações por atendimento.
  • Avisar a equipe toca uma vez por atendimento e exige escolher uma fila ou pelo menos um atendente; sem isso a ação não salva.
  • Parar a IA para este contato bloqueia o chatbot daquele contato (o fluxo e o agente de IA deixam de responder): para a IA voltar a atendê-lo, é preciso desbloquear o chatbot no cadastro do contato, e ela volta só num atendimento novo.
7

Configurar a aba Ferramentas

Configure o que mais o agente pode consultar e fazer: a Agenda, mensagens agendadas, outros Agentes de IA, servidores MCP e automações externas. (Os Dados a registrar na ficha do contato ficam na aba Ações.)Agenda: o agente consulta horários livres e reserva direto na Agenda do PanÐá Zap, sem ferramenta externa. Ative Deixar a IA consultar horários e reservar, escolha a Página de agendamento (obrigatório) e, em Serviços que a IA pode oferecer (obrigatório), marque quais serviços dessa página o agente pode oferecer ao cliente (até 5; um serviço que pede perguntas obrigatórias no formulário aparece desabilitado, porque ainda não pode ser reservado pela IA). Em páginas com profissionais, vale o primeiro disponível na ordem da página. A confirmação, com o link para cancelar ou remarcar, é enviada pela própria página de agendamento. Se o fuso da página for diferente do Fuso horário do agente (aba Perfil), os horários são convertidos para o fuso do agente antes de chegarem ao cliente.Mensagem agendada: o agente programa o envio de uma mensagem futura quando o cliente pedir (por exemplo “me chama na sexta”). Ative Deixar a IA agendar uma mensagem para depois e defina a Antecedência máxima (dias), o prazo mais distante que o agente pode usar (de 1 a 7 dias; o padrão é 7).
  • 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.
Consultar outros agentes: antes de responder, este agente pode fazer uma pergunta a outro Agente de IA especialista. Quem responde ao cliente continua sendo este agente. Clique em Adicionar agente e preencha, para cada um:Dá para cadastrar até 5 agentes para consulta.
  • 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.
Servidores MCP: liga o agente a ferramentas prontas de serviços externos (n8n, Zapier, Make, o sistema da sua loja ou o seu CRM), como consultar um pedido ou criar um cadastro. Os servidores são cadastrados e as ferramentas são liberadas antes, no botão Servidores MCP (veja a seção Servidores MCP, mais abaixo). Aqui você escolhe quais servidores e ferramentas este agente usa:
  • 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.
Cada ferramenta marcada entra em todas as mensagens do agente e aumenta o consumo da IA: marque só as necessárias. A IA envia ao serviço os dados da conversa necessários para usar a ferramenta. Em cada mensagem, as ferramentas MCP somam no máximo 30 segundos de espera.
Ferramentas (automações externas): conecta o agente a um webhook externo; quando o cliente pede algo que exige consulta, o agente aciona a automação e responde com o resultado, enviando a cada consulta os dados do atendimento (contato, protocolo, e o que o agente precisa saber). Clique em Adicionar ferramenta e preencha:Em “Informações que o agente envia”, adicione cada dado que a automação precisa receber (ex: 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.
O botão Servidores MCP aparece para quem gerencia os Agentes de IA; Atendentes não têm acesso ao cadastro. Cada empresa cadastra até 10 servidores.
A IA envia ao serviço os dados da conversa necessários para usar a ferramenta, então cadastre só serviços de confiança. Cada ferramenta ligada em um agente entra em todas as mensagens dele e aumenta o consumo da IA.
1

Abrir o cadastro

Em Automação → Agentes de IA, clique em Servidores MCP, no topo da lista de agentes. Se houver ferramentas pausadas, o botão mostra quantas (por exemplo, 1 pausada). O mesmo cadastro também abre pelo botão Gerenciar servidores, na aba Ferramentas do agente. Clique em Adicionar servidor.
2

Preencher o servidor

O token fica guardado protegido e nunca é mostrado de novo. Ao editar o servidor, deixe o campo em branco para manter o token salvo, ou use Remover token. Se você trocar o endereço ou a autenticação, digite o token de novo. O login por OAuth (botão Conectar do serviço) não é suportado.
3

Testar e salvar

Testar confere a conexão sem salvar e mostra, por exemplo, Conectado: 4 ferramentas encontradas. Ao clicar em Salvar, o PanÐá Zap já confere as ferramentas do servidor. Se algo falhar, a tela explica o motivo (endereço sem https, serviço fora do ar, token recusado, serviço que exige OAuth, resposta fora do formato MCP ou grande demais, ou redirecionamento para outro endereço: use o endereço final).
4

Liberar as ferramentas

Nenhuma ferramenta funciona sem a sua liberação. Para cada ferramenta do servidor:
  • 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.
Clique em Salvar aprovações. Depois, escolha as ferramentas liberadas na aba Ferramentas de cada agente.
Situação de cada ferramenta: O servidor mostra Funcionando, Com erro ou Ainda não conferido, com a data da Última conferência. A conferência acontece sozinha uma vez por dia; use Atualizar ferramentas para conferir na hora.
  • 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).
Use o Mapa antes de ativar o agente, para revisar se nada ficou faltando, e para explicar à equipe como ele vai se comportar. Para alterar qualquer item, use o botão Editar do próprio Mapa, que abre o agente direto no editor.

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)”.
1

Duplique

Na linha do agente, clique em Duplicar.
2

Renomeie e ajuste

Abra a cópia em Editar, troque o nome e faça os ajustes que quer testar (instruções, modelo, destinos, ações).
3

Ative quando aprovar

A cópia é independente do original: ligar, desligar ou editar uma não afeta a outra.
Benefícios e quando usar: testar uma mudança de instruções ou de modelo sem mexer no agente que já está atendendo, ou criar rapidamente um agente parecido para outro canal ou setor.
Antes de ativar a cópia, confira no Mapa a quais canais ela está vinculada, para não ter dois agentes disputando o mesmo canal.

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.
1

Criar o agente só de base

Crie ou edite um agente, vá à aba Perfil e ligue Só base de conhecimento. A própria tela explica: “Não atende clientes: guarda conhecimento para outros agentes usarem. Fica sempre inativo e não aparece para vincular a canais ou fluxos.”Se o agente já é usado por outros agentes, canais ou fluxos, ao ligar o interruptor a tela avisa “Ao marcar, este agente para de atender. Hoje ele é usado por:” e lista quem usa a base dele, quem transfere para ele, quem o consulta e os canais vinculados, com o lembrete de que fluxos que acionam este agente também deixam de usá-lo.
2

Montar a base

Salve, reabra o agente em Editar e cadastre artigos e fontes importadas na aba Conhecimento, como em qualquer agente. A aba mostra a nota “Esta base é consultada pelos agentes que a escolherem na aba Conhecimento deles.”
3

Escolher a base nos agentes que atendem

Em cada agente que deve usar esse conteúdo, abra a aba Conhecimento e, em Usar também a base de outros agentes, clique em Adicionar base e escolha o agente (ele aparece com a marca “(só base)”).
O que muda em um agente Só base:
  • 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:
Mantenha a base de conhecimento de cada especialista focada no assunto dele e descreva bem o “Quando transferir” e o “Quando consultar”: é essa descrição que a IA lê para decidir. Use o Mapa de cada agente para conferir os vínculos entre eles.

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.
Isso permite que quem assumir o atendimento entenda o histórico sem reler a conversa inteira.

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.
  • É uma funcionalidade em Beta: acompanhe de perto, revise os artigos da base de conhecimento periodicamente para manter as respostas corretas, e trate o comportamento do agente com o mesmo cuidado que se daria a um atendente novo em treinamento.
  • O custo de cada resposta é cobrado pelo provedor de IA, não pelo PanÐá Zap; monitore o consumo diretamente no painel do provedor escolhido.
  • Cuidado com edição simultânea da ficha do contato: se alguém abrir a ficha e salvar depois que o agente já anotou algo ali, a edição do agente pode ser sobrescrita.

Solução de Problemas


Copiloto de IA

Quem usa: Administrador (configuração do provedor/modelo/prompt); uso diário por Atendentes na tela de atendimento, com visibilidade para Supervisores acompanharem a qualidade das sugestões.
O Copiloto de IA é um assistente inteligente integrado à tela de atendimento que usa modelos de linguagem avançados (ChatGPT, Grok, Claude ou Gemini) para apoiar o Atendente em tempo real: analisa o sentimento das conversas, sugere respostas contextuais, reescreve textos e resume históricos longos.
Diferente do Agente de IA (que assume o atendimento sozinho, de ponta a ponta), o Copiloto de IA atua ao lado do Atendente humano: ele sugere, resume e reescreve, mas quem envia a mensagem final é sempre a pessoa.

Sobre o Painel Bots e IA

Quem usa: Administrador (habilitação e configuração das chaves); Atendentes e Supervisores usam os recursos de IA resultantes diretamente na tela de atendimento.
O painel Bots e IA (Configurações → aba Bots IA) centraliza e gerencia todas as ferramentas de automação e modelos de linguagem (LLMs) que vão operar no sistema, incluindo o provedor que alimenta o Copiloto de IA. A plataforma tem integração nativa com:
  • 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.
Como habilitar um provedor de IA para os canais:
1

Abra a aba Bots IA

Clique no menu Configurações e selecione a aba Bots IA.
2

Defina o idioma padrão da IA

Na página Bots e IA (seção Idioma padrão da IA), escolha em Idioma das respostas de IA o idioma principal do seu público (ex.: Português). É o idioma que a IA usa para descrever imagens e mídias recebidas e para sugerir ou reescrever mensagens para o cliente nos atendimentos. Por padrão, o campo fica em Seguir a Região, opção que acompanha o Idioma das mensagens ao cliente definido em Configurações → Gerais → Geral, no card Região e idioma: se esse idioma for trocado depois, a IA passa a usar o novo sem você voltar aqui. Sem idioma definido naquele card, a IA responde em Português. Para fixar a IA em um idioma próprio, escolha-o na lista.
3

Escolha o provedor

No menu lateral de Bots IA, clique no provedor desejado (por exemplo, ChatGPT).
4

Habilite o provedor

Ative a chave Habilitar [Nome da IA]: sem isso, a IA não aparece como opção nos canais. A página do provedor não tem campo de chave: a API Key é informada nas configurações de cada canal (último passo). Depois de ajustar as chaves desta página (inclusive Habilitar para todos os tickets, do próximo passo), clique em Salvar, no topo da página do provedor.
5

Automação total (opcional)

Se quiser automação total, ative também Habilitar para todos os tickets: a IA passará a processar e responder automaticamente os atendimentos, sem necessidade de ativação manual ticket a ticket. No ChatGPT, a opção liga o ChatGPT nos atendimentos novos e nos que estão em andamento dos canais que têm API Key; canal sem API Key fica sem ChatGPT. Atendimento com Agente de IA não muda: o agente segue respondendo, e desligar esta opção também não o desliga.
6

Vincule as credenciais ao canal (passo final obrigatório)

Vá até o menu Canais e insira as credenciais (API Keys/Tokens) dentro das configurações de cada número/conexão que efetivamente usará aquela inteligência artificial. Habilitar o provedor em Bots IA é só o primeiro passo. A página do ChatGPT lembra isso no aviso A API Key fica em cada canal: a chave do ChatGPT vai no campo ChatGPT API Key da seção ChatGPT de cada canal (Administração → Canais, Editar). Chave salva depois vale para os atendimentos novos; num atendimento já aberto, ligue o ChatGPT na aba Linkar do painel de detalhes do atendimento. Canal com Agente de IA vinculado começa os atendimentos novos com o agente.
Benefícios e quando usar: ative os construtores de fluxo (Typebot, N8N, Dify, DialogFlow) quando quiser montar chatbots e automações visuais sem programar do zero. Ative os provedores de LLM quando quiser recursos de inteligência artificial nos atendimentos: descrição automática de imagens, geração de texto, e a base para o Copiloto de IA.
  • A ativação dos provedores de IA é por conta do assinante. É preciso criar uma conta e configurar o provedor por fora (no site da OpenAI, Google, Anthropic, Groq etc.) e só depois habilitar dentro do PanÐá Zap.
  • Na página Bots e IA, a escolha do idioma é salva automaticamente. Já nas páginas de cada provedor (ChatGPT, Gemini etc.) e na do Copiloto de IA, clique em Salvar, no topo da página, para gravar as alterações.

Principais Funções do Copiloto

Configurando o Copiloto de IA

1

Abra a sub-aba Copiloto de IA

No menu lateral, clique em Configurações, selecione a aba Bots IA e depois a sub-aba Copiloto de IA.
2

Habilite o Copiloto

Ative a chave Habilitar Copiloto.
3

Escolha o Provedor de IA

Em Provedor de IA, escolha entre OpenAI (ChatGPT), xAI (Grok), Anthropic (Claude) ou Google (Gemini).
4

Gere a chave de API

Gere a chave no site do provedor escolhido antes de continuar: na OpenAI (ChatGPT), acesse 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.
5

Cole a API Key

Cole a API Key no campo correspondente. Com o provedor OpenAI aparece também o campo opcional URL Base da API: deixe em branco para a OpenAI oficial, ou informe o endereço completo (com /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.).
6

Escolha o Modelo

Em Modelo, escolha um dos modelos sugeridos na lista do campo (ela muda conforme o provedor) ou digite o nome exato indicado pelo provedor. Evite modelos antigos: o Google, por exemplo, já desligou os modelos Gemini 1.5.
7

Personalize o comportamento

No campo Prompt personalizado, descreva o tom, o contexto do negócio e as regras que o Copiloto deve seguir (exemplo: “Você é um assistente de suporte da empresa X. Seja direto, educado e use informações do nosso catálogo de produtos para sugerir respostas”); em branco, vale o prompt padrão. Se quiser, defina também o Limite de tokens (resposta).
8

Ative os extras e teste

Ligue, se quiser, Ícone de reescrita sempre visível (o botão de reescrever fica na barra de mensagem mesmo sem texto digitado), Sugestões automáticas (uma sugestão aparece ao abrir o atendimento) e Análise automática de sentimento (analisa o cliente ao abrir o atendimento e avisa quando ele parece frustrado). Use o botão Testar, no topo da página, para confirmar que a chave e o modelo funcionam, e clique em Salvar.

Usando o Copiloto no Atendimento

1

Analisar sentimento ou pedir sugestão

Abra um chat, clique no ícone Mais opções (três pontinhos na barra de mensagem) e selecione Copiloto (o item só aparece com o Copiloto habilitado). No painel, use Analisar em Sentimento do cliente, veja as Sugestões rápidas e use Sugerir em Sugestão de resposta; depois clique em Usar para levar o texto ao campo de mensagem, ou em Copiar.
2

Reescrever uma mensagem

Digite o texto, abra Mais opções e escolha Reescrever com IA → Profissional, Simpático, Marketing ou Corrigir ortografia. Com Ícone de reescrita sempre visível ligado nas configurações do Copiloto, o botão de reescrever fica direto na barra de mensagem.
3

Resumir uma conversa longa

Em Mais opções, escolha Resumir conversa com IA e defina o Período, Mensagens de (Todos, Apenas contato ou Apenas eu), o Tipo de resumo (Resumo geral, Pontos principais, Próximos passos ou Análise de sentimento), o Máximo de mensagens e onde Inserir resultado em (Campo de mensagem ou Visualizar no diálogo). Clique em Gerar Resumo.
Benefícios e quando usar: é especialmente útil quando um Atendente recebe um ticket com um histórico extenso (por exemplo, 50 mensagens): em vez de ler tudo, ele usa a função Resumir, depois pede uma Sugestão de Resposta e aplica a Reescrita para deixar o tom mais acolhedor antes de enviar.
Dicas ao configurar o provedor de IA (qualquer um deles):
  • Modelo “não disponível para contas novas”: provedores de IA descontinuam e renomeiam modelos com frequência. Se ao clicar em Testar aparecer um erro dizendo que o modelo escolhido não está mais disponível para chaves/projetos novos, isso não é um problema do PanÐá Zap: basta trocar para um modelo mais recente da mesma família na lista de opções do provedor (nunca deixe o campo Modelo em branco, preencha sempre um valor válido).
  • Nível gratuito x pago: no nível gratuito da maioria dos provedores de IA, o conteúdo das conversas enviado para gerar sugestões pode ser usado pelo próprio provedor para melhorar seus modelos, o que é relevante do ponto de vista de LGPD ao lidar com dados de clientes reais. Para uso em produção, prefira ativar o nível pago/faturamento do provedor escolhido.
  • Sempre use o botão de teste da própria tela (quando disponível) antes de salvar, para confirmar que a chave e o modelo escolhidos estão funcionando.
Dicas e observações importantes:
  • Consumo de créditos: o uso da API gera custos diretamente no provedor escolhido (OpenAI, Google etc.). Monitore o consumo nas plataformas originais.
  • Privacidade: evite enviar dados sensíveis de clientes para a IA se a política de privacidade da sua empresa não permitir o processamento de dados em nuvens de terceiros.
  • Revisão humana obrigatória: o Copiloto sugere respostas, mas o Atendente deve sempre revisar o texto antes de enviar, para garantir a precisão das informações.