Antes de conectar una bandeja de entrada: lista de verificación para el correo entrante en aplicaciones autoalojadas
Antes de conectar una bandeja de entrada empresarial a una aplicación autoalojada, confirma el método de entrega documentado, qué hace la aplicación con los mensajes y cómo gestionará tu equipo el acceso y los fallos.
Empieza por definir qué función debe cumplir la bandeja de entrada
«Conectar el correo electrónico» puede significar distintas cosas: crear una conversación de asistencia a partir de un mensaje entrante, adjuntar correspondencia a la ficha de un cliente o permitir que el personal responda desde una aplicación. Anota el flujo de trabajo previsto antes de elegir un buzón o cambiar su configuración.
Considera el procesamiento del correo entrante y el envío de mensajes como dos cuestiones distintas que debes verificar. ¿Qué necesita recibir o importar la aplicación y qué necesita enviar? Consulta la documentación de la aplicación para cada requisito, en lugar de suponer que una sola configuración cubre ambos.
Identifica el buzón, los mensajes que quieres incluir, la acción que debe realizar la aplicación y las personas que necesitan acceso a los registros resultantes.
- ¿Qué proceso empresarial debe admitir la aplicación?
- ¿Qué mensajes deben incluirse y qué regla documentada determina cuáles son?
- ¿El personal necesita responder desde la aplicación? Si es así, ¿dónde se documenta esa función?
- ¿Quién será responsable de este flujo de trabajo y de su configuración?
Verifica el método de entrega documentado
Consulta la documentación de la aplicación concreta y de su implementación autoalojada antes de elegir un método de entrega. ¿Qué métodos documenta? ¿Qué debe configurarse fuera de la aplicación y se aplican las instrucciones a tu implementación?
Como ejemplo específico y limitado a un producto, la guía de ingreso de correo electrónico de Chatwoot para implementaciones autoalojadas, disponible en https://developers.chatwoot.com/self-hosted/configuration/features/email-channel/ingress-providers, describe cómo elegir y configurar un proveedor de ingreso de correo entrante, establecer las variables de entorno necesarias y utilizar proveedores como Mailgun o SendGrid. Este ejemplo no determina qué admiten otras aplicaciones ni cómo deben configurarse.
SMTP es el protocolo que utilizan los servidores de correo electrónico para comunicarse y enviar y recibir mensajes, tal como se explica en esta descripción general: https://blog.miguelgrinberg.com/post/how-to-host-your-own-email-server. Esta definición general no indica cómo recibe ni procesa los mensajes de una bandeja de entrada una aplicación concreta. Consulta por separado la configuración documentada del correo entrante de esa aplicación.
- Busca la documentación del correo entrante para la implementación autoalojada de la aplicación.
- ¿Qué método, servicios externos, valores de configuración y requisitos previos especifica?
- ¿Dónde indica que debes introducir la configuración y cómo señala que debes aplicar los cambios?
- Si la documentación no responde a estas preguntas, consulta al proveedor o responsable de mantenimiento de la aplicación antes de conectar un buzón empresarial.
Pregunta qué implican el acceso y la gestión de mensajes
Antes de conceder acceso, pregunta al responsable de mantenimiento de la aplicación y al proveedor del buzón qué cuenta, método de autenticación y permisos requiere la integración documentada. No des por sentado un método de inicio de sesión ni un alcance de permisos específicos.
Pregunta qué almacena, muestra, indexa o utiliza de otro modo la aplicación de un mensaje entrante. Verifica el tratamiento documentado del cuerpo del mensaje, los datos del remitente y del destinatario, los encabezados, los archivos adjuntos y otros metadatos. Si la documentación no lo aclara, considera ese comportamiento una cuestión pendiente, en lugar de deducirlo porque el mensaje aparezca en la aplicación.
Utiliza esas respuestas para decidir si el buzón es adecuado para el flujo de trabajo. Ten en cuenta quién puede acceder a los registros resultantes y si la aplicación debe recibir todo el contenido de los mensajes o una selección más limitada.
- ¿Qué cuenta y alcance de permisos requiere la integración documentada?
- ¿Qué campos, contenido y archivos adjuntos gestiona la aplicación y dónde se documenta ese comportamiento?
- ¿Se especifican los límites de los archivos adjuntos, la ubicación de almacenamiento, la conservación de datos y los controles de acceso?
- ¿Quién está autorizado a acceder a los registros resultantes?
Planifica la responsabilidad, los fallos y la recuperación
Antes de ponerlo en marcha, pregunta cómo puede tu equipo detectar que la integración no funciona según lo previsto. ¿La aplicación o la integración documenta una vista de estado, registros, alertas u otro método de investigación? Confirma qué opciones existen realmente, en lugar de suponer que hay una función de supervisión específica.
Pregunta al responsable de mantenimiento qué ocurre con las entregas duplicadas, el procesamiento retrasado y los fallos, y qué pasos de recuperación están documentados. Si la documentación no especifica el comportamiento, anótalo como una cuestión pendiente. Decide quién investigará los mensajes que falten o se repitan y qué debe hacer el personal si no aparece el registro esperado.
Mantén la información sobre responsabilidades y recuperación disponible para los administradores autorizados. Considera cómo transferirá la organización la responsabilidad, sustituirá o revocará el acceso cuando corresponda y restablecerá el flujo de trabajo si se marcha la persona que lo configuró. No incluyas contraseñas, tokens ni otros secretos en el manual de operaciones.
- ¿Quién es el responsable operativo y quién es el contacto suplente?
- ¿Dónde pueden consultar el estado o investigar un fallo los administradores, si esas opciones están documentadas?
- ¿Qué indica el responsable de mantenimiento sobre los duplicados, los retrasos, los reintentos y la recuperación?
- ¿Cómo se transferirán la responsabilidad y el acceso si la persona responsable se marcha o cambia de puesto?
Haz una prueba controlada y deja constancia de la decisión
Antes de conectar un buzón de producción, pregunta al responsable de mantenimiento de la aplicación si hay una configuración de prueba disponible y sigue las instrucciones documentadas. Utiliza mensajes que permitan comprobar el comportamiento relevante para tu flujo de trabajo sin exponer datos empresariales innecesarios.
Comprueba si aparece la acción o el registro previsto y si los detalles del mensaje y el tratamiento de los archivos adjuntos coinciden con lo que cabía esperar según la documentación. Pregunta cómo probar de forma segura las entregas repetidas, los retrasos o los fallos; no supongas que la aplicación ofrece un procedimiento de prueba para todos los casos.
Si el comportamiento observado difiere de la documentación o deja sin respuesta una pregunta importante, pausa el uso en producción y consulta al responsable de mantenimiento de la aplicación o al proveedor del buzón. Anota el método utilizado, las respuestas recibidas, las cuestiones pendientes, las personas responsables y los pasos de recuperación, sin registrar secretos.
- ¿Qué configuración de prueba controlada recomienda la documentación de la aplicación, si es que recomienda alguna?
- ¿Aparece el registro o la acción esperados y se gestiona el contenido pertinente del mensaje según lo documentado?
- ¿Qué comprobaciones seguras y documentadas hay disponibles para las entregas repetidas, los retrasos o los fallos?
- Anota el método de entrega, las respuestas sobre el tratamiento de datos, las personas responsables, los pasos de recuperación y las cuestiones pendientes.
Preguntas frecuentes
¿El correo entrante es lo mismo que el correo transaccional saliente?
Son requisitos distintos que hay que verificar: uno se refiere a recibir o importar mensajes y el otro, a los mensajes que envía la aplicación. Consulta la documentación de la aplicación para cada flujo de trabajo, en lugar de suponer que una sola configuración cubre ambos.
¿Debería usar el reenvío, la consulta periódica del buzón o un proveedor de ingreso?
La información proporcionada no establece que un método sea el mejor para todas las aplicaciones autoalojadas. Consulta la documentación vigente de la aplicación para implementaciones autoalojadas y verifica los métodos admitidos, los requisitos previos y los pasos de configuración. Si no resuelve tu caso de uso, consulta al responsable de mantenimiento.
¿Configurar SMTP significa que mi aplicación puede procesar una bandeja de entrada?
No, no por sí solo. SMTP es un protocolo que utilizan los servidores de correo electrónico para comunicarse y enviar y recibir mensajes, pero esa definición general no describe cómo incorpora los mensajes de una bandeja de entrada una aplicación concreta. Verifica por separado la configuración documentada del correo entrante de la aplicación.
¿Qué debo verificar antes de conectar un buzón de producción?
Comprueba la ruta de entrega documentada, la acción prevista de la aplicación, el tratamiento pertinente de los mensajes y los archivos adjuntos, el acceso necesario y las indicaciones disponibles sobre fallos y recuperación. Pregunta al responsable de mantenimiento cómo probar estos comportamientos de forma segura en tu configuración.
¿Qué debería ocurrir cuando se marcha la persona que configuró la bandeja de entrada?
Pregunta cómo puede tu organización identificar la cuenta y la configuración, transferir la responsabilidad, sustituir o revocar el acceso cuando corresponda y seguir los pasos de recuperación documentados. Evita que la responsabilidad dependa de la configuración no documentada de una sola persona.
Fuentes y lecturas adicionales
- Configuring inbound mails in Chatwoot — Chatwoot
- How to Host your Own Email Server — Miguel Grinberg