Principal Recursos explicados Como usar bots de agente?

Como usar bots de agente?

Última atualização em Feb 05, 2025

Integração do AgentBot com o FalAIChat

O AgentBot pode ser integrado à sua caixa de entrada do FalAIChat para automatizar o atendimento ao cliente.

📌 Com o FalAIChat, você pode conectar a lógica do seu bot personalizado por meio da API do AgentBot para gerenciar conversas em tempo real.

📌 Todas as novas conversas receberão automaticamente o status "bot" e o FalAIChat enviará eventos para o URL do seu bot via webhook, permitindo que ele responda dinamicamente.


Como Funciona o AgentBot?

Aqui está um fluxo de trabalho típico do AgentBot:

Recebe eventos como widget_triggered, message_created e message_updated com base na interação do cliente.
Processa as informações recebidas e gera uma resposta apropriada.
Consulta APIs externas para coletar dados adicionais do cliente (ex: status do pedido).
Utiliza serviços como Rasa, Dialogflow ou Lex para reconhecimento de intenções.
Envia respostas automatizadas via API do FalAIChat (message_create).
Transfere a conversa para um agente humano, se necessário.
Monitora conversas abertas para fornecer contexto ao suporte.


Como Funciona a Transferência Bot → Agente Humano?

📌 Quando um AgentBot está conectado, novas conversas começam com status "pendente".

O bot faz a triagem inicial antes de transferir para um agente humano.
Se um agente precisar intervir, o bot pode atualizar o status da conversa para "aberto".
Os agentes também podem devolver a conversa para a fila do bot, alterando o status para "pendente".


Casos de Uso do AgentBot

📌 Atendimento ao Cliente Escalável
🔹 Empresas com alto volume de consultas podem usar o AgentBot para filtrar solicitações, reduzindo a carga sobre agentes humanos.

📌 E-commerce
🔹 O AgentBot pode acessar bancos de dados internos para fornecer status de pedidos e rastreamento de entregas.

📌 Sites de Conteúdo e Notícias
🔹 Recomendações automáticas de artigos, postagens ou vídeos com base nos interesses do usuário.

📌 Reservas Online (Hotéis, Cinemas, Eventos)
🔹 O bot pode processar reservas e responder dúvidas comuns automaticamente.

📌 Exemplos de Implementação
Reserva de hotéis usando Dialogflow
Exemplo de automação com Rasa


Como Adicionar um AgentBot ao FalAIChat?

Existem dois tipos de AgentBots no FalAIChat:

Bots Globais – Têm permissão para todas as contas na instalação.
Bots de Conta – São exclusivos de uma conta específica.

🔹 Os bots podem ser criados via API ou Console Rails.


Criando AgentBots via API

📌 Os Bots Globais podem ser criados interagindo com a API de Bot do AgentBot.
📌 Os Bots de Conta podem ser criados interagindo com a API de Bot da Conta.


Criando AgentBots via Console Rails

🔹 Abra seu diretório FalAIChat e certifique-se de que seu servidor local esteja rodando.

Passo 1: Inicie o console Rails

bashCopyEditbundle exec rails c

Passo 2: Crie um novo bot

rubyCopyEditbot = AgentBot.create!(name: "MeuBot", outgoing_url: "http://localhost:8000")
bot.access_token.token

📌 O token gerado será usado para chamadas de API no FalAIChat.

Passo 3: Opcionalmente, adicione um avatar ao bot

rubyCopyEditavatar_file = Down.download("image_url")
bot.avatar.attach(io: avatar_file, filename: avatar_file.original_filename, content_type: avatar_file.content_type)

Passo 4: Conecte o bot à sua caixa de entrada

rubyCopyEditAgentBotInbox.create!(inbox: Inbox.first, agent_bot: bot)

📌 Para conectar a um inbox específico, substitua Inbox.first por Inbox.find(inbox_id).


🚀 Agora seu AgentBot está pronto para automatizar conversas no FalAIChat! 🎉