letschatty 0.4.415__tar.gz → 0.4.417__tar.gz

{letschatty-0.4.415 → letschatty-0.4.417}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: letschatty
-Version: 0.4.415
+Version: 0.4.417
 Summary: Models and custom classes to work across the Chattyverse
 License: MIT
 Author: Axel

{letschatty-0.4.415 → letschatty-0.4.417}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "letschatty"
-version = "0.4.415"
+version = "0.4.417"
 description = "Models and custom classes to work across the Chattyverse"
 authors = ["Axel <axel@letschatty.com>"]
 license = "MIT"

{letschatty-0.4.415 → letschatty-0.4.417}/src/letschatty/models/chat/chat.py

@@ -358,7 +358,12 @@ class Chat(CompanyAssetModel):
         dump = super().model_dump_json(*args, **kwargs)
         serializer = kwargs.get('serializer', SerializerType.API)
         if serializer == SerializerType.DATABASE:
-            dump["last_message_timestamp"]= self.last_message_timestamp or self.created_at
+            # Empty chats (no non-CENTRAL message) store NULL here on purpose, so the
+            # inbox preview feed can exclude them via the indexed last_message_timestamp
+            # range filter while search still returns them. Display fallback to created_at
+            # happens at read time in api-chatty's preview build. (The __gt__/__lt__
+            # comparison fallbacks above keep created_at for in-memory sorting.)
+            dump["last_message_timestamp"]= self.last_message_timestamp
             dump["free_conversation_expire_date"] = self.free_conversation_expire_date
             dump["free_template_window_expire_date"] = self.free_template_window_expire_date
             dump["last_message"] = self.last_message.model_dump_json(serializer=SerializerType.DATABASE) if self.last_message else None

{letschatty-0.4.415 → letschatty-0.4.417}/src/letschatty/models/messages/meta_message_model/schema/values/value_errors.py

@@ -35,13 +35,64 @@ class ErrorResponse(BaseModel):
 def get_error_details(code: int) -> Optional[Dict[str, str]]:
     """
     Obtiene los detalles del error basándose en el código de error.
-    
+
     :param code: Código de error entero.
     :return: Diccionario con 'description', 'solution' y 'http_status' si el código existe, de lo contrario None.
     """
     return ERROR_CODE_DETAILS.get(code)
 
 
+# -------------------------------------------------------------------------
+# Agent-facing friendly reasons (Spanish), mapped by Meta error code or HTTP
+# status. Used to explain a failed outbound send to the agent in the chat.
+# This is additive — it does NOT touch ERROR_CODE_DETAILS or get_error_details.
+# -------------------------------------------------------------------------
+
+# Meta error code -> short agent-facing Spanish text.
+FRIENDLY_AGENT_TEXT_ES: Dict[int, str] = {
+    131047: "El cliente no escribió en las últimas 24 hs. Enviá una plantilla para retomar la conversación.",
+    131051: "Tipo de mensaje no soportado para este envío.",
+    131026: "El número no puede recibir mensajes de WhatsApp.",
+    131021: "No se puede enviar un mensaje a este número.",
+    131049: "WhatsApp no entregó el mensaje por políticas de Meta.",
+    130472: "No entregado: el usuario forma parte de un experimento de Meta.",
+    131031: "La cuenta de WhatsApp está bloqueada.",
+    131008: "Falta un parámetro requerido en el mensaje.",
+    131009: "Un parámetro del mensaje tiene un valor inválido.",
+    190:    "La conexión con WhatsApp expiró. Reconectá la cuenta.",
+    368:    "Cuenta temporalmente bloqueada por una violación de políticas.",
+    131048: "Límite de frecuencia alcanzado. Probá nuevamente más tarde.",
+    130429: "Demasiados mensajes en poco tiempo. Probá nuevamente más tarde.",
+    131056: "Demasiados mensajes al mismo número en poco tiempo.",
+    133016: "Límite de frecuencia de la cuenta alcanzado.",
+}
+
+_FRIENDLY_DEFAULT = "No se pudo enviar el mensaje."
+_FRIENDLY_AUTH = "La conexión con WhatsApp expiró. Reconectá la cuenta."
+_FRIENDLY_TRANSIENT = "Error temporal de WhatsApp. Se reintentó sin éxito, probá de nuevo en unos minutos."
+_FRIENDLY_4XX = "WhatsApp rechazó el mensaje."
+
+
+def friendly_failure_reason(*, meta_code: Optional[int] = None,
+                            http_status: Optional[int] = None,
+                            transient: bool = False) -> str:
+    """Map a failed outbound send to a short, agent-facing Spanish reason.
+
+    Precedence: a known Meta error code wins; then HTTP 401 (auth/expired token);
+    then transient/5xx; then any other 4xx; else a generic fallback. Pure function,
+    no side effects — safe to call anywhere and trivial to unit-test.
+    """
+    if meta_code is not None and meta_code in FRIENDLY_AGENT_TEXT_ES:
+        return FRIENDLY_AGENT_TEXT_ES[meta_code]
+    if http_status == 401 or meta_code == 190:
+        return _FRIENDLY_AUTH
+    if transient or (http_status is not None and 500 <= http_status < 600):
+        return _FRIENDLY_TRANSIENT
+    if http_status is not None and 400 <= http_status < 500:
+        return _FRIENDLY_4XX
+    return _FRIENDLY_DEFAULT
+
+
 
 
 # -------------------------

{letschatty-0.4.415 → letschatty-0.4.417}/src/letschatty/models/utils/custom_exceptions/custom_exceptions.py

@@ -52,8 +52,13 @@ class UnauthorizedOrigin(CustomException):
         super().__init__(message, status_code=status_code, **context_data)
 
 class WhatsAppAPIError(CustomException):
-    def __init__(self, message="WhatsApp API error", status_code=400, **context_data):
+    def __init__(self, message="WhatsApp API error", status_code=400, meta_code: Optional[int] = None, transient: bool = False, **context_data):
         super().__init__(message, status_code=status_code, **context_data)
+        # meta_code: Meta's numeric error code parsed from the response body (when present).
+        # transient: True for retryable transport failures (clean 5xx). Both default-safe so
+        # existing call sites that don't pass them keep working.
+        self.meta_code = meta_code
+        self.transient = transient
 
 class WhatsAppPayloadValidationError(Exception):
     def __init__(self, message="WhatsApp payload validation error", status_code=400, **context_data):

{letschatty-0.4.415 → letschatty-0.4.417}/src/letschatty/services/chat/chat_service.py

@@ -485,6 +485,13 @@ class ChatService:
                     logger.warning(f"No active CC found for chat {chat.id}")
             logger.warning(f"Template {message.context.template_name} failed: {error_details.get_error_details()}")
             raise MetaErrorNotification(message=f"Template {message.context.template_name} failed", status_code=400, chat_id=chat.identifier, details=error_details.get_more_info())
+        elif status == Status.FAILED and error_details is not None:
+            # Non-template message reported FAILED by Meta (async). Surface the same
+            # friendly Spanish reason via a central notification — mirrors the sync
+            # send-failure path so both ingress points behave identically.
+            from letschatty.models.messages.meta_message_model.schema.values.value_errors import friendly_failure_reason
+            ChatService.add_central_notification_from_text(chat=chat, body=f"No se pudo enviar el mensaje: {friendly_failure_reason(meta_code=error_details.code)}", subtype=MessageSubtype.META_ERROR, content_status=CentralNotificationStatus.ERROR)
+            logger.warning(f"Message {message_id} failed (meta_code={error_details.code}): {error_details.get_error_details()}")
         return message
 
     @staticmethod