Como transformar sua FAQ em um chatbot
Um chatbot de perguntas frequentes transforma a FAQ que você já escreveu em atendimento automático: o cliente pergunta do jeito dele — “cadê meu pedido?” — e a API encontra a resposta oficial que corresponde. Nada de improviso: o bot entrega somente o que você cadastrou, entendendo as mil formas de fazer a mesma pergunta.
Rode online
Rode nos nossos servidores com a sua conta. As ferramentas grátis rodam no seu navegador; esta aqui é descontada do seu saldo do KIT pelo preço acima.
Da página de FAQ parada ao atendimento que responde
Toda empresa tem uma FAQ que ninguém lê: o cliente prefere perguntar no chat. Este serviço fecha o ciclo — você envia seus pares de pergunta e resposta (os oficiais, revisados), a API indexa tudo e cada mensagem do cliente é comparada semanticamente com as perguntas cadastradas. Deu correspondência, a resposta aprovada volta na hora. A FAQ deixa de ser página esquecida e vira a fonte única do atendimento automático.
Por que ele acerta mesmo com a pergunta torta
A comparação não é por palavra exata, é por sentido. “Quero devolver”, “como faço pra trocar” e “veio errado e agora” caem todas na mesma resposta de trocas — sem você precisar prever cada variação nem manter lista de sinônimos. É a diferença entre um menu engessado de opções numeradas e uma busca que entende português de gente: erro de digitação, abreviação e ordem invertida deixam de quebrar o atendimento.
Você continua dono de cada resposta
Diferente de um bot generativo solto, aqui não existe resposta que você não escreveu. Mudou a política de troca? Atualize aquele par e pronto — o bot passa a responder a versão nova. Dá para cadastrar até 10.000 pares, o suficiente para cobrir atendimento de loja, suporte de sistema e dúvidas de cobrança juntos. E quando nenhuma resposta cadastrada corresponde à pergunta, o certo é transferir para um humano, não arriscar.
Preço de atendimento, versão pague pelo uso
Cada pergunta processada custa US$ 0,015, mais US$ 0,003 da chamada — em dólar, com preço publicado. Uma operação que responde 2.000 perguntas por mês gasta US$ 36, sem contrato e sem pagar por atendente virtual ocioso em mês fraco. Como o custo é por pergunta, dá para começar pequeno: cadastre as 30 dúvidas mais repetidas do seu WhatsApp e já corte a maior parte do volume manual.
Casos de uso
Loja virtual: “cadê meu pedido?” no automático
As dúvidas de rastreio, prazo, troca e cancelamento se repetem o dia inteiro no chat de qualquer loja virtual. Cadastradas uma vez, voltam como resposta oficial na hora — e a equipe cuida só das exceções.
Contador que atende dezenas de MEIs
Um escritório contábil de Porto Alegre responde as mesmas perguntas toda semana: “como emitir nota fiscal de MEI?”, “qual o prazo do DAS deste mês?”. Com as respostas oficiais cadastradas, o canal do escritório resolve o repetido e sobra tempo para o trabalho de verdade.
Distribuidora com clientes B2B
A Distribuidora Horizonte Verde S.A. recebe dos revendedores as mesmas dúvidas de pedido mínimo, prazo de entrega por região e política de devolução. O bot responde no portal do cliente com a regra oficial — a mesma para todos, sem versão desencontrada de cada vendedor.
Suporte de sistema fora do horário
Quem assina um sistema não escolhe hora para ter dúvida. Com a base de perguntas frequentes indexada, o suporte responde de madrugada o que já está documentado — e registra para o time só o que for problema novo.
Perguntas frequentes
Qual a diferença para um chatbot de IA que responde qualquer coisa?
Um bot generativo solto pode improvisar — e improviso em política de troca ou preço sai caro. Aqui a IA entra só para entender a pergunta; a resposta é sempre uma das que você cadastrou, palavra por palavra.
E se o cliente perguntar algo que não está na minha FAQ?
A API sinaliza que não encontrou correspondência boa, e o seu fluxo decide: transferir para atendente, pedir reformulação ou registrar a pergunta como candidata a novo par. Essas perguntas sem resposta são ouro para descobrir o que falta na sua FAQ.
Quantas perguntas e respostas posso cadastrar?
Até 10.000 pares por base — bem mais do que qualquer FAQ real precisa. Se a sua tem 40 perguntas, comece com elas; dá para acrescentar e atualizar depois.
Como eu pago? Aceita Pix?
Pix ainda não — o pagamento é via PayPal, porque a operação é internacional e cobra em dólar. Sem cadastro e sem mensalidade: você compra saldo e consome US$ 0,003 por chamada mais US$ 0,015 por pergunta.
As conversas dos meus clientes ficam armazenadas?
As perguntas são processadas para localizar a resposta correspondente — esse é o tratamento a mencionar no seu aviso de privacidade da LGPD. Evite estimular o cliente a mandar CPF ou dado sensível no chat: para responder FAQ, ninguém precisa disso.
Preciso programar para usar?
É uma API, então alguém técnico conecta o seu chat ao serviço — costuma ser tarefa de horas, não de semanas: uma chamada para indexar os pares e uma por mensagem recebida. Não tem painel obrigatório nem plataforma nova para aprender.
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
curl -X POST https://api.kit.forhosting.com/rag/faq-bot \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"input":"…"}'const res = await fetch("https://api.kit.forhosting.com/rag/faq-bot", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"input": "…"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/rag/faq-bot",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"input": "…"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/rag/faq-bot", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"input":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/rag/faq-bot", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemplo de requisição
{
"input": "…"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "rag.faq_bot",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Limites
max_chunks | 10000 |
max_tokens | 20000 |
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |
422 | task_failed | A tarefa falhou do nosso lado. Você não paga nada por ela. |