letschatty 0.4.413__tar.gz → 0.4.415__tar.gz

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

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

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

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

{letschatty-0.4.413 → letschatty-0.4.415}/src/letschatty/models/analytics/sources/__init__.py

@@ -9,4 +9,5 @@ from .source_base import SourceBase
 from .pure_ad_utm_source import PureAdUtmSource
 from .google_ad_utm_source import GoogleAdUtmSource
 from .template_source import TemplateSource
-Source = Union[OtherSource, PureAd, WhatsAppDefaultSource, TopicDefaultSource, UTMSource, PureAdUtmSource, GoogleAdUtmSource, TemplateSource]
+from .contact_import_source import ContactImportSource
+Source = Union[OtherSource, PureAd, WhatsAppDefaultSource, TopicDefaultSource, UTMSource, PureAdUtmSource, GoogleAdUtmSource, TemplateSource, ContactImportSource]

letschatty-0.4.415/src/letschatty/models/analytics/sources/contact_import_source.py

@@ -0,0 +1,38 @@
+from __future__ import annotations
+from pydantic import Field
+
+from .source_base import SourceBase
+from ...utils.types.source_types import SourceType, SourceCheckerType
+
+
+class ContactImportSource(SourceBase):
+    """Internal source for contacts created via bulk import (no inbound message).
+
+    Contact points on imported chats are created already-matched to this source,
+    so it is never run through the inbound message source-checker rotation.
+    """
+    name: str = Field(default="Contactos importados", frozen=True)
+    description: str = Field(
+        default="Contacto creado mediante importación masiva, sin mensaje entrante.",
+        frozen=True
+    )
+    category: str = Field(default="Contactos importados", frozen=True)
+    source_checker: SourceCheckerType = Field(
+        default=SourceCheckerType.CONTACT_IMPORT,
+        frozen=True
+    )
+
+    @property
+    def default_category(self) -> str:
+        return "Contactos importados"
+
+    @property
+    def type(self) -> SourceType:
+        return SourceType.CONTACT_IMPORT
+
+    def __eq__(self, other: object) -> bool:
+        """Contact-import sources are unique per company, so they're equal if they're the same type"""
+        return isinstance(other, ContactImportSource)
+
+    def __hash__(self) -> int:
+        return hash(self.type)

{letschatty-0.4.413 → letschatty-0.4.415}/src/letschatty/models/analytics/sources/helpers.py

@@ -9,7 +9,8 @@ SOURCE_CHECKER_MAPPING = {
     SourceType.UTM_SOURCE: [SourceCheckerType.CHATTY_PIXEL],
     SourceType.PURE_AD_UTM_SOURCE: [SourceCheckerType.AD_ID_IN_UTM_PARAMS],
     SourceType.GOOGLE_AD_UTM_SOURCE: [SourceCheckerType.AD_ID_IN_UTM_PARAMS],
-    SourceType.TEMPLATE_SOURCE: [SourceCheckerType.TEMPLATE]
+    SourceType.TEMPLATE_SOURCE: [SourceCheckerType.TEMPLATE],
+    SourceType.CONTACT_IMPORT: [SourceCheckerType.CONTACT_IMPORT]
 }
 
 class SourceHelpers:

{letschatty-0.4.413 → letschatty-0.4.415}/src/letschatty/models/analytics/sources/pure_ad.py

@@ -1,5 +1,5 @@
 from __future__ import annotations
-from pydantic import Field, ConfigDict
+from pydantic import Field, ConfigDict, field_validator
 from typing import Optional
 from .source_base import SourceBase
 from ...utils.types.source_types import SourceType, SourceCheckerType
@@ -16,6 +16,19 @@ class PureAd(SourceBase):
     meta_image_url: Optional[str] = Field(default=None)
     meta_thumbnail_url: Optional[str] = Field(default=None)
 
+    @field_validator("meta_ad_url", "meta_referral_type", "meta_body",
+                     "meta_headline", "meta_media_type", mode="before")
+    @classmethod
+    def _coerce_none_to_empty(cls, v: object) -> object:
+        # Meta sends these Click-to-WhatsApp referral fields as null for ads that
+        # lack that element (e.g. image-only ads have no body/headline, some
+        # formats have no media_type). ChattyReferral types them Optional, but
+        # these PureAd fields are `str`, and pydantic v2 rejects an explicit None
+        # for a `str` field even when default="" — the default only applies when
+        # the key is ABSENT, not when it's present-but-null. Coerce None -> "" so
+        # a legitimate ad with missing text doesn't 500 the webhook.
+        return "" if v is None else v
+
     exclude_fields = {
         SerializerType.FRONTEND_ASSET_PREVIEW: {"meta_ad_url", "meta_referral_type", "meta_body", "meta_headline", "meta_media_type", "meta_video_url", "meta_image_url", "meta_thumbnail_url"}
     }

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

