Canal de correo — Entrante
ContentVersion y se pasan al agente. Sirve tanto para la recepción de documentos (facturas de proveedores, formularios firmados, informes escaneados) como para la recepción conversacional (un mensaje a una bandeja de entrada que has enrutado a un agente).
Qué es este canal — y qué no es
El canal de correo entrante entrega cada correo al agente asignado a la dirección receptora. Cuando llega un correo a una dirección de Servicio de correo electrónico configurada y enrutada:
- La plataforma hace coincidir la dirección con un agente y encola un trabajo asíncrono — tenga o no adjuntos el correo
- Si el procesamiento de adjuntos está habilitado, los adjuntos que cumplen los requisitos se archivan como registros
ContentVersiony se pasan al agente junto con el cuerpo - Si la dirección no tiene un registro de enrutamiento activo, el correo se ignora
- La plataforma nunca rebota el correo ni responde automáticamente al remitente — si quieres una respuesta, el agente la envía a través del canal saliente
La propia configuración de enrutamiento — el Servicio de correo electrónico más un registro de enrutamiento activo — es lo que activa el canal para una dirección. No hay un interruptor de función independiente para habilitar el enrutamiento entrante.
Este es un canal de recepción unidireccional: la plataforma no responde automáticamente. Para que el agente responda por correo, consulta Canal de correo — Saliente, y Gestión de respuestas de correo para el seguimiento de respuestas a correos iniciados por el agente.
Arquitectura
-
Llega el correo
La infraestructura de Servicio de correo electrónico de Salesforce recibe el mensaje e invoca la clase controladora de REDA AI.
-
Se gestionan los adjuntos (si está habilitado)
Si Email File Processing Enabled está activado, los adjuntos por debajo del umbral de tamaño mínimo de 10 KB (firmas y logotipos de correo habituales) se omiten, y los adjuntos restantes se validan contra la lista de extensiones de archivo permitidas y el límite de tamaño máximo, y luego se insertan como registros
ContentVersion. Este interruptor está desactivado de forma predeterminada y solo controla la gestión de adjuntos — no controla el canal. Con él desactivado, los adjuntos se ignoran pero el correo se enruta igualmente. -
Coincidencia con un agente
La plataforma busca la dirección entrante entre los registros de enrutamiento activos para determinar qué agente debe atender el correo. La coincidencia es exacta — ya sea con la dirección completa o con la parte local.
-
Se encola el trabajo asíncrono
La plataforma encola un trabajo Queueable cuando la dirección coincide con un agente — se hayan archivado adjuntos o no. Un correo sin adjuntos se entrega al agente como un turno conversacional. El controlador del Servicio de correo electrónico responde de inmediato para que Salesforce no rebote el correo si el procesamiento tarda.
-
El agente procesa
El trabajo Queueable abre una conversación nueva y entrega al agente el cuerpo, el remitente y el asunto del correo como contexto. Los adjuntos archivados se procesan mediante el flujo estándar de Procesamiento de documentos.
Cómo configurarlo
Paso 1 — Decide si procesar los adjuntos
En la pestaña REDA AI Admin, Email File Processing Enabled controla si se procesan los archivos adjuntos de los correos entrantes. Está desactivado de forma predeterminada y es un control de seguridad, no un interruptor del canal:
- Déjalo desactivado para la recepción conversacional — el agente recibe el cuerpo, el asunto y el remitente del correo, y cualquier adjunto se ignora.
- Actívalo para archivar también los adjuntos que cumplen los requisitos como registros
ContentVersiony pasarlos al agente para el procesamiento de documentos.
En cualquier caso, el canal se habilita mediante la configuración de enrutamiento de los pasos 2–3 — un correo enrutado llega al agente independientemente de este ajuste.
Paso 2 — Crea el Servicio de correo electrónico en Configuración de Salesforce
-
Servicios de correo electrónico › Nuevo
Elige el controlador entrante de REDA AI como la clase de Apex. Marca el servicio como Activo.
-
Permite los adjuntos
Configura Aceptar adjuntos en Todos (binario más texto) para que el controlador pueda ver los archivos.
-
Comportamiento ante fallos
Para la recepción de documentos, configura el Servicio de correo electrónico para que Descarte el mensaje en caso de fallo. El controlador nunca lanza una excepción; esto es puramente una defensa en profundidad.
-
Crea las direcciones
Cada dirección es un endpoint — el correo real que usa un remitente. La parte local puede ser lo que quieras (p. ej.
invoices,contracts,onboarding-docs) y Salesforce genera la dirección completa. También puedes reenviarle las direcciones de tu propio dominio.
Paso 3 — Crea los registros de enrutamiento
Los registros de enrutamiento asignan cada dirección entrante a un agente específico. Adminístralos desde la pestaña REDA AI Admin › Operaciones › Enrutamiento de correo.
- Abre la aplicación REDA AI y selecciona la pestaña REDA AI Admin.
- Desplázate hasta la tarjeta Enrutamiento de correo, dentro de Operaciones.
- Haz clic en + Agregar enrutamiento.
- Completa el formulario y guarda:
| Campo | Qué ingresar |
|---|---|
| Etiqueta | Un nombre descriptivo para el enrutamiento (p. ej. “Bandeja de facturas”). Se muestra en la tabla para una revisión rápida. |
| Dirección de correo | La dirección completa del Servicio de correo electrónico o solo su parte local (lo que va antes del @). La coincidencia no distingue mayúsculas de minúsculas e intenta primero con la dirección completa y luego con la parte local. Cada correo se asigna a exactamente un registro de enrutamiento. |
| Agente | Elígelo del menú desplegable. Solo se listan los agentes activos de canal API — el flujo de correo llama al agente del lado del servidor, por lo que otros canales no son elegibles. |
| Activo | Activado de forma predeterminada. Los registros de enrutamiento inactivos se omiten en tiempo de ejecución. |
Las direcciones entrantes sin coincidencia generan una entrada en el Registro de incidentes y se descartan silenciosamente — no se envía respuesta automática. No hay coincidencia por dominio ni por comodín; un registro de enrutamiento por cada dirección que quieras admitir.
Editar, desactivar y reactivar
- Editar — ícono de lápiz en la fila. Abre el formulario, cambia cualquier campo y guarda.
- Desactivar — ícono de prohibido en una fila activa. El registro permanece en la tabla (atenuado) para que puedas reactivarlo más tarde o reutilizarlo para un correo distinto.
- Reactivar — ícono de verificación en una fila desactivada.
- Sin eliminación definitiva — las entradas de enrutamiento se desactivan en lugar de eliminarse. Las entradas inactivas no afectan el comportamiento en tiempo de ejecución y siguen visibles para su reutilización.
Los registros de enrutamiento que creas se almacenan como configuración propiedad del suscriptor y se conservan al actualizar el paquete. Las nuevas versiones de REDA AI no sobrescribirán ni eliminarán tus enrutamientos.
Paso 4 — Configura el agente
El agente enrutado debe configurarse teniendo en cuenta este canal:
- Dale una persona clara que sepa que está procesando un documento, no conversando con el remitente.
- Asigna las herramientas correctas. La mayoría de los agentes de recepción de correo necesitan las herramientas de lectura integradas, más una herramienta específica del dominio de Mapeo de archivos o de Clase Apex que convierta los datos extraídos en registros de Salesforce.
- Considera habilitar Ejecutar acciones automáticamente — en este canal no hay una persona frente a una tarjeta de confirmación. Puedes autoejecutar, o restringir el conjunto de herramientas para que el agente solo pueda escribir mediante herramientas en las que confíes.
- Confirma que todas las herramientas que quieras que use el agente incluyan
APIen su alcance de canal, ya que el flujo de correo llama al agente del lado del servidor.
Lo que ve el agente
Por cada correo entrante, el agente recibe una conversación nueva que contiene:
- La dirección del remitente (como texto en el mensaje)
- El asunto del correo (como texto en el mensaje)
- El cuerpo del correo, truncado a una longitud razonable — la parte de texto sin formato, o el HTML depurado cuando el correo es solo HTML
- Cuando el procesamiento de adjuntos está habilitado, la lista de adjuntos que cumplen los requisitos, disponibles a través del mismo flujo de Procesamiento de documentos que cualquier otro canal
La plataforma no relaciona actualmente al remitente con un Contacto o Prospecto de forma automática, y no agrupa los correos por Message-Id. Cada correo entrante inicia una conversación nueva. Si necesitas resolución del remitente o agrupación en hilos, intégrala en una herramienta Apex personalizada que el agente pueda llamar — por ejemplo, una herramienta que busque Contactos por dirección de correo y devuelva la coincidencia.
Filtrado de adjuntos
| Filtro | Comportamiento |
|---|---|
| Tamaño mínimo | Los adjuntos por debajo de ~10 KB se omiten — esto filtra los logotipos y las imágenes de firma que abultan la mayoría de los correos empresariales. |
| Tamaño máximo | Limitado por la configuración de la plataforma Max File Size (MB). Los adjuntos que superan el tamaño se omiten y se registra un incidente. |
| Lista de extensiones permitidas | Limitado por Allowed File Extensions. Todo lo que no esté en la lista se descarta. |
| Adjuntos de texto diminutos | Los adjuntos de texto sin formato y JSON por debajo de un pequeño umbral de caracteres se omiten — la misma lógica anti-ruido que el mínimo para archivos binarios. |
Consulta Configuración de la plataforma para conocer los valores configurables que rigen estos filtros y Procesamiento de documentos para saber qué le sucede a un archivo una vez que llega al agente.
Ejecución asíncrona
El controlador del Servicio de correo electrónico siempre responde success de inmediato. El procesamiento real ocurre en un trabajo Queueable que se ejecuta en segundo plano. Importan dos implicaciones:
- El remitente no verá un fallo en línea. Si el correo está mal formado, la dirección no está enrutada o el agente presenta un error, la plataforma registra un incidente pero no rebota ni responde automáticamente. Planifica para eso — si necesitas confirmar la recepción, configura el agente para que envíe un correo de confirmación a través del canal saliente.
- Los remitentes pueden enviar grandes volúmenes. El Servicio de correo electrónico de Salesforce tiene sus propios límites diarios; además, los límites de créditos y de concurrencia de REDA AI se aplican por ejecución del agente. Para remitentes de alto volumen, vigila el Registro de incidentes en busca de fallos y considera una revisión dedicada de la concurrencia de los trabajos Queueable.
Observabilidad
- Registros de conversación — uno por cada correo entrante que produjo una ejecución del agente. Filtra por
automatedSource= la etiqueta del flujo de correo para encontrarlos. - Registro de incidentes — captura para correos fallidos o no enrutables: un correo que no coincidió con ningún registro de enrutamiento pero aun así llegó al procesamiento, un error del agente, un tiempo de espera agotado de una solicitud asíncrona. Consulta Registros de incidentes de IA.
- Depurador de conversaciones — para cualquier ejecución individual, el Depurador muestra el prompt ensamblado, los bloques de archivos que vio el agente y cada llamada a herramienta que realizó.
Seguridad y gobernanza
- Direcciones gestionadas por Salesforce. El tráfico entrante termina en el Servicio de correo electrónico de Salesforce antes de llegar a REDA AI. SPF/DKIM y la seguridad de correo estándar se aplican en ese límite.
- Los archivos permanecen en tu organización. Los adjuntos se convierten en registros
ContentVersionsujetos a tus reglas estándar de uso compartido y retención. No se copia nada a un almacén externo. - El agente se ejecuta como un usuario real de Salesforce. El controlador del Servicio de correo electrónico se ejecuta como el usuario configurado en el servicio; los permisos de ese usuario rigen lo que el agente puede leer y escribir.
- El procesamiento de adjuntos está desactivado de forma predeterminada. El control de seguridad Email File Processing Enabled convierte la gestión de archivos entrantes en una decisión explícita — hasta que lo actives, los adjuntos se ignoran incluso en una dirección enrutada. (El canal en sí solo se pone en marcha cuando creas un Servicio de correo electrónico y un registro de enrutamiento activo, de modo que nada procesa correo entrante de forma silenciosa tras la instalación.)
Prácticas recomendadas
Usa una dirección por cada tipo de recepción. Direcciones separadas para facturas, contratos y documentos de incorporación te permiten enrutar cada una a un agente enfocado con un conjunto de herramientas ajustado, en lugar de un único agente general que tenga que deducir el propósito del correo.
Confirma la recepción enviando una respuesta. Como el canal nunca responde automáticamente, una configuración pulida incluye una herramienta de correo saliente que el agente llama al final de su ejecución para acusar el procesamiento — con éxito o con fallo.
Mantén a los agentes conscientes de los archivos. El prompt del agente debe mencionar que está leyendo documentos que llegaron por correo. Eso cambia el estilo de respuesta: más breve, estructurado, centrado en la acción que realizó en lugar de conversar.
Vigila el Registro de incidentes el primer día. La mayoría de los errores de configuración — registros de enrutamiento faltantes, Ids de agente mal escritos, agentes deshabilitados — aparecen allí. Revisa el registro durante la primera semana de operación.
Planifica la resolución del remitente si la necesitas. Si el agente necesita saber qué Contacto o Prospecto envió el correo, incluye una herramienta personalizada que haga la búsqueda; la plataforma no lo hace automáticamente.
Preguntas frecuentes
No automáticamente. El canal entrante nunca envía una respuesta automática. Para enviar una, el agente necesita una herramienta de correo saliente — la herramienta integrada send_email o una herramienta personalizada que use la dirección del remitente. Consulta Canal de correo — Saliente.
Si la dirección está enrutada a un agente, el correo se entrega a ese agente como un turno conversacional — el cuerpo, el asunto y el remitente se convierten en el mensaje. Los adjuntos no son obligatorios. Si la dirección no tiene un registro de enrutamiento activo, el correo se ignora.
No. Ese ajuste es estrictamente el control de seguridad de adjuntos — determina si se procesan los archivos adjuntos, nada más. Un correo enrutado llega al agente esté el ajuste activado o no; con él desactivado, los adjuntos simplemente se ignoran.
El correo no se entrega a ningún agente. Si traía adjuntos que se archivaron, una entrada en el Registro de incidentes deja constancia del enrutamiento faltante; un correo con solo cuerpo enviado a una dirección sin enrutar simplemente se ignora. En cualquier caso no hay rebote ni respuesta — agrega un registro de enrutamiento activo para la dirección a fin de empezar a procesarla.
No. El enrutamiento solo coincide con la dirección completa o con su parte local. Crea un registro de enrutamiento por cada dirección que quieras admitir.
No. Cada correo entrante inicia una conversación nueva. Para los correos de seguimiento que deban continuar un hilo — por ejemplo, una respuesta a un mensaje iniciado por el agente — consulta Gestión de respuestas de correo.
La mayoría de los correos empresariales incluyen imágenes en línea pequeñas — logotipos, banners, gráficos de firma — que no son el documento que el remitente pretendía enviar. Filtrarlos facilita la tarea del agente y evita consumir créditos de procesamiento innecesarios.
Solo como texto — la dirección de correo del remitente se incluye en el contexto del mensaje. La plataforma no relaciona automáticamente al remitente con un Contacto o Prospecto. Si necesitas esa resolución, crea una herramienta personalizada que el agente pueda llamar.
La recepción es inmediata; el procesamiento es asíncrono. El controlador del Servicio de correo electrónico almacena los archivos y encola el trabajo, y luego responde; el agente se ejecuta en segundo plano como un trabajo Queueable.
Próximos pasos
Configura Canal de correo — Saliente para que el agente pueda responder, o lee Gestión de respuestas de correo para conocer cómo la plataforma hace el seguimiento de las respuestas a los correos iniciados por el agente.