Usa el contrato de comunicación revisado
La comunicación de Driver abarca listas de conversaciones de pedidos, chat de pedidos, recibos de lectura, escrituras de texto/medios, sockets, notificaciones, portapapeles, teléfono/SMS/correo y transferencias a mapas. Son contratos distintos. La visibilidad o el estado local nunca deben tomarse como prueba de entrega, autorización, recibo, proveedor o finalización.
La guía disponible cubre la consulta de conversaciones. El envío de mensajes y medios, y la confirmación de recibos de lectura, no están disponibles para integraciones aquí.
Disponibilidad
| Capacidad | Límite público actual |
|---|---|
| Lista de conversaciones | Lecturas de pedidos autenticadas de Driver más paginación/orden local y presentación de sockets |
| Vista de chat del pedido | Lectura autenticada de participación en el pedido y presentación filtrada por audiencia |
| Recibos de lectura | La intención que cambia estado puede comenzar al abrir o cerrar el chat; están bloqueadas las afirmaciones sobre finalización/ámbito |
| Envío de texto | Puede verse un control en el cliente, pero el envío no se admite aquí |
| Envío de imagen/firma | Comparte la ruta de escritura de mensajes bloqueada; se excluyen las afirmaciones de carga/almacenamiento/entrega |
| Envío de documentos | Existe una definición en el código fuente, pero falta la conexión de la interfaz/carga de producción |
| Sockets/push | Solo intención de transporte; sin recibo de durabilidad, seguridad, orden ni entrega |
| Teléfono/SMS/correo/mapa | Transferencia externa al sistema operativo/proveedor; no hay ruta de soporte universal ni resultado del proveedor |
Requisitos previos
Para cualquier implementación o documentación de consulta:
- Usa una cuenta Driver autenticada y un pedido que Driver tenga autorización para gestionar.
- Trata los datos de pedidos/mensajes/participantes como privados y limitados al propósito.
- Separa la lectura inicial del pedido, lectura de la lista de mensajes, filtrado local, incorporación del socket, intención de lectura y representación del proveedor.
- No habilites acciones de envío, medios, recibos, contacto o aplicaciones externas en la ejecución de documentación.
Límites de responsabilidad
| Responsable | Responsabilidad |
|---|---|
| Interfaz de Driver App | Carga, lista, encabezado, burbujas, presentación por audiencia, estado de redacción, errores locales y transferencias |
| Controladores del cliente | Lecturas autenticadas, estado local, intención de lectura/escritura, listeners de sockets y limpieza inmediata de previsualizaciones |
| Contrato de lectura de API | Autorizar la participación en el pedido y filtrar los mensajes visibles según el rol actual |
| Contrato de escritura de API | Autorizar antes de cualquier carga/escritura, validar contenido/audiencia y persistir atómicamente o devolver un recibo seguro |
| Contrato de recibo de lectura | Autorizar la participación en el pedido y visibilidad por mensaje antes de la mutación |
| Proveedores de socket/push | Transportar eventos; nunca definir autorización ni finalización duradera |
| Proveedores de sistema operativo/contacto/mapa | Controlar compatibilidad con aplicaciones externas, privacidad, confirmación del usuario y resultado |
| Responsable de producto/seguridad | Resolver los hallazgos bloqueantes de autorización y recibos antes de documentar procedimientos públicos de escritura |
Entradas y resultados
Consulta
Las entradas son un contexto de pedido autorizado, sesión autenticada, filas de mensajes devueltas, metadatos de audiencia y configuración local. Las salidas seguras son estados de carga, vacío, con contenido, error, histórico o presentación añadida localmente.
Una burbuja de imagen, etiqueta de remitente, avatar de audiencia, insignia de no leído o incorporación de socket no constituye un recibo de autorización ni entrega.
Escrituras y medios
Los controles de texto e imagen/firma pueden construir una intención de mensaje. La autorización de escritura de medios y la reversión siguen en revisión de seguridad; los efectos de medios/mensajes/socket/notificaciones pueden resolverse por separado. Por eso se bloquean los procedimientos públicos de envío/medios.
El cliente aceptado no transmite el estado del selector de documentos. No afirmes que se admiten adjuntos de documentos.
Recibos de lectura
Abrir el chat puede activar una intención de lectura que cambia el estado. El ámbito del recibo y la autorización de visibilidad siguen en revisión de seguridad. El contador local de no leídos en cero, volver atrás o las filas devueltas no demuestran que se haya completado la lectura.
Sockets y contacto
Las uniones/eventos de salas de socket indican vigencia, no autorización ni durabilidad. Las acciones externas de teléfono, SMS, correo, portapapeles y mapas transfieren datos/control al sistema operativo o proveedor. No son tickets de soporte, recibos de entrega ni reintentos seguros.
Seguridad y privacidad
- Aplica la autorización antes de cargas, persistencia de mensajes o escrituras de recibos.
- Usa campos de mensaje y audiencia mínimos para el propósito; nunca confíes en que la audiencia elegida por el cliente autorice en el servidor.
- No registres tokens, mensajes/medios sin procesar, valores de contacto, ID de pedidos, coordenadas, nombres de salas socket ni cargas de proveedores en evidencia pública.
- Rechaza esquemas de medios remotos y acciones de proveedores/contacto externos en fixtures de captura.
- Trata firmas/medios como contenido sensible, no como prueba de identidad, consentimiento, recogida, entrega ni validación de PIN.
Límites y estados de fallo
| Estado | Interpretación requerida |
|---|---|
| Conversación visible | Solo presentación de lectura |
| Chat vacío | Ninguna fila visible pasó la lectura/filtrado actual; no significa «no hay registros» |
| Evento de socket | Intención de incorporación/actualización local; no es entrega duradera |
| Cambia el contador de no leídos | Agregado local/devuelto; no confirma la finalización del recibo |
| Burbuja que parece enviada | Presentación local/de respuesta; no demuestra persistencia autorizada |
| Desaparece la vista previa | El cliente limpió el estado; no demuestra éxito de carga |
| No se representa un medio | El proveedor/origen/acceso no está resuelto; no lo abras externamente |
| Se abre la app de contacto/mapas | Solo transferencia externa |
| Error tras la intención de escritura | Puede que ya hayan ocurrido cargas/escrituras previas; no reintentes a ciegas |
El envío de mensajes y medios y los recibos de lectura no están disponibles para integraciones en esta guía. No trates una carga, una burbuja visible ni un cambio local de estado como confirmación de entrega o autorización.
Diagnóstico
El estado de no leídos difiere entre lista y chat
No intentes conciliarlo abriendo/cerrando repetidamente. Las lecturas, el reinicio local a cero, la mutación del recibo, los eventos socket y el estado actualizado del pedido se resuelven por separado.
Parece posible seleccionar un adjunto
La vista previa es estado local. El envío de imagen/firma usa el contrato de escritura bloqueado; la transmisión de documentos no está conectada. No afirmes que se cargó o entregó.
Un evento socket parece demostrar la entrega
Los sockets son señales de transporte. Exige autorización del servidor y recibos duraderos; no uses el orden de llegada ni una vista de cliente como prueba de finalización.
Hay un enlace visible a teléfono, SMS, correo o mapas
Trátalo como una transferencia externa. No deduzcas disponibilidad del proveedor, responsabilidad de soporte, identidad, consentimiento ni resultado.
Guías relacionadas: Arquitectura de Driver App · Ver conversaciones de pedidos · Usar el chat del pedido · Añadir y ver medios del chat