El panel funciona bien para una tarea puntual de 20 cuentas. Resulta menos adecuado cuando un entorno de preproducción necesita buzones nuevos en cada despliegue o el producto crea cuentas durante la incorporación de clientes. Para eso existe la API.
El plan anual ofrece acceso REST para enviar tareas, consultar su estado e incorporar resultados a tus sistemas. Las canalizaciones de CI, paneles administrativos y herramientas internas son usos habituales. No escribas las credenciales devueltas en los registros; pásalas a un almacenamiento aprobado.
Qué suele automatizarse
- CI/CD: preparar 10 cuentas Gmail de prueba cuando se despliega una rama de preproducción
- Incorporación: aprovisionar buzones cuando una organización se registra en el producto
- QA: proporcionar cuentas nuevas a pruebas de Playwright o Selenium
- Operaciones internas: un botón para crear 50 cuentas Yahoo para un proyecto
Flujo básico de integración
- 1Contrata el plan anual y genera una clave en Panel → API
- 2Envía `POST /tasks` con el proveedor (`gmail`, `yahoo` u `outlook`), la cantidad y las opciones de nombres
- 3Guarda inmediatamente el `task_id` devuelto
- 4Consulta `GET /tasks/{id}` cada 30 o 60 segundos hasta que el estado sea `completed` o `failed`
- 5Recupera la lista desde el endpoint de detalles y sincronízala con tu base de datos
El resultado no es instantáneo
No bloquees la interfaz mientras espera. Una tarea de 50 cuentas Gmail puede tardar entre 30 y 90 minutos. Devuelve el ID y avisa al terminar mediante webhook, correo o consultas desde el backend.
Seguridad: requisitos obligatorios
| Regla | Motivo |
|---|---|
| Claves solo en el backend | Una clave en el frontend puede quedar comprometida |
| Una clave por entorno | Una filtración en preproducción no compromete producción |
| Rota las claves periódicamente | Limita el impacto de una filtración |
| Cifra las contraseñas almacenadas | Son datos confidenciales |
| Registra ID de tareas, no contraseñas | Permite depurar sin exponer credenciales |
Cuando algo sale mal
- Puede haber éxito parcial. Comprueba el estado por cuenta y repite los fallos en otra tarea.
- Respeta los límites. Aumenta el intervalo de espera de 30 a 60 y después a 120 segundos.
- Si una tarea permanece en `processing` más de tres horas, regístrala y crea una alerta. No supongas que falló ni generes un duplicado.
- Guarda el `task_id` antes de consultar. Si el script se detiene, continúa la misma tarea en vez de iniciar otra.
Documentación de la API
La referencia de endpoints, formatos de solicitud y respuesta y cabeceras de autenticación está en el panel, dentro de Acceso a la API, tras contratar el plan anual.
La creación solo es la primera fase. Utiliza la guía de integración con herramientas de prospección para la entrega a plataformas de envío y el proceso de aprovisionamiento para aprobación, responsables, almacenamiento y retirada.