Como Configurar o Fluxo de Prevenção de Spam de Chamados do LiveAgent com um Agente de IA para Sua Empresa

Introdução

O Fluxo de Automação de E-mail & Chat já vem pré-configurado com a lógica central e estrutura prontas. Porém, para funcionar para o seu negócio, é necessário personalizar alguns componentes-chave: credenciais de API, URLs, conexões com a base de conhecimento e políticas de resposta. Este guia mostra exatamente o que precisa ser alterado e onde encontrar cada configuração.

Checklist de Alterações Necessárias

Antes de começar, reúna estes itens:

• ✅ Chave de API do LiveAgent e URL do workspace (se for integrar)
• ✅ Seus documentos da base de conhecimento enviados para o FlowHunt
• ✅ Diretrizes de voz da marca e política de atendimento

Configurando Credenciais de API e URLs

Passo 1: Substitua as URLs da API do LiveAgent

O fluxo contém URLs de espaço reservado que devem ser substituídas pela URL real do seu workspace do LiveAgent.

1. Localize todos os nós de Solicitação de API no fluxo. E clique no botão “Editar Modelo” no prompt conectado à seção de URL.
2. Clique em cada nó para abrir as configurações
3. Encontre o campo URL contendo “YOURLINK”
4. Substitua pelo endpoint da sua API do LiveAgent (ex.: https://suaempresa.liveagent.com/api/v3/tickets)

Passo 2: Adicione Sua Chave de API do LiveAgent

Cada nó de Solicitação de API precisa de credenciais de autenticação.

1. Nas mesmas configurações do nó de Solicitação de API
2. Role até a seção Parâmetros de Consulta
3. Adicione ou atualize o cabeçalho de autorização para o Create Data conectado a essa seção:
   • apikey: insira sua chave apikey V1 do LiveAgent

Conectando Sua Base de Conhecimento

Passo 1: Configurar o Document Retriever

O agente de IA precisa de acesso à sua documentação de suporte.

1. Clique no nó Document Retriever
2. Em Categorias de Documento, selecione as categorias que contêm seus documentos de suporte
3. Ajuste o Número de Resultados (padrão: 5-10 documentos)
4. Defina o Limite de Relevância (recomendado: 0,7)

Passo 2: Verifique o Acesso aos Documentos

Antes de entrar em produção, garanta que seus documentos estão corretamente configurados:

• Documentos enviados na aba Documentos
• Categorias atribuídas corretamente
• Conteúdo atualizado e correto

Personalizando o Comportamento das Respostas

Passo 1: Personalize a Mensagem do Sistema do Agente de IA

Esta é a personalização mais importante—define como seu agente de IA irá se comportar.

1. Clique no nó Tool Calling Agent
2. Encontre o campo Mensagem do Sistema (área de texto grande)
3. Substitua ou modifique as diretrizes padrão

Principais seções para personalizar:

Idioma da Resposta:

Sempre responda em [SEU IDIOMA], independentemente do idioma de entrada.

Voz da Marca:

Use um tom [formal/informal/amigável]. Trate os clientes como [você/cliente valorizado/etc].

Regras de Citação:

Ao referenciar a documentação, cite as fontes como: [seu formato]
Inclua URLs no formato: [seu formato]

Limitações:

Não discuta: [assuntos fora do seu escopo]
Não forneça: [conselhos financeiros/informações médicas/etc]

Política de Escalonamento:

Se não puder ajudar, oriente o cliente para: [método de contato/sistema de chamados]

Problemas Comuns de Configuração

Falha na Conexão da API:

• Verifique o formato da URL (inclua https://)
• Certifique-se de que a chave de API está correta e ativa
• Confira se a URL do workspace corresponde à sua conta do LiveAgent

Agente Não Encontra Documentos:

• Verifique se os documentos estão nas categorias selecionadas
• Confira se o Document Retriever está conectado ao agente
• Certifique-se de que o conteúdo dos documentos é relevante

Respostas Não Seguem as Diretrizes:

• Revise a mensagem do sistema para maior clareza
• Verifique se a temperatura não está muito alta (>0,7)
• Teste com exemplos específicos para refinar os prompts

Detecção de Spam Muito Rigorosa/Branda:

• Ajuste o prompt de classificação de spam no nó OpenAI
• Forneça exemplos mais específicos de spam versus mensagens legítimas
• Considere adicionar lógica condicional para casos de fronteira

Suporte Multilíngue

Para clientes internacionais:

1. Modifique a mensagem do sistema para detectar o idioma de entrada
2. Adicione lógica condicional de detecção de idioma
3. Configure o agente para responder no idioma detectado

Checklist para Entrar em Produção

Antes de implantar em produção:

• ✅ Todos os espaços reservados “YOURLINK” substituídos
• ✅ Chaves de API configuradas e testadas
• ✅ Documentos da base de conhecimento verificados
• ✅ Mensagem do sistema personalizada para sua marca
• ✅ Fluxo testado com mensagens realistas de clientes

Ao concluir estas etapas de configuração, seu fluxo de automação de e-mail e chat estará personalizado para seu negócio e pronto para lidar automaticamente com as interações dos clientes.