Tipos de Mensajes
Comprende los diferentes tipos de mensajes, direcciones y estados en la Bandeja de Entrada.
Direcciones de Mensaje
Tipos de Direccion
| Direccion | Flujo | Descripcion |
|---|---|---|
| INBOUND (Entrante) | Candidato -> Empresa | Mensajes recibidos de candidatos |
| OUTBOUND (Saliente) | Empresa -> Candidato | Mensajes enviados al candidato |
| INTERNAL (Interno) | Equipo <-> Equipo | Solo visible para empresa |
Inbound (Entrante)
Mensajes que llegan de candidatos:
Caracteristicas:
- Origen: Candidato
- Destino: Empresa
- Visible para: Ambos
- Incrementa: unreadCount
- Dispara: MESSAGE_RECEIVED event
Canales posibles:
- Email (respuesta o nuevo)
- SMS
- Plataforma
- Chatbot (del visitante)
Outbound (Saliente)
Mensajes enviados al candidato:
Caracteristicas:
- Origen: Empresa/Bot
- Destino: Candidato
- Visible para: Ambos
- Actualiza: lastMessageAt
- Tracking: Estado de entrega
Canales posibles:
- SMS
- Plataforma
- Chatbot (respuesta IA)
- Sistema (notificaciones)
Internal (Interno)
Mensajes entre miembros del equipo:
Caracteristicas:
- Origen: Usuario interno
- Destino: Equipo
- Visible para: Solo empresa
- Candidato: NO lo ve
- Tipo: Comentarios/notas
Uso:
- Discutir candidato
- Tomar decisiones
- Documentar proceso
- Mencionar colegas
Estados de Mensaje
Ciclo de Vida
Saliente: PENDING -> SENT -> DELIVERED -> READ (o FAILED en cualquier punto)
Entrante: RECEIVED -> READ
Estados Detallados
| Estado | Descripcion | Icono |
|---|---|---|
| PENDING | Mensaje creado, no enviado. En cola de procesamiento | (ninguno) |
| SENT | Mensaje salio del sistema. Canal acepto el mensaje | checkmark |
| DELIVERED | Mensaje llego al destinatario. Confirmacion del canal | checkmark checkmark |
| READ | Destinatario abrio el mensaje. Tracking confirmo lectura | checkmark checkmark (azul) |
| FAILED | Error en el envio. Mensaje no entregado | warning (rojo) |
Visualizacion de Estados
En la interfaz:
- checkmark - Enviado (gris)
- checkmark checkmark - Entregado (gris)
- checkmark checkmark - Leido (azul)
- warning - Fallido (rojo con mensaje)
Con timestamp:
Leido a las 14:35
Metadatos del Mensaje
Estructura Completa
{
"id": 456,
"threadId": 123,
"direction": "outbound",
"channel": "whatsapp",
"content": "Hola Juan...",
"contentHtml": null,
"subject": null,
"senderId": 1,
"senderName": "Maria Garcia",
"senderEmail": "maria@empresa.com",
"recipientEmail": null,
"recipientPhone": "+521551234567",
"externalId": "SM1234567890",
"status": "delivered",
"errorMessage": null,
"metadata": {
"tempId": "temp_123",
"twilioData": {
"messageSid": "SM1234567890",
"accountSid": "AC..."
}
},
"createdAt": "2024-01-20T14:32:00Z",
"sentAt": "2024-01-20T14:32:01Z",
"deliveredAt": "2024-01-20T14:32:05Z",
"readAt": null
}
Metadatos por Canal
EMAIL:
- subject: Asunto del email
- contentHtml: Version HTML
- emailHeaders: In-Reply-To, References
- tracking: Opens, clicks
WHATSAPP:
- templateId: Si es template
- twilioData: MessageSid, etc
- whatsappData: Metadata adicional
SMS:
- segments: Numero de segmentos
- twilioData: MessageSid
- encoding: GSM-7 o Unicode
CHATBOT:
- intent: Intencion detectada
- confidence: Nivel de confianza
- tokensUsed: Consumo de IA
- isAiGenerated: true
Mensajes del Sistema
Tipos de Mensaje Sistema
SYSTEM MESSAGES:
- Creacion de hilo - "Conversacion iniciada"
- Cambios de proceso - "Candidato movido a Entrevista"
- Eventos de calendario - "Entrevista programada para..."
- Solicitudes - "Se solicito documento: INE"
- Escalacion - "Conversacion transferida a agente"
- Automatizacion - "Workflow 'Pre-Screening' iniciado"
Visualizacion
Sistema (14:30) Candidato movido a etapa "Entrevista" por workflow "Pre-Screening"
Caracteristicas:
- Color gris/neutral
- Icono de sistema
- No tiene remitente humano
- Informativo, no responder
Mensajes de Bot
Identificacion
Reclutador Virtual (14:32) Hola Juan! Gracias por tu interes en nuestra vacante. Tengo algunas preguntas para conocerte mejor... [Bot] Confianza: 95%
Indicadores:
- Icono de robot
- Nombre del bot
- Etiqueta [Bot]
- Metadata de IA visible
Metadata de IA
Informacion disponible:
- intent: "greeting"
- confidence: 0.95
- tokensUsed: 234
- model: "gpt-4"
- responseTime: 1.2s
En detalle del mensaje:
[Bot] Intent: greeting | Conf: 95% | Tokens: 234
Adjuntos
Tipos Soportados
ADJUNTOS DE MENSAJE:
- Documentos: PDF, DOC, DOCX
- Imagenes: JPG, PNG, GIF
- Hojas de calculo: XLS, XLSX
- Presentaciones: PPT, PPTX
- Otros: ZIP, TXT
Limite: 10MB por archivo
Almacenamiento
Los adjuntos se guardan en S3:
Estructura:
s3://bucket/attachments/{ownerId}/{threadId}/{messageId}/{filename}
Acceso:
- URLs firmadas temporales
- Expiran en 1 hora
- Regenerables bajo demanda
En la UI
Juan Perez (14:32) Aqui te envio mi CV actualizado
CV_Juan_Perez.pdf (245 KB) [Descargar] [Vista previa]
Menciones
Sintaxis
Usa @ para mencionar usuarios:
"@maria puedes revisar este candidato?" "Creo que @pedro deberia entrevistarlo"
Comportamiento
Al mencionar:
- Usuario recibe notificacion
- Se agrega como participante (viewer)
- Aparece en sus pendientes
- Nombre resaltado en mensaje
Visualizacion:
"@maria puedes revisar?" (Link clickeable al usuario)
Vistas Segun Rol
Vista de Empresa
Ve todos los mensajes:
- Entrantes (de candidatos)
- Salientes (enviados)
- Internos (comentarios)
- Sistema (automaticos)
- Bot (respuestas IA)
Vista de Candidato
Ve solo mensajes relevantes:
- Entrantes (sus mensajes)
- Salientes (de la empresa)
- Sistema (algunos)
- NO ve internos/comentarios
Importante: Los comentarios internos NUNCA son visibles para candidatos.
Errores de Mensaje
Tipos de Error
| Error | Descripcion |
|---|---|
| CHANNEL_ERROR | Canal no disponible, credenciales invalidas, servicio caido |
| RECIPIENT_ERROR | Email invalido, telefono invalido, numero bloqueado |
| CONTENT_ERROR | Mensaje muy largo, caracteres invalidos, template rechazado |
| QUOTA_ERROR | Limite de mensajes, creditos agotados, rate limit |
Reintentar Mensaje
Si un mensaje falla:
Mensaje no enviado (14:32) Error: Numero de telefono invalido [Reintentar] [Editar y reenviar]
Opciones:
- Reintentar: Envia igual
- Editar: Corrige y envia
- Cancelar: Descarta mensaje
Proximos Pasos
- Hilos y Conversaciones - Gestion de hilos
- Canales de Comunicacion - Detalle de canales
- Tiempo Real - Actualizaciones en vivo