@@ -358,7 +358,7 @@ 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
+            dump["last_message_timestamp"]= self.last_message_timestamp or self.created_at
             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.413 → letschatty-0.4.415}/src/letschatty/models/utils/types/source_types.py

@@ -10,6 +10,7 @@ class SourceType(StrEnum):
     PURE_AD_UTM_SOURCE = "pure_ad_utm_source"
     GOOGLE_AD_UTM_SOURCE = "google_ad_utm_source"
     TEMPLATE_SOURCE = "template_source"
+    CONTACT_IMPORT = "contact_import"
     @classmethod
     def list(cls):
         return [member.value for member in cls]
@@ -23,6 +24,7 @@ class SourceCheckerType(StrEnum):
     AD_ID_IN_UTM_PARAMS = "ad_id_in_utm_params"
     CHATTY_PIXEL = "chatty_pixel"
     TEMPLATE = "template"
+    CONTACT_IMPORT = "contact_import"
 
 source_checker_types_schema = {
     SourceCheckerType.SMART_MESSAGES: {
@@ -56,6 +58,10 @@ source_checker_types_schema = {
     SourceCheckerType.TEMPLATE: {
         "label": "Plantilla de mensaje",
         "description": "Chatty reconoce directamente las plantillas de mensaje como fuentes de origen, identificando el nombre de la plantilla."
+    },
+    SourceCheckerType.CONTACT_IMPORT: {
+        "label": "Contacto importado",
+        "description": "Método interno de Chatty para atribuir contactos creados mediante importación masiva. No matchea mensajes entrantes."
     }
 }
 
@@ -87,6 +93,10 @@ source_types_schema = {
     SourceType.TOPIC_DEFAULT_SOURCE: {
         "label": "Fuente para mensajes de topics sin fuente de origen",
         "description": "Fuente predeterminada de Chatty para usuarios que envían un smart message de un topic, sin que tengan una fuente de origen específica."
+    },
+    SourceType.CONTACT_IMPORT: {
+        "label": "Contactos importados",
+        "description": "Fuente interna de Chatty para contactos creados mediante importación masiva (sin mensaje entrante)."
     }
 }
 

{letschatty-0.4.413 → letschatty-0.4.415}/src/letschatty/services/factories/analytics/sources/helpers.py

@@ -1,6 +1,6 @@
 from typing import Type
 from .....models.utils.types.source_types import SourceType
-from .....models.analytics.sources import OtherSource, PureAd, WhatsAppDefaultSource, TopicDefaultSource, UTMSource, Source, PureAdUtmSource, GoogleAdUtmSource, TemplateSource
+from .....models.analytics.sources import OtherSource, PureAd, WhatsAppDefaultSource, TopicDefaultSource, UTMSource, Source, PureAdUtmSource, GoogleAdUtmSource, TemplateSource, ContactImportSource
 
 class SourceFactoryHelpers:
     @staticmethod
@@ -13,5 +13,6 @@ class SourceFactoryHelpers:
             SourceType.UTM_SOURCE: UTMSource,
             SourceType.PURE_AD_UTM_SOURCE: PureAdUtmSource,
             SourceType.GOOGLE_AD_UTM_SOURCE: GoogleAdUtmSource,
-            SourceType.TEMPLATE_SOURCE: TemplateSource
+            SourceType.TEMPLATE_SOURCE: TemplateSource,
+            SourceType.CONTACT_IMPORT: ContactImportSource
         }[source_type]

{letschatty-0.4.413 → letschatty-0.4.415}/src/letschatty/services/factories/analytics/sources/source_factory.py

@@ -4,7 +4,7 @@ import logging
 
 from letschatty.models.company.empresa import EmpresaModel
 
-from .....models.analytics.sources import GoogleAdUtmSource, PureAdUtmSource, SourceBase, WhatsAppDefaultSource, TopicDefaultSource, PureAd, Source, TemplateSource, OtherSource
+from .....models.analytics.sources import GoogleAdUtmSource, PureAdUtmSource, SourceBase, WhatsAppDefaultSource, TopicDefaultSource, PureAd, Source, TemplateSource, OtherSource, ContactImportSource
 from .....models.company.assets.ai_agents_v2.chatty_ai_agent_config_for_automation import ChattyAIConfigForAutomation
 from .....models.company.assets.ai_agents_v2.chatty_ai_agent_config_for_automation import ChattyAIMode
 from .....models.utils.types.identifier import StrObjectId
@@ -50,6 +50,14 @@ class SourceFactory:
             updated_at=datetime.now(ZoneInfo("UTC")),
             )
 
+    @staticmethod
+    def create_contact_import_source(company_id: str) -> ContactImportSource:
+        return ContactImportSource(
+            company_id=company_id,
+            created_at=datetime.now(ZoneInfo("UTC")),
+            updated_at=datetime.now(ZoneInfo("UTC")),
+            )
+
     @staticmethod
     def create_topic_default_source(topic: Topic, company_id: str, whatsapp_default_source: WhatsAppDefaultSource) -> TopicDefaultSource:
         return TopicDefaultSource(