Si los correos no aparecen en el Buzón, esta guía detalla las causas más comunes: conexión/sincronización del proveedor, configuración de reenvío/webhook y correlación con CRM.
Declaración del Problema
El Problema
Has configurado Buzón, pero los correos no aparecen en Piraja CRM. Esto podría significar:
- La sincronización del proveedor no está conectada (Gmail/Outlook) o no está funcionando
- La ingesta de reenvío no llega al endpoint del webhook
- Los mensajes se ingieren pero no están correlacionados con los registros correctos
- Los filtros/modo de vista ocultan los mensajes que esperas ver
Escenarios Comunes
Escenario 1: Sincronización del proveedor no conectada
- Gmail/Outlook no está conectado para tu usuario
- La sincronización está pausada o fallando
- No aparecen nuevos hilos/mensajes
Escenario 2: Problemas de reenvío/webhook
- La dirección de reenvío recibe correo, pero nada aparece en el Buzón
- El proveedor de entrada no está publicando en el webhook
- La autenticación o configuración es incorrecta
Escenario 3: Problemas de correlación
- Los correos aparecen en el Buzón pero no están vinculados a un Individuo/Organización
- El hilo no está asociado a un Ticket/Oportunidad/Tarea
- Esperas un historial de actividad en un registro, pero el mensaje permanece sin asignar
Escenario 4: Filtros ocultan los mensajes
- Se seleccionó la carpeta incorrecta (Bandeja de entrada/Enviados/Archivados, etc.)
- Estás en un modo de vista diferente (Conversaciones vs Mensajes)
- Un filtro de búsqueda está activo
Por Qué Solo BCC No Funciona (Reenvío)
La Idea Errónea
Muchos usuarios piensan que simplemente agregar una dirección de reenvío a BCC registrará automáticamente los correos. Esto solo funciona si la dirección de reenvío es un buzón/ruta real que recibe el mensaje y lo reenvía a Piraja.
Cómo Funciona la Ingesta del Buzón
Para que un correo aparezca en el Buzón, generalmente llega a través de uno de estos caminos:
- Sincronización del proveedor (Gmail/Outlook conectado en el Buzón)
- Ingesta de reenvío (un servicio de correo recibe el mensaje y lo publica en el webhook de Piraja)
Por Qué Solo BCC Falla
Cuando pones una dirección en BCC:
- El correo se envía a esa dirección
- Si no hay un buzón/ruta receptora detrás de ella, el mensaje nunca se ingiere
- Piraja nunca ve el mensaje, por lo que nada puede aparecer en el Buzón
La solución: usa la sincronización del proveedor o un reenvío adecuado
Si usas reenvío, necesitas un servicio/proveedor de correo que:
- Reciba correos enviados a la dirección de reenvío
- Reenvíe/publica el correo bruto al webhook de Piraja (algunas configuraciones aún utilizan el endpoint de compatibilidad legado bajo /api/integrations/email-logging/webhook, que reenvía a la ingesta actual del Buzón)
Si usas Gmail/Outlook, conecta el proveedor en el Buzón y deja que la sincronización ingiera los mensajes directamente.
Sin una configuración de recepción + reenvío real, BCC no funcionará.
Sincronización del Proveedor (Gmail/Outlook): qué verificar
Si usas Gmail o Outlook para la sincronización, los correos deberían llegar al Buzón sin ninguna configuración de reenvío/webhook.
Qué Verificar
- El proveedor está conectado para tu usuario en el Buzón
- El estado de sincronización muestra que está saludable (sin errores)
- Estás viendo la carpeta correcta (Bandeja de entrada vs Enviados)
- No tienes una consulta de búsqueda o filtro ocultando resultados
Si está conectado pero sigue vacío
- Envía un nuevo correo de prueba y verifica la vista de Mensajes en Todos
- Desconecta y vuelve a conectar el proveedor si la sincronización parece atascada
- Si solo faltan algunos mensajes, puede ser un retraso o problema de alcance del lado del proveedor
Ingesta de Reenvío/Webhook: qué verificar
Si usas reenvío en lugar de sincronización del proveedor, tu servicio de correo receptor debe publicar los mensajes entrantes en Piraja.
Causas Comunes
- La dirección de reenvío no recibe el correo (problema de enrutamiento/MX)
- El proveedor recibe correo pero no publica en Piraja
- La autenticación o configuración es incorrecta
Pasos de Verificación Práctica
- Envía un correo de prueba a la dirección de reenvío
- Verifica que el proveedor muestre que el mensaje fue recibido
- Verifica que el proveedor muestre un POST exitoso a Piraja
- Actualiza el Buzón y verifica la vista de Todos + Mensajes
Nota: Algunas configuraciones aún utilizan el endpoint de compatibilidad legado bajo /api/integrations/email-logging/webhook, que reenvía a la implementación actual de ingesta del Buzón.
Correlación y “faltante en registros de CRM”
La ingesta del Buzón y la correlación con CRM son pasos separados.
Si puedes ver el correo en el Buzón, pero no en un contacto (Individuo/Organización)
- Verifica que el contacto tenga la dirección de correo correcta guardada
- Si el mensaje fue enviado a un alias o lista de distribución, la correlación puede requerir vinculación manual
Si esperas que los correos aparezcan bajo Tickets/Oportunidades/Tareas
- Un hilo debe estar correlacionado con ese elemento de trabajo
- Si aún no está correlacionado, puedes ver el correo en el Buzón pero no dentro de las pestañas de elementos de trabajo
Consejo: Siempre confirma que el correo exista en Buzón → Vista de Mensajes → Carpeta Todos antes de tratarlo como un problema de ingesta.
Visibilidad y filtros (puede que ya esté ahí)
Antes de asumir que la ingesta está rota, confirma que el mensaje no esté oculto por el estado de la interfaz.
Cosas que comúnmente ocultan mensajes
- Carpeta incorrecta seleccionada (Bandeja de entrada vs Enviados vs Archivados)
- Estás en vista de Conversaciones pero esperando una fila de mensaje única (intenta la vista de Mensajes)
- Una consulta de búsqueda está activa (elimínala)
- Estás mirando un proveedor/cuenta diferente a la esperada
Mejor práctica
Siempre verifica:
- Buzón → Vista de Mensajes
- Carpeta Todos
- Elimina búsqueda
Si aún no puedes encontrar el mensaje allí, pasa a verificar la sincronización del proveedor o el reenvío.
Problemas Comunes
Problema: El proveedor está conectado pero no llega nada nuevo
- Desconecta/reconecta Gmail o Outlook
- Envía un nuevo mensaje de prueba y vuelve a verificar Mensajes → Todos
Problema: El reenvío recibe correo, pero el Buzón está vacío
- Confirma que el proveedor de reenvío esté publicando en Piraja exitosamente
- Verifica que el proveedor no esté eliminando la carga útil del correo bruto
Problema: Los correos aparecen pero no están vinculados a los registros correctos
- Confirma que las direcciones de correo de contacto sean correctas
- Vincula participantes/entidades cuando se te solicite en el Buzón
Problema: “No puedo encontrarlo”
- Cambia el modo de vista (Conversaciones ↔ Mensajes)
- Verifica las carpetas (Bandeja de entrada/Enviados/Todos)
- Elimina búsqueda y actualiza
Consejos de Prevención
Cómo evitar sorpresas de “correos faltantes”
- Prefiere sincronización del proveedor (Gmail/Outlook) siempre que sea posible
- Si usas reenvío, prueba la ruta de reenvío de extremo a extremo antes de confiar en ella
- Mantén actualizadas las direcciones de correo de contacto para mejorar la correlación
- Usa Mensajes + Todos como tu vista de “verdad fundamental” al solucionar problemas
- Evita guardar flujos de trabajo críticos detrás de filtros/búsquedas únicas
¿Todavía No Funciona?
Cuándo Contactar Soporte
Si has probado todas las soluciones y los correos aún no aparecen:
1. Reúne Información Antes de contactar soporte:
- Estado de integración
- Clave API (enmascarada por seguridad)
- URL del webhook (sin clave API)
- Servicio de reenvío de correo utilizado
- Mensajes de error
- Pasos que ya has intentado
- Capturas de pantalla de la configuración
2. Contacta Soporte
- Correo: support@piraja.io
- En la App: Usa el ícono de ayuda (?) en la interfaz
- Base de Conocimientos: Busca artículos relacionados
3. Lo Que Necesitará Soporte
- Tu correo de cuenta
- Nombre de la empresa
- Tipo de integración (Buzón)
- Proveedor (Gmail/Outlook/Reenvío)
- Mensajes de error
- Pasos que has intentado
- Capturas de pantalla de la configuración (enmascara cualquier clave/token sensible)
Artículos Relacionados
Recursos Adicionales
- Ayuda de Integración: Solución de problemas generales de integración
- Documentación del Servicio de Correo: Guías de SendGrid, Mailgun, AWS SES
- Pruebas de Webhook: Herramientas para probar endpoints de webhook