Clasificar la intención
Un mensaje rara vez anuncia su propósito con todas las letras; este endpoint lee entre líneas y devuelve qué quiere hacer realmente quien escribió: preguntar, pedir un reembolso, reservar algo, quejarse, cancelar. Existe para que el siguiente paso de una conversación lo decida una máquina, sin que un humano tenga que leer cada línea primero.
Ejecútela online
Ejecute esto en nuestros servidores con su cuenta. Las herramientas gratuitas corren en su navegador; esta cobra de su saldo del KIT según el precio de arriba.
El vacío que llena
El sentimiento le dice el ánimo, la clasificación de tema le dice el asunto, pero ninguno responde la pregunta que un sistema de enrutamiento realmente necesita: ¿qué quiere que se haga esta persona? Un mensaje puede tener tono neutro y aun así ser una solicitud urgente de cancelación. text/intent está construido específicamente para responder esa pregunta operativa, devolviendo la intención de fondo en vez de una descripción de tono o tema.
Cómo funciona la solicitud y la respuesta
Llama a POST /text/intent con sus textos, opcionalmente incluyendo el conjunto de intenciones que le interesan, y recibe de inmediato un task_id. La tarea corre de forma asíncrona; al terminar, cada elemento vuelve con su intención predicha y un puntaje de confianza, entregado por webhook firmado o por enlace firmado válido por 24 horas. Usted decide qué umbral de confianza es suficientemente seguro para actuar de forma automática y cuál debería llegar primero a una persona.
De dónde viene la clasificación de intención
La idea tiene raíces profundas en los sistemas de diálogo y los primeros asistentes de voz, que tenían que mapear una frase hablada a una de un conjunto fijo de acciones antes de poder hacer algo útil: 'poner una alarma', 'reproducir una canción', 'consultar el clima'. La clasificación de intención sobre texto escrito hereda ese mismo enfoque práctico: no busca entender todo sobre una oración, solo responder la única pregunta que determina qué pasa después.
A quién le ahorra más tiempo
Equipos de soporte que quieren mensajes entrantes enrutados automáticamente a colas de facturación, técnica o cancelación antes de que un humano los lea. Equipos que construyen automatización de chat y correo y necesitan una primera lectura de la intención antes de decidir si un bot puede resolver el mensaje o si hace falta escalar. Equipos de ventas que priorizan leads entrantes según si el mensaje muestra intención real de compra o es una consulta general.
Cómo encaja en un flujo automatizado
Como las intenciones suelen ser un conjunto fijo y conocido por cada negocio, muchos equipos envían su propia lista de categorías en cada llamada en lugar de depender de una taxonomía genérica, lo que mantiene el resultado directamente utilizable en la lógica de enrutamiento sin capas de traducción intermedias. El diseño asíncrono del endpoint hace que una ráfaga de mil mensajes entrantes tras un envío de marketing no genere contrapresión en ningún punto de su infraestructura, y los ítems fallidos se reintentan automáticamente sin costo antes de mostrar un error claro.
Qué puede hacer con ella
Enrutamiento automático de bandeja
Clasifica cada correo de soporte entrante como facturación, técnico, cancelación o consulta general para que caiga en la cola correcta antes de que alguien lo lea.
Decisiones de traspaso en chatbots
Detecta el momento en que la intención del usuario pasa de una pregunta simple a una solicitud que un bot no puede resolver con seguridad, y escala a una persona justo en ese instante.
Calificación de leads
Separa los mensajes con intención real de compra de las consultas casuales para que el equipo de ventas invierta su tiempo en los leads con más probabilidad de convertir.
Categorización de la voz del cliente
Etiqueta por intención miles de transcripciones de chat ya almacenadas para ver qué porcentaje de contactos eran en realidad intentos de cancelación.
Preguntas frecuentes
¿Qué es la clasificación de intención y en qué se diferencia del análisis de sentimiento?
La clasificación de intención identifica qué quiere que se haga una persona —preguntar, comprar, cancelar, quejarse— mientras que el análisis de sentimiento solo identifica el tono emocional; a menudo se necesitan ambos, pero responden preguntas distintas.
¿Cómo uso la api para detectar la intención del usuario?
Envía sus textos a POST /text/intent, opcionalmente con sus propias categorías de intención, guarda el task_id que recibe, y obtiene la intención predicha y su confianza para cada elemento por webhook o mediante un enlace firmado válido por 24 horas.
¿Puedo definir mis propias intenciones personalizadas?
Sí, puede enviar el conjunto específico de intenciones relevante para su negocio en cada llamada en lugar de quedar limitado a una lista genérica, lo que mantiene los resultados directamente utilizables en su lógica de enrutamiento.
¿Hay prueba gratuita?
No hay capa gratuita: las capas gratis se abusan y ralentizan a todos. El acceso funciona con un saldo prepago de ForHosting KIT: se recarga desde $10.00 (no caduca) y cada solicitud se cobra a su precio publicado, así que una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens ni créditos inventados, y una tarea fallida no se cobra.
¿Cuánto cuesta?
$0.003 por solicitud más $0.0135 por ítem, así que clasificar 1,000 mensajes cuesta la tarifa base más $13, y solo se cobra por los ítems que se completan con éxito.
¿Qué tan precisa es la detección de intención en mensajes cortos?
Los mensajes cortos y claros se clasifican de forma confiable; los mensajes de una sola palabra muy ambiguos aportan menos señal, así que conviene probar sus propios patrones de mensaje antes de confiar el enrutamiento por completo a la automatización.
¿Puedo enviar miles de mensajes en un solo lote?
Sí, el endpoint está pensado para lotes grandes y corre de forma asíncrona precisamente para que los volúmenes altos no bloqueen su aplicación mientras espera los resultados.
¿Qué pasa con mis mensajes después de clasificarlos?
El texto se elimina al terminar la ventana de retención y nunca se usa para entrenar modelos; los ítems fallidos se reintentan automáticamente hasta tres veces antes de devolver un error claro, y una tarea fallida nunca se cobra.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, y pronto desde nuestra app, el email y Telegram.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/text/intent \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"items":["valor-1","valor-2"]}'const res = await fetch("https://api.kit.forhosting.com/text/intent", {
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/intent",
headers={"Authorization": f"Bearer {os.environ['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/intent", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"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/intent", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"items": [
"valor-1",
"valor-2"
]
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "text.intent",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Límites
max_tokens | 20000 |
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |
422 | task_failed | La tarea falló tras 3 reintentos. No se cobra. |