Convertir un correo en webhook
POST /notify/email-in toma un correo que recibe su sistema —la respuesta de un cliente, un mensaje a soporte, un documento reenviado— y lo convierte en datos estructurados entregados a su propio webhook, con los adjuntos incluidos. Es para la dirección del correo que casi siempre se ignora: no lo que envía, sino lo que llega a su bandeja y necesita convertirse en parte de su aplicación.
El correo saliente se lleva toda la atención; el entrante es la mitad difícil
Casi todos los sistemas de notificación están construidos para enviar correo; casi ninguno está construido para recibirlo y hacer algo útil con lo que llega. Un cliente responde a un ticket de soporte, alguien reenvía un recibo a una dirección de gastos, un proveedor envía una orden de compra en PDF por correo: ese tráfico entrante normalmente solo se queda en una bandeja, leído por una persona que luego lo vuelve a escribir a mano en un sistema. Este endpoint existe específicamente para cerrar ese ciclo.
Cómo un correo se convierte en una llamada webhook
Una dirección que usted configura enruta el correo entrante hacia el pipeline de análisis; el mensaje se descompone en remitente, asunto, cuerpo y adjuntos, y se entrega a su aplicación como una llamada webhook con esos datos estructurados, con los adjuntos incluidos en lugar de dejarlos como enlaces que hay que ir a buscar por separado. El procesamiento en sí es asíncrono: un task_id rastrea la tarea, y también puede obtener el resultado mediante un enlace firmado válido por 24 horas si necesita un respaldo a la entrega por webhook.
Dónde encaja el análisis de correo entrante en la historia de la automatización
Leer correo de forma programática es tan antiguo como los propios servidores de correo: los primeros sistemas analizaban el contenido de una bandeja con expresiones regulares frágiles atadas a un formato específico. Lo que cambió es la diversidad: adjuntos, MIME multipartes, imágenes incrustadas, hilos reenviados con historial citado. Un endpoint de análisis tiene que manejar todo eso de forma consistente, que es exactamente el trabajo tedioso y de alto mantenimiento que esta llamada le quita de encima.
Qué llega del otro lado
Su webhook recibe la dirección del remitente, la línea de asunto, los cuerpos en texto plano y HTML cuando están disponibles, y cada adjunto en una forma que su aplicación puede almacenar o procesar directamente: un PDF subido, una imagen, una hoja de cálculo que alguien reenvió. No hay que consultar una bandeja periódicamente ni mantener una conexión IMAP; en el momento en que llega el correo, se llama a su endpoint.
Por qué esto pertenece a un flujo automatizado
Convertir un correo en una llamada webhook significa que el correo entrante puede disparar la misma lógica posterior que cualquier otra fuente de eventos en su sistema —crear un ticket de soporte, registrar un gasto, adjuntar un documento a un registro— sin que una persona actúe como puente manual. Una entrega fallida a su webhook se reintenta automáticamente hasta tres veces, y no se cobra nada por un intento que nunca se completa.
Qué puede hacer con ella
Respuestas a tickets de soporte por correo
Un cliente responde directamente a la notificación de un ticket, y esa respuesta se convierte en una llamada webhook que agrega su mensaje al ticket automáticamente.
Recibos y facturas reenviados
Un empleado reenvía un recibo a una dirección de gastos, y el PDF adjunto llega a su sistema de gastos sin que nadie tenga que volver a escribir el monto.
Órdenes de compra de proveedores por correo
Un proveedor envía una orden de compra como adjunto, y se analiza hacia su sistema de pedidos en el momento en que llega, en lugar de esperar a que alguien abra su bandeja.
Formularios ligeros vía correo
Un flujo simple de 'responde a esta dirección para confirmar' captura el contenido de la respuesta como datos estructurados sin necesidad de construir un formulario web para eso.
Preguntas frecuentes
¿Cómo se enruta un correo hacia la API?
Configura una dirección de entrada que enruta hacia el pipeline de análisis; el correo enviado ahí se analiza y se entrega a su webhook como datos estructurados de forma automática.
¿Los adjuntos se incluyen en el payload del webhook?
Sí: los adjuntos se entregan junto con el resto del mensaje analizado en lugar de quedar rezagados, así que un PDF o una imagen reenviados llegan listos para almacenar o procesar.
¿Cuánto cuesta el análisis de correo entrante?
$0.002 por solicitud más $0.0035 por correo procesado, la misma estructura que nuestros envíos salientes.
¿Hay una capa gratuita para probar el correo entrante?
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.
¿Qué pasa si mi endpoint webhook está caído brevemente?
La entrega a su webhook se reintenta automáticamente hasta tres veces antes de generar un error claro, y una tarea fallida nunca se cobra.
¿Puedo obtener el resultado analizado sin un webhook?
Sí, también está disponible un enlace firmado válido por 24 horas como respaldo si prefiere consultar el resultado en lugar de recibirlo por notificación.
¿Maneja correos multipartes y en HTML?
Sí, el pipeline de análisis descompone los cuerpos en texto plano y HTML junto con los adjuntos sin importar cómo se haya compuesto el mensaje original.
¿Puedo usarlo para algo más que respuestas de soporte?
Sí: cualquier flujo donde el correo sea el canal de entrada más fácil para una persona, desde facturas reenviadas hasta órdenes de proveedores, se puede convertir en datos estructurados de esta forma.
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/notify/email-in \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"input":"…"}'const res = await fetch("https://api.kit.forhosting.com/notify/email-in", {
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/notify/email-in",
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/notify/email-in", 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/notify/email-in", 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": "notify.email_in",
"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.
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. |