Ruta: /owner/integrations/chat
Widget de chat en tiempo real para comunicacion directa con el equipo de soporte desde cualquier pantalla de Factux.
El chat en tiempo real es un widget flotante ubicado en la esquina inferior derecha de la aplicacion. Permite enviar mensajes al equipo de soporte sin salir de la pantalla en la que estas trabajando.
Caracteristicas principales:
Caracteristica Descripcion Mensajes de texto Envia y recibe mensajes en tiempo real Indicador de escritura Muestra cuando el agente esta escribiendo una respuesta Confirmacion de lectura Indica cuando el agente ha leido tu mensaje Adjuntos Permite enviar archivos (imagenes, PDFs, capturas de pantalla) Historial Conserva el historial de conversaciones anteriores
Clic en el icono de chat en la esquina inferior derecha de cualquier pantalla.
Se abre el widget con el historial de conversaciones previas (si las hay).
Escribe tu mensaje en el campo de texto inferior.
Pulsa Enter o clic en el boton de enviar para enviar el mensaje.
Espera la respuesta — veras el indicador de escritura cuando el agente este respondiendo.
Clic en el icono de clip junto al campo de texto.
Selecciona el archivo desde tu dispositivo.
El archivo se adjunta al mensaje — clic en enviar para completar.
Caso de uso Ejemplo Preguntas rapidas ”Como cambio la serie de facturacion?” Reportar problemas ”La factura FAC-001 no genera el PDF correctamente” Solicitar funcionalidades ”Necesitaria poder exportar en formato XML” Feedback general ”La nueva vista de gastos es muy util”
1. El usuario abre el widget de chat
2. Escribe y envia su mensaje
3. El sistema notifica al equipo de soporte
4. Un agente recibe el mensaje y responde
5. El usuario ve el indicador de escritura
6. La respuesta aparece en la ventana del chat
7. La conversacion continua hasta que se resuelve la consulta
Estado Indicador Descripcion Disponible Punto verde Hay agentes conectados, respuesta inmediata Ocupado Punto amarillo Agentes disponibles con cola, posible espera Fuera de horario Punto gris Sin agentes conectados, el mensaje se atendera despues
Limite Valor Tamano maximo de archivo 10 MB por archivo adjunto Formatos de archivo JPG, PNG, PDF, DOC, DOCX, XLS, XLSX Longitud de mensaje 2.000 caracteres por mensaje Historial visible Ultimas 50 conversaciones
Detalles tecnicos — Chat en Tiempo Real El widget de chat utiliza WebSockets para la comunicacion en tiempo real entre el cliente y el servidor.
Componente Tecnologia Transporte WebSocket (con fallback a long-polling) Protocolo Socket.IO Almacenamiento Mensajes persistidos en base de datos Archivos Almacenados en Supabase Storage
Evento Direccion Descripcion message:sendCliente > Servidor Nuevo mensaje del usuario message:receiveServidor > Cliente Respuesta del agente typing:startBidireccional Indicador de escritura activo typing:stopBidireccional Indicador de escritura inactivo message:readServidor > Cliente Confirmacion de lectura file:uploadCliente > Servidor Archivo adjunto enviado
Tabla Columnas principales chat_conversationsid, business_id, user_id, agent_id, status, created_at chat_messagesid, conversation_id, sender_type, content, read_at, created_at chat_attachmentsid, message_id, file_url, file_name, file_size, mime_type
Politica Regla chat_conversations_businessbusiness_id = usuario autenticadochat_messages_via_conversationAcceso via conversacion padre
