Deixe sua IA de suporte fazer coisas pelos clientes com ações por webhook
Por Termi3 min de leitura
Muita pergunta de suporte precisa que algo seja feito: conferir um pedido, iniciar um backup, reenviar uma chave. Uma IA que só responde passa isso para uma pessoa. Com as ações, o FiveBot chama o seu próprio endpoint HTTPS para isso, no chat do site Hollo e nos tickets do Discord, e responde com o que o seu servidor devolveu.
Um exemplo do FiveDock
O FiveDock, uma ferramenta de backup e hospedagem para servidores FiveM, usa o FiveBot como chat no site. Um usuário logado escreve "faz backup do meu servidor". A IA já sabe quais servidores esse usuário tem, porque o FiveDock passa essa lista quando o chat abre, e pergunta qual se tiver mais de um. Depois mostra uma ficha com o nome do servidor e um botão Executar. Um clique, o endpoint do FiveDock inicia o backup e o chat avisa que está rodando.
O mesmo funciona para "meu servidor está online?" ou "restaura o inventário do Kowalski de ontem".
Como definir uma ação
Em Configurações, IA, Ações você pode adicionar até 10. Cada uma tem:
- um nome e uma frase dizendo quando usar;
- o endereço HTTPS que o FiveBot chama;
- até cinco campos com tipo, como o nome de um servidor ou um número de horas, que a IA preenche a partir da conversa;
- Rodar sem perguntar, para leituras seguras como checar um status;
- uma chave para ligar e desligar.
Enviar teste dispara uma chamada de exemplo e mostra o código de status e quanto tempo levou. A página também mostra as últimas 10 chamadas.
Quem pode acionar
As ações só rodam para pessoas que o FiveBot consegue identificar: um visitante que o seu site assinou quando o chat abriu, ou a pessoa que abriu um ticket no Discord. Visitantes anônimos e email recebem respostas da sua base de conhecimento e nada além disso.
A IA confere os campos com os tipos que você definiu. Se faltar um valor, ela faz uma pergunta curta e diz as opções. A não ser que a ação rode sem perguntar, o cliente recebe uma ficha no chat, ou botões no Discord, com Executar e Cancelar.
O que o seu endpoint recebe
Um POST com a ação, os campos, o usuário e o ticket, assinado com o segredo de assinatura do seu workspace:
FiveBot-Signature: t=<unix time>,v1=<HMAC-SHA256 of t.body>
A página de configurações tem um trecho em Node que confere a assinatura. O FiveBot resolve o endereço antes e recusa redes privadas e locais, não segue redirecionamentos, espera no máximo 10 segundos e lê até 16 KB da resposta. A resposta é tratada como dados, então um texto dentro dela não consegue dar novas instruções para a IA.
Custo
Cada chamada custa um crédito de IA além da resposta e aparece como Ações no histórico de créditos. Toda chamada fica registrada com o resultado.
Perguntas frequentes
Qual plano eu preciso?
Pro ou Network. Os preços estão em fivebot.ai/pricing.
Um cliente consegue enganar a IA para agir por outra pessoa?
O FiveBot pega o usuário da assinatura que o seu site criou ou da conta do Discord que abriu o ticket, e o seu endpoint recebe essa identidade em toda chamada. Detalhes que parecem uma tentativa de dar instruções para a IA são descartados.
Como o meu site assina um visitante?
O seu backend assina o visitante com o segredo de identidade do Hollo e passa o resultado para FiveBot.identify. Mais sobre o Hollo.
Qual a diferença para as ações do assistente?
As ações do assistente são para você e sua equipe e disparam eventos ou comandos no seu servidor FiveM. As ações por webhook são para os seus clientes e chamam qualquer endpoint HTTPS que você tenha. Ações do assistente.