Tipos de Mensajes

Direcciones, estados y metadatos de mensajes

mensajesentrantessalientesinternosestadoentregalectura

Tipos de Mensajes

Comprende los diferentes tipos de mensajes, direcciones y estados en la Bandeja de Entrada.

Direcciones de Mensaje

Tipos de Direccion

DireccionFlujoDescripcion
INBOUND (Entrante)Candidato -> EmpresaMensajes recibidos de candidatos
OUTBOUND (Saliente)Empresa -> CandidatoMensajes enviados al candidato
INTERNAL (Interno)Equipo <-> EquipoSolo 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)
  • WhatsApp
  • 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:

  • Email
  • WhatsApp
  • 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

EstadoDescripcionIcono
PENDINGMensaje creado, no enviado. En cola de procesamiento(ninguno)
SENTMensaje salio del sistema. Canal acepto el mensajecheckmark
DELIVEREDMensaje llego al destinatario. Confirmacion del canalcheckmark checkmark
READDestinatario abrio el mensaje. Tracking confirmo lecturacheckmark checkmark (azul)
FAILEDError en el envio. Mensaje no entregadowarning (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

ErrorDescripcion
CHANNEL_ERRORCanal no disponible, credenciales invalidas, servicio caido
RECIPIENT_ERROREmail invalido, telefono invalido, numero bloqueado
CONTENT_ERRORMensaje muy largo, caracteres invalidos, template rechazado
QUOTA_ERRORLimite 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

¿No encontraste lo que buscabas?

Nuestro equipo de soporte está listo para ayudarte.

Contactar Soporte