Traducir un email
Una bandeja de soporte que recibe tickets en una docena de idiomas suele obligar a un equipo pequeño a contratar hablantes nativos de cada uno o a hacer esperar al cliente hasta que alguien lea ese idioma. El endpoint de Traducción de Emails traduce el mensaje entrante y la respuesta saliente conservando el tono, para que un agente pueda responder a un cliente francés en francés fluido sin hablar una palabra del idioma.
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.
Quién choca de verdad con este muro
Los equipos de soporte rara vez eligen en qué idioma les escriben sus clientes, y contratar un hablante nativo para cada mercado al que vende un producto no es realista para la mayoría de empresas por debajo de cierto tamaño. Lo que suele pasar en su lugar es una respuesta lenta y torpe que pasa por quien en el equipo recuerda a medias el francés del colegio, o una demora de varios días mientras el mensaje espera al único agente bilingüe. Este endpoint existe justo para ese vacío: equipos que necesitan una traducción precisa y natural tanto del ticket entrante como de la respuesta del agente, no una idea aproximada.
Lo que hace con el tono, no solo con las palabras
Un correo de soporte tiene un registro que importa: el mensaje de un cliente frustrado se lee distinto al de una solicitud rutinaria de restablecer contraseña, y la respuesta debe conservar ese registro en el idioma destino, sin sonar rígidamente formal si el original era casual, o al revés. Envía el cuerpo del correo junto con el idioma destino, y la tarea traduce manteniendo el tono coherente con el origen, porque una traducción técnicamente correcta pero fría le quita sentido al propósito de responder de forma personal.
Cómo funciona la solicitud y el resultado
La llamada corre de forma asíncrona y devuelve un task_id de inmediato, porque una traducción que además ajusta el tono no es instantánea; al completarse, el correo traducido llega por webhook firmado, la vía recomendada para una cola de soporte en vivo, o mediante un enlace firmado válido por 24 horas si prefiere obtener los resultados manualmente. Nada en el flujo obliga a un humano a quedarse esperando frente a un cursor girando.
Cómo encaja en un flujo de soporte
El montaje natural conecta primero el ticket entrante en un idioma desconocido con este endpoint, para que el agente lo lea en su propio idioma, redacte la respuesta en su propio idioma, y envíe esa respuesta de vuelta por el endpoint antes de que salga hacia el cliente. Los software de helpdesk han ofrecido widgets de auto-traducción desde hace años, pero una API dedicada permite a un equipo enrutar solo los idiomas que realmente lo necesitan, registrar cada traducción para revisión de calidad, y mantener el flujo dentro de sus propias herramientas en vez de un plugin de navegador improvisado.
Dónde todavía debe mirar una persona
Las respuestas sensibles en temas legales o de cumplimiento, el lenguaje de política de reembolsos, y cualquier cosa que un cliente pueda capturar en pantalla y escalar merecen la revisión de un lector bilingüe antes de enviarse, la misma precaución que cualquier empresa aplicaría al primer borrador de un traductor humano. Lo que este endpoint elimina es la espera: un ticket que antes se quedaba dos días esperando al único agente que habla portugués puede tener un borrador de traducción preciso en minutos.
Qué puede hacer con ella
Helpdesk multilingüe sin contratar por idioma
Un equipo de soporte de cinco personas atiende tickets en ocho idiomas traduciendo cada correo entrante al llegar y traduciendo las respuestas antes de enviarlas, sin contratar un hablante nativo por cada mercado.
Escalamientos sensibles al tono
Un agente que atiende la queja de un cliente frustrado recibe una traducción que conserva la urgencia y el tono del original, en vez de una versión aplanada y demasiado formal.
Cobertura fuera de horario
Una cola de soporte que recibe tickets durante la noche en un idioma que ningún agente en turno habla los enruta automáticamente por traducción en vez de esperar a que se conecte el agente indicado.
Registro de calidad para un equipo en crecimiento
Una empresa que escala su área de soporte mantiene cada ticket y respuesta traducidos registrados para revisión, construyendo un historial auditable a medida que crece la cola multilingüe.
Preguntas frecuentes
¿Conserva el tono del correo original?
Sí, el endpoint traduce ajustando el registro del mensaje de origen, para que un correo frustrado o casual no salga sonando rígidamente formal, y viceversa.
¿La API de traducción de emails es gratis?
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.
¿Puedo usarla tanto para tickets entrantes como para respuestas salientes?
Sí, el mismo endpoint maneja ambas direcciones; envía el ticket para leerlo en su idioma o envía su respuesta para enviarla en el idioma del cliente.
¿Qué tan rápido recibo el correo traducido?
Corre de forma asíncrona y devuelve un task_id de inmediato; el resultado suele llegar en cuestión de momentos por webhook, el método recomendado para una cola de soporte en vivo, o por un enlace firmado válido por 24 horas.
¿Es suficientemente precisa para respuestas legales o sensibles?
Produce un primer borrador preciso, pero cualquier respuesta con contenido legal, de cumplimiento o de reembolsos debería pasar por la revisión de un lector bilingüe antes de enviarse, el mismo estándar que se aplica a cualquier traducción de primer borrador.
¿Puedo procesar en lote un backlog de tickets?
Sí, envía varias traducciones de tickets en paralelo y deje que cada task_id se resuelva de forma independiente en lugar de esperar uno por uno.
¿Qué pasa si la traducción falla?
El sistema reintenta automáticamente hasta tres veces; si sigue fallando recibe un error claro y no se le cobra el intento.
¿Los correos de mis clientes se guardan o se usan para entrenar modelos?
No. El contenido del correo se procesa únicamente para generar su traducción y se elimina después del período de retención; nunca se usa para entrenamiento.
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/translate/email \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"input":"…"}'const res = await fetch("https://api.kit.forhosting.com/translate/email", {
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/translate/email",
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/translate/email", 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/translate/email", 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
{
"input": "…"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "translate.email",
"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. |