Detectar emails de rol
Una api detectar email de rol determina si una dirección pertenece a una persona o a una función compartida como facturación, ventas o webmaster. La diferencia importa: las cuentas de rol son bandejas compartidas, muchas veces sin dueño claro, y tratarlas como un contacto individual distorsiona sus métricas y puede generar quejas de spam.
Ejecutar — gratis
Corre en su navegador. Gratis y sin límite: sus datos no salen de esta página.
Por qué las cuentas de rol arruinan el alcance
Las listas de ventas y marketing acumulan direcciones como info@, admin@, hola@ y no-reply@ a través de formularios, directorios extraídos y exportaciones antiguas. Estas bandejas suelen ser monitoreadas por varias personas a la vez o por nadie en absoluto, así que un mensaje enviado ahí rara vez llega a quien decide y rara vez genera una apertura genuina. Detectarlas separa a los prospectos reales de las bandejas genéricas antes de gastar un envío en el destino equivocado.
Cómo funciona la detección
El endpoint analiza la parte local de la dirección contra un diccionario mantenido de prefijos de rol, departamento y sistema que cubre convenciones de nombres comunes en español, inglés y otros idiomas, y devuelve un indicador booleano más la categoría detectada, como administrativo, soporte, marketing, no-reply o postmaster. Corre junto a las verificaciones de formato y dominio para que pueda combinar señales en un solo veredicto sin integrar varios servicios distintos.
Qué esperar de una llamada
Envía la solicitud y recibe de inmediato un task_id; el veredicto real llega por su webhook firmado o por un enlace firmado válido por 24 horas, igual que en el resto de tareas de esta API. Una respuesta típica indica is_role verdadero o falso y, si es verdadero, la categoría que coincidió, para que su lógica decida excluir, despriorizar o redirigir esa dirección a una bandeja de equipo en vez de a una secuencia personalizada.
Dónde rinde frutos la detección de roles
Los equipos de ventas salientes la usan para mantener sus secuencias en frío apuntando a personas con nombre. Las plataformas de soporte la usan para enrutar automáticamente los tickets que llegan desde bandejas de rol. Los pipelines de higiene de listas la ejecutan antes de cada campaña para que las bandejas compartidas queden suprimidas de los flujos personalizados y redirigidas a envíos tipo boletín, que es como realmente se leen esas bandejas.
Cómo encaja en un pipeline automatizado
Como cada llamada se cobra solo si tiene éxito y los resultados llegan de forma asíncrona, puede integrar la detección de roles dentro de una cadena de verificación más amplia, formato, luego erratas, luego rol, luego MX, sin que una respuesta lenta bloquee el resto del flujo. Los reintentos ocurren automáticamente hasta tres veces antes de mostrar un error claro, así que el pipeline se mantiene predecible.
Qué puede hacer con ella
Higiene de secuencias de ventas
Elimine info@ y ventas@ de una lista de prospección fría antes de lanzarla, para que los asuntos personalizados nunca caigan en una bandeja compartida que nadie lee.
Enrutamiento de tickets de soporte
Marque los correos entrantes desde admin@ o soporte@ para dirigirlos a una cola de equipo en lugar de asignarlos a un agente individual.
Segmentación de boletines
Divida una lista de suscriptores para que direcciones de rol como boletin@ reciban el envío genérico mientras las direcciones personales reciben la versión personalizada.
Filtro de fraude y abuso
Trate los registros desde webmaster@ o postmaster@ como de mayor riesgo durante la creación de cuentas, ya que los usuarios legítimos rara vez se registran con esos prefijos.
Preguntas frecuentes
¿Qué se considera un email de rol?
Cualquier dirección construida alrededor de una función y no de una persona, como info@, admin@, soporte@, ventas@, no-reply@ o webmaster@, se clasifica como email de rol en esta api detectar email de rol.
¿La api detectar email de rol es gratis?
La herramienta de arriba es gratis en su navegador. La API es de pago: cada llamada se descuenta de su saldo prepago de ForHosting KIT — se recarga desde $10.00 (no caduca), se paga el precio publicado de cada solicitud, y una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens, y una tarea fallida no se cobra.
¿Cuánto cuesta cada verificación?
Cada solicitud a /verify/email-role cuesta 0.002 dólares, cobrados únicamente cuando la tarea se completa con éxito.
¿También valida el formato o el dominio del correo?
No, la detección de rol es una verificación puntual y específica; combínela con los endpoints de erratas y formato si necesita un veredicto más completo sobre una dirección.
¿Puedo verificar correos en lote?
Cada llamada procesa una dirección; para listas grandes, arme su propio proceso por lotes sobre este endpoint o use el endpoint dedicado de verificación en lote junto con este.
¿Funciona con prefijos que no son en inglés?
Sí, el diccionario cubre prefijos de rol comunes en varios idiomas, no solo patrones en inglés como info o admin.
¿Cómo obtengo el resultado?
Cada llamada devuelve un task_id de inmediato; el veredicto se entrega mediante su webhook firmado o un enlace firmado válido por 24 horas.
¿Qué pasa si la tarea falla?
Las tareas fallidas se reintentan automáticamente hasta tres veces y nunca se cobran; si todos los reintentos fallan, recibe un error claro en lugar de un vacío silencioso.
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/verify/email-role \
-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/verify/email-role", {
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/verify/email-role",
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/verify/email-role", 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/verify/email-role", 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": "verify.email_role",
"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. |