ForHosting KIT · Texto e IA

Como classificar textos por assunto

A ferramenta atribui a cada texto um assunto de uma lista de categorias definida por você: e-mails por área, tickets por produto, avaliações por tema, documentos por tipo. É o jeito de organizar mil textos com o critério de quem organizaria dez — só que sem passar a semana lendo.

● Estávelpor itemUS$ 0,003

Executar — US$ 0,003 + US$ 0,0135/item Ver a API

Use pelo WebAPIE-mailApp em breveTelegram em breve

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.

Você define as prateleiras

A classificação usa a taxonomia do seu contexto, não uma lista genérica: “fiscal, logística, comercial, RH” numa empresa; “entrega, qualidade, preço, atendimento” num e-commerce; “direito civil, trabalhista, tributário” num escritório. Junto de cada categoria, uma descrição de uma linha ensina o critério — e é ajustando essas descrições que você calibra o resultado, sem treinar modelo nenhum. O que não couber em prateleira alguma cai em “outros”, honestamente, em vez de ser forçado onde não pertence.

Um assunto só ou vários por texto

Tem texto que é sobre uma coisa e texto que é sobre três: uma avaliação pode falar de entrega, embalagem e preço no mesmo parágrafo. A classificação funciona nos dois regimes — categoria única, quando seu fluxo exige uma decisão, ou múltiplos rótulos, quando o objetivo é medir quanto cada tema aparece no total. Para relatório gerencial, o multirrótulo costuma contar a história mais fiel.

O que custa organizar um acervo

US$ 0,003 por chamada, mais US$ 0,0135 por item classificado, em dólar americano. Um backlog de 3.000 e-mails sai por cerca de US$ 40,50, de uma vez; o fluxo contínuo de 50 tickets por dia, por uns US$ 20 ao mês. Cada chamada aceita até 20.000 tokens, o que acomoda lotes grandes de textos curtos ou alguns documentos longos por vez.

Onde a classificação entra no fluxo

Dois padrões dominam. O mutirão: classificar de uma vez um acervo parado — caixa de e-mail antiga, base de tickets, pasta de documentos — para finalmente enxergar o que existe ali. E a esteira: cada item novo passa pela API na chegada e já nasce categorizado no seu sistema. O mutirão revela onde a operação aperta; a esteira impede que a bagunça se reacumule.

Casos de uso

SAC dividido por área de verdade

A Distribuidora Horizonte Verde S.A. recebia tudo em atendimento@: nota fiscal errada, atraso de entrega, proposta de fornecedor. A classificação separa por assunto na chegada e encaminha à área certa — o financeiro parou de receber reclamação de frete.

Ouvidoria municipal com estatística honesta

Uma equipe de ouvidoria em Curitiba classifica milhares de manifestações por tema: iluminação, buraco de rua, transporte, saúde. O relatório trimestral, que levava duas semanas de tabulação manual, sai em uma tarde — com critério uniforme do primeiro ao último texto.

Acervo de blog reorganizado

Ana Paula Ferreira herdou um blog com 800 posts sem categoria consistente. Classificou tudo via API contra a nova árvore de temas do site e migrou o acervo num fim de semana — cada post na seção onde o leitor procura.

Perguntas frequentes

Qual a diferença entre classificar por assunto e extrair palavras-chave?

A palavra-chave emerge do texto; o assunto vem da sua lista. Extração responde “de que este texto fala?” em termos livres; classificação responde “em qual das minhas categorias ele se encaixa?”. Para organizar e medir, a classificação dá consistência; para descobrir temas que você nem previu, a extração ajuda antes.

Quantas categorias posso usar?

Tecnicamente, muitas; na prática, listas de cinco a vinte categorias bem descritas rendem os melhores resultados. Acima disso, categorias começam a se sobrepor — e sobreposição confunde qualquer classificador, humano incluído.

O que acontece com um texto que não se encaixa em nada?

Ele é marcado como “outros” em vez de ser empurrado para a categoria menos errada. Acompanhar essa pilha é ouro: quando “outros” cresce, é sinal de que a sua taxonomia está devendo uma categoria nova.

Preciso fornecer exemplos já classificados para começar?

Não — a lista de categorias com descrições curtas é suficiente. Se você tiver casos-limite típicos do seu negócio, citá-los na descrição da categoria melhora o acerto exatamente onde dói.

Como funciona a cobrança em lotes grandes?

Sempre por uso: US$ 0,0135 por item mais US$ 0,003 por chamada, em dólar americano. Classificar 10.000 textos custa cerca de US$ 135 — sem plano, sem mínimo, sem taxa de setup.

E-mails classificados passam a existir em algum acervo de vocês?

Não: o conteúdo é processado para a classificação e devolvido na tarefa. Para bases com dados pessoais — e caixa de e-mail sempre tem —, envie o corpo do texto sem anexar cadastros, e a LGPD agradece.

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

POSThttps://api.kit.forhosting.com/text/topic-classify

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/text/topic-classify \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"items":["valor-1","valor-2"]}'

const res = await fetch("https://api.kit.forhosting.com/text/topic-classify", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "items": [
      "valor-1",
      "valor-2"
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/text/topic-classify",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "items": [
        "valor-1",
        "valor-2"
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/text/topic-classify", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"items":["valor-1","valor-2"]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"items":["valor-1","valor-2"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/text/topic-classify", 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

{
  "items": [
    "valor-1",
    "valor-2"
  ]
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "text.topic_classify",
  "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

por chamadaUS$ 0,003

por itemUS$ 0,0135

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

Limites

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.

Ver a documentação completa do KIT →