--- title: "Usa el contrato de comunicación | Documentación de Ordering.co" description: "Separa lecturas, escrituras, recibos, medios, sockets y contacto externo de Driver según sus límites de seguridad." canonical: https://docs.ordering.co/es/docs/developers/driver-app/communication-contract/ --- # 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](https://docs.ordering.co/es/docs/developers/driver-app/architecture/) · [Ver conversaciones de pedidos](https://docs.ordering.co/es/docs/products/driver-app/communication/messages/) · [Usar el chat del pedido](https://docs.ordering.co/es/docs/products/driver-app/communication/order-chat/) · [Añadir y ver medios del chat](https://docs.ordering.co/es/docs/products/driver-app/communication/chat-attachments/)