letschatty 0.4.332__py3-none-any.whl → 0.4.334__py3-none-any.whl

letschatty/models/ai_microservices/expected_output.py

@@ -169,6 +169,12 @@ class ExpectedOutputIncomingMessage(BaseModel):
     action: IncomingMessageDecisionAction
     messages: List[str] = Field(description="Array of message strings to send to the customer. Required for send/suggest actions, optional for escalate action, empty array for skip/remove actions.")
     chain_of_thought: ChainOfThoughtInChatRequest = Field(description="REQUIRED: Your reasoning process and response decision explanation")
+    confidence: Optional[int] = Field(
+        default=None,
+        ge=0,
+        le=100,
+        description="Confidence level 0-100"
+    )
 
     def to_incoming_message_decision_output(self) -> IncomingMessageAIDecision:
         messages_drafts = [
@@ -187,3 +193,5 @@ class ExpectedOutputIncomingMessage(BaseModel):
         return incoming_decision
 
 
+class ExpectedOutputSmartFollowUp(BaseModel):
+    action: Optional[str] = None

letschatty/models/ai_microservices/lambda_events.py

@@ -5,8 +5,9 @@ from typing import Dict, Any, List, Optional
 from letschatty.models.base_models.ai_agent_component import AiAgentComponentType
 from letschatty.models.utils.types.identifier import StrObjectId
 from .lambda_invokation_types import InvokationType, LambdaAiEvent
-from .expected_output import ExpectedOutputIncomingMessage, ExpectedOutputSmartTag, ExpectedOutputQualityTest, IncomingMessageAIDecision
+from .expected_output import ExpectedOutputIncomingMessage, ExpectedOutputSmartTag, ExpectedOutputQualityTest, ExpectedOutputSmartFollowUp, IncomingMessageAIDecision
 from ...models.company.assets.ai_agents_v2.ai_agents_decision_output import IncomingMessageDecisionAction
+from ...models.company.assets.ai_agents_v2.chatty_ai_agent_in_chat import HumanInterventionReason
 
 class SmartTaggingCallbackMetadata(BaseModel):
     chat_id: StrObjectId
@@ -77,6 +78,11 @@ class FollowUpEvent(LambdaAiEvent):
     type: InvokationType = InvokationType.FOLLOW_UP
     data: ChatData
 
+
+class SmartFollowUpDecisionOutputEvent(LambdaAiEvent):
+    type: InvokationType = InvokationType.FOLLOW_UP
+    data: ExpectedOutputSmartFollowUp
+
 class QualityTestEventData(BaseModel):
     chat_example_id: StrObjectId
     company_id: StrObjectId

letschatty/models/analytics/events/__init__.py

@@ -4,7 +4,7 @@ from .chat_based_events.business_area import ChatBusinessAreaEvent, BusinessArea
 from .chat_based_events.workflow import WorkflowEvent, WorkflowEventData
 from .chat_based_events.chat_status import ChatStatusEvent, ChatStatusEventData, ChatStatusModification, ChatCreatedFrom
 from .chat_based_events.chat_funnel import ChatFunnelEvent, FunnelEventData
-from ...company.CRM.funnel import ClientFunnel, StageTransition
+from ...company.CRM.funnel import ChatFunnel, StageTransition, ActiveFunnel
 from .company_based_events.user_events import UserEvent, UserEventData
 from .chat_based_events.quality_scoring import QualityScoringEvent
 from .chat_based_events.message import MessageEvent, MessageData

letschatty/models/analytics/events/chat_based_events/chat_funnel.py

@@ -4,37 +4,93 @@ from ..base import Event
 from ..event_types import EventType
 from .chat_based_event import CustomerEventData
 from ....utils.types.identifier import StrObjectId
-from ....company.CRM.funnel import ClientFunnel, StageTransition
+from ....company.CRM.funnel import StageTransition
 import json
 
+
 class FunnelEventData(CustomerEventData):
-    funnel_id: StrObjectId
-    funnel_stage_transition: StageTransition
-    time_in_funnel_seconds: Optional[int] = None
+    """
+    Event data for chat funnel events.
+    
+    Fields required per event type:
+    - STARTED: funnel_id, chat_funnel_id, stage_transition
+    - STAGE_CHANGED: funnel_id, chat_funnel_id, stage_transition (with time_in_previous_stage_seconds)
+    - COMPLETED: funnel_id, chat_funnel_id, time_in_funnel_seconds, time_in_last_stage_seconds
+    - ABANDONED: funnel_id, chat_funnel_id, time_in_funnel_seconds, time_in_last_stage_seconds
+    """
+    funnel_id: StrObjectId = Field(description="The funnel the chat is in")
+    chat_funnel_id: StrObjectId = Field(description="Reference to the ChatFunnel record")
+    
+    # For STARTED and STAGE_CHANGED events
+    stage_transition: Optional[StageTransition] = Field(
+        default=None,
+        description="The stage transition details (for STARTED and STAGE_CHANGED)"
+    )
+    
+    # For COMPLETED and ABANDONED events
+    time_in_funnel_seconds: Optional[int] = Field(
+        default=None,
+        description="Total time spent in the funnel (for COMPLETED and ABANDONED)"
+    )
+    time_in_last_stage_seconds: Optional[int] = Field(
+        default=None,
+        description="Time spent in the last stage before completion/abandonment"
+    )
+
 
 class ChatFunnelEvent(Event):
-    """Event for tracking chat funnel stage transitions"""
+    """
+    Event for tracking chat funnel lifecycle.
+    
+    Events:
+    - CHAT_FUNNEL_STARTED: Chat entered a funnel
+    - CHAT_FUNNEL_STAGE_CHANGED: Chat moved between stages
+    - CHAT_FUNNEL_COMPLETED: Chat completed the funnel
+    - CHAT_FUNNEL_ABANDONED: Chat abandoned the funnel
+    """
     data: FunnelEventData
 
-    # Define valid event types for this event class
     VALID_TYPES: ClassVar[set] = {
-        EventType.CHAT_FUNNEL_UPDATED,
         EventType.CHAT_FUNNEL_STARTED,
+        EventType.CHAT_FUNNEL_STAGE_CHANGED,
         EventType.CHAT_FUNNEL_COMPLETED,
         EventType.CHAT_FUNNEL_ABANDONED
     }
 
-
     @field_validator('data')
     def validate_data_fields(cls, v: FunnelEventData, info: ValidationInfo):
         """Validate that appropriate fields are set based on event type"""
-        if info.data.get('type') == EventType.CHAT_FUNNEL_UPDATED and v.time_in_funnel_seconds is None:
-            raise ValueError("time_in_funnel_seconds must be set for CHAT_FUNNEL_UPDATED events")
-        if info.data.get('type') == EventType.CHAT_FUNNEL_UPDATED and v.funnel_stage_transition.time_in_previous_stage_seconds is None:
-            raise ValueError("time_in_previous_stage_seconds must be set for CHAT_FUNNEL_UPDATED events")
+        event_type = info.data.get('type')
+        
+        # STARTED: requires stage_transition
+        if event_type == EventType.CHAT_FUNNEL_STARTED:
+            if v.stage_transition is None:
+                raise ValueError("stage_transition must be set for CHAT_FUNNEL_STARTED events")
+        
+        # STAGE_CHANGED: requires stage_transition with time_in_previous_stage_seconds
+        elif event_type == EventType.CHAT_FUNNEL_STAGE_CHANGED:
+            if v.stage_transition is None:
+                raise ValueError("stage_transition must be set for CHAT_FUNNEL_STAGE_CHANGED events")
+            if v.stage_transition.time_in_previous_stage_seconds is None:
+                raise ValueError("time_in_previous_stage_seconds must be set in stage_transition for CHAT_FUNNEL_STAGE_CHANGED events")
+        
+        # COMPLETED: requires time metrics
+        elif event_type == EventType.CHAT_FUNNEL_COMPLETED:
+            if v.time_in_funnel_seconds is None:
+                raise ValueError("time_in_funnel_seconds must be set for CHAT_FUNNEL_COMPLETED events")
+            if v.time_in_last_stage_seconds is None:
+                raise ValueError("time_in_last_stage_seconds must be set for CHAT_FUNNEL_COMPLETED events")
+        
+        # ABANDONED: requires time metrics
+        elif event_type == EventType.CHAT_FUNNEL_ABANDONED:
+            if v.time_in_funnel_seconds is None:
+                raise ValueError("time_in_funnel_seconds must be set for CHAT_FUNNEL_ABANDONED events")
+            if v.time_in_last_stage_seconds is None:
+                raise ValueError("time_in_last_stage_seconds must be set for CHAT_FUNNEL_ABANDONED events")
+        
         return v
 
     def model_dump_json(self, *args, **kwargs):
         dump = json.loads(super().model_dump_json(*args, **kwargs))
         dump['data'] = self.data.model_dump_json()
-        return dump
+        return dump

letschatty/models/analytics/events/company_based_events/asset_events.py

@@ -58,6 +58,9 @@ class AssetEvent(Event):
         EventType.FUNNEL_STAGE_CREATED,
         EventType.FUNNEL_STAGE_UPDATED,
         EventType.FUNNEL_STAGE_DELETED,
+        EventType.FUNNEL_MEMBER_ADDED,
+        EventType.FUNNEL_MEMBER_UPDATED,
+        EventType.FUNNEL_MEMBER_REMOVED,
         EventType.WORKFLOW_CREATED,
         EventType.WORKFLOW_UPDATED,
         EventType.WORKFLOW_DELETED,
@@ -80,8 +83,9 @@ class AssetEvent(Event):
 
     @model_validator(mode='after')
     def validate_data_fields(self):
-        if "deleted" not in self.type.value and not self.data.asset:
-            raise ValueError("asset must be set for all events except DELETED")
+        # Asset is not required for deleted/removed events
+        if "deleted" not in self.type.value and "removed" not in self.type.value and not self.data.asset:
+            raise ValueError("asset must be set for all events except DELETED/REMOVED")
         return self
 
     def model_dump_json(self, *args, **kwargs):

letschatty/models/analytics/events/event_type_to_classes.py

@@ -41,10 +41,9 @@ EVENT_TO_TYPE_CLASSES = {
     #CONTINUOUS CONVERSATION
     EventType.CONTINUOUS_CONVERSATION_CREATED : ContinuousConversationEvent,
     EventType.CONTINUOUS_CONVERSATION_UPDATED : ContinuousConversationEvent,
-    #FUNNEL STAGES
-    # Funnel-level events
+    #CHAT FUNNEL EVENTS
     EventType.CHAT_FUNNEL_STARTED : ChatFunnelEvent,
-    EventType.CHAT_FUNNEL_UPDATED : ChatFunnelEvent,
+    EventType.CHAT_FUNNEL_STAGE_CHANGED : ChatFunnelEvent,
     EventType.CHAT_FUNNEL_COMPLETED : ChatFunnelEvent,
     EventType.CHAT_FUNNEL_ABANDONED : ChatFunnelEvent,
 

letschatty/models/analytics/events/event_types.py

@@ -42,10 +42,9 @@ class EventType(StrEnum):
     #CONTINUOUS CONVERSATION
     CONTINUOUS_CONVERSATION_CREATED = "chat.continuous_conversation.created"
     CONTINUOUS_CONVERSATION_UPDATED = "chat.continuous_conversation.updated"
-    #FUNNEL STAGES
-    # Funnel-level events
-    CHAT_FUNNEL_STARTED = "chat.funnel.started"  # New
-    CHAT_FUNNEL_UPDATED = "chat.funnel.updated"
+    #CHAT FUNNEL EVENTS
+    CHAT_FUNNEL_STARTED = "chat.funnel.started"
+    CHAT_FUNNEL_STAGE_CHANGED = "chat.funnel.stage_changed"
     CHAT_FUNNEL_COMPLETED = "chat.funnel.completed"
     CHAT_FUNNEL_ABANDONED = "chat.funnel.abandoned"
 
@@ -84,13 +83,18 @@ class EventType(StrEnum):
     FAST_ANSWER_CREATED = "company.fast_answer.created"
     FAST_ANSWER_UPDATED = "company.fast_answer.updated"
     FAST_ANSWER_DELETED = "company.fast_answer.deleted"
-    #FUNNEL STAGES
+    #FUNNELS
     FUNNEL_CREATED = "company.funnel.created"
     FUNNEL_UPDATED = "company.funnel.updated"
     FUNNEL_DELETED = "company.funnel.deleted"
+    #FUNNEL STAGES
     FUNNEL_STAGE_CREATED = "company.funnel_stage.created"
     FUNNEL_STAGE_UPDATED = "company.funnel_stage.updated"
     FUNNEL_STAGE_DELETED = "company.funnel_stage.deleted"
+    #FUNNEL MEMBERS
+    FUNNEL_MEMBER_ADDED = "company.funnel_member.added"
+    FUNNEL_MEMBER_UPDATED = "company.funnel_member.updated"
+    FUNNEL_MEMBER_REMOVED = "company.funnel_member.removed"
     #BUSINESS AREA
     BUSINESS_AREA_CREATED = "company.business_area.created"
     BUSINESS_AREA_UPDATED = "company.business_area.updated"

letschatty/models/chat/chat.py

@@ -19,6 +19,7 @@ from ..utils.custom_exceptions.custom_exceptions import MissingAIAgentForSmartFo
 from .time_left import TimeLeft
 from ..company.conversation_topic import TopicTimelineEntry
 from ..company.form_field import CollectedData
+from ..company.CRM.funnel import ActiveFunnel
 import json
 import logging
 logger = logging.getLogger(__name__)
@@ -47,6 +48,7 @@ class Chat(CompanyAssetModel):
     chatty_ai_agent: Optional[ChattyAIAgentAssignedToChat] = Field(default=None, description="The id of the chatty ai agent that might or might not be assigned to the chat")
     suggested_messages: List[MessageDraft] = Field(default_factory=list)
     topics_timeline: List[TopicTimelineEntry] = Field(default_factory=list, description="Timeline of conversation topics throughout the conversation")
+    active_funnel: Optional[ActiveFunnel] = Field(default=None, description="Current active funnel for this chat")
     model_config = ConfigDict(extra="ignore")
 
     @property

letschatty/models/chat/chat_with_assets.py

@@ -1,6 +1,6 @@
-
 from .chat import Chat
 from letschatty.models.company.assets import TagPreview, FlowPreview, ContactPoint, Sale, ChattyAIAgentPreview, ProductPreview
+from letschatty.models.company.CRM.funnel import ActiveFunnel
 
 from letschatty.models.utils.types.serializer_type import SerializerType
 from pydantic import BaseModel
@@ -15,3 +15,8 @@ class ChatWithAssets(BaseModel):
     contact_points: List[ContactPoint]
     flows_links_states: List[FlowPreview]
     chatty_ai_agent: Optional[ChattyAIAgentPreview]
+
+    @property
+    def active_funnel(self) -> Optional[ActiveFunnel]:
+        """Convenience property to access the chat's active funnel"""
+        return self.chat.active_funnel

letschatty/models/chat/client.py

@@ -5,7 +5,6 @@ from ..utils.types.identifier import StrObjectId
 from .quality_scoring import QualityScore
 from .highlight import Highlight
 from ..company.assets.chat_assets import AssignedAssetToChat, SaleAssignedToChat, ContactPointAssignedToChat
-from ..company.CRM.funnel import ClientFunnel
 from ..utils.types.serializer_type import SerializerType
 
 class Client(CompanyAssetModel):
@@ -23,7 +22,6 @@ class Client(CompanyAssetModel):
     contact_points: List[ContactPointAssignedToChat] = Field(default=list())
     business_area: Optional[StrObjectId] = Field(default=None, description="It's a business related area, that works as a queue for the chats")
     external_id: Optional[str] = Field(default=None)
-    funnels : List[ClientFunnel] = Field(default=list())
     exclude_fields = {
         SerializerType.FRONTEND: {"products", "tags", "sales", "contact_points", "highlights"}
     }

letschatty/models/company/CRM/funnel.py

@@ -1,69 +1,401 @@
-from ...base_models import CompanyAssetModel
-from typing import List
+from ...base_models import CompanyAssetModel, ChattyAssetPreview, ChattyAssetModel
+from typing import List, Optional, ClassVar, Any
 from ...utils.types.identifier import StrObjectId
-from pydantic import BaseModel, Field
+from pydantic import BaseModel, Field, ConfigDict
 from enum import StrEnum
 from datetime import datetime
-from typing import Optional
 from zoneinfo import ZoneInfo
 from ...utils.types.executor_types import ExecutorType
+from ..assets.automation import Automation
+
+
+# ============================================================================
+# Enums
+# ============================================================================
 
 class FunnelStatus(StrEnum):
+    """Status of a chat within a funnel"""
     IN_PROGRESS = "in_progress"
     COMPLETED = "completed"
     ABANDONED = "abandoned"
 
+
+class FunnelMemberRole(StrEnum):
+    """Role of a user within a funnel"""
+    ADMIN = "admin"      # Full control over funnel settings, stages, and members
+    EDITOR = "editor"    # Can move chats between stages, view all chats
+    VIEWER = "viewer"    # Read-only access to funnel and chats
+
+
+# ============================================================================
+# Embedded Models (BaseModel)
+# ============================================================================
+
 class StageTransition(BaseModel):
-    from_stage_id: Optional[StrObjectId] = None
-    to_stage_id: StrObjectId
-    transitioned_at: datetime = Field(default=datetime.now(ZoneInfo("UTC")))
-    executor_type: ExecutorType
-    executor_id: StrObjectId
-    time_in_previous_stage_seconds: Optional[int] = None
-
-class ClientFunnel(CompanyAssetModel):
+    """
+    Record of a chat transitioning between stages within a funnel.
+    Tracks the transition details and time spent in the previous stage.
+    """
+    from_stage_id: Optional[StrObjectId] = Field(
+        default=None, 
+        description="The stage the chat came from (None if entering funnel)"
+    )
+    to_stage_id: StrObjectId = Field(description="The stage the chat moved to")
+    transitioned_at: datetime = Field(default_factory=lambda: datetime.now(ZoneInfo("UTC")))
+    executor_type: ExecutorType = Field(description="Type of executor that triggered the transition")
+    executor_id: StrObjectId = Field(description="ID of the executor that triggered the transition")
+    time_in_previous_stage_seconds: Optional[int] = Field(
+        default=None, 
+        description="Time spent in the previous stage before this transition"
+    )
+    from_stage_order: Optional[int] = Field(
+        default=None,
+        description="Order of the from_stage at transition time (for detecting regressions)"
+    )
+    to_stage_order: Optional[int] = Field(
+        default=None,
+        description="Order of the to_stage at transition time"
+    )
+
+    @property
+    def is_regression(self) -> bool:
+        """Check if this transition moved backwards in the funnel"""
+        if self.from_stage_order is None or self.to_stage_order is None:
+            return False
+        return self.to_stage_order < self.from_stage_order
+
+    @property
+    def is_entry(self) -> bool:
+        """Check if this is an entry transition (no previous stage)"""
+        return self.from_stage_id is None
+
+
+class ActiveFunnel(BaseModel):
+    """
+    Lightweight funnel state embedded in Chat for fast filtering and display.
+    
+    The full history (stage_transitions, time metrics) is stored in the
+    separate chat_funnels collection via ChatFunnel.
+    """
+    chat_funnel_id: StrObjectId = Field(
+        description="Reference to the full ChatFunnel document in chat_funnels collection"
+    )
+    funnel_id: StrObjectId = Field(description="The funnel the chat is in")
+    funnel_name: str = Field(description="Denormalized funnel name for display")
+    current_stage_id: StrObjectId = Field(description="Current stage ID")
+    current_stage_name: str = Field(description="Denormalized stage name for display")
+    entered_current_stage_at: datetime = Field(
+        default_factory=lambda: datetime.now(ZoneInfo("UTC")),
+        description="When the chat entered the current stage"
+    )
+
+    @property
+    def time_in_current_stage_seconds(self) -> int:
+        """Calculate time spent in the current stage"""
+        return int((datetime.now(tz=ZoneInfo("UTC")) - self.entered_current_stage_at).total_seconds())
+
+    def update_stage(self, stage_id: StrObjectId, stage_name: str) -> None:
+        """Update the current stage (called when transitioning)"""
+        self.current_stage_id = stage_id
+        self.current_stage_name = stage_name
+        self.entered_current_stage_at = datetime.now(tz=ZoneInfo("UTC"))
+
+
+# ============================================================================
+# Preview Classes - For efficient listing
+# ============================================================================
+
+class FunnelPreview(ChattyAssetPreview):
+    """Preview of a Funnel for listing without full data"""
+    is_active: bool = Field(default=True)
+    
+    @classmethod
+    def get_projection(cls) -> dict[str, Any]:
+        base = super().get_projection()
+        base["is_active"] = 1
+        return base
+
+    @classmethod
+    def from_asset(cls, asset: 'Funnel') -> 'FunnelPreview':
+        return cls(
+            _id=asset.id,
+            name=asset.name,
+            company_id=asset.company_id,
+            created_at=asset.created_at,
+            deleted_at=asset.deleted_at,
+            is_active=asset.is_active
+        )
+
+
+class FunnelStagePreview(ChattyAssetPreview):
+    """Preview of a FunnelStage for listing"""
     funnel_id: StrObjectId
-    status: FunnelStatus
-    started_at: datetime = Field(default=datetime.now(ZoneInfo("UTC")))
-    completed_at: Optional[datetime] = None
-    abandoned_at: Optional[datetime] = None
-    current_stage_id: Optional[StrObjectId] = None
-    entered_current_stage_at: datetime
-    stage_transitions: List[StageTransition] = Field(default_factory=list)
+    color: str
+    order: int
+    is_exit_stage: bool = Field(default=False)
+
+    @classmethod
+    def get_projection(cls) -> dict[str, Any]:
+        base = super().get_projection()
+        base.update({
+            "funnel_id": 1,
+            "color": 1,
+            "order": 1,
+            "is_exit_stage": 1
+        })
+        return base
+
+    @classmethod
+    def from_asset(cls, asset: 'FunnelStage') -> 'FunnelStagePreview':
+        return cls(
+            _id=asset.id,
+            name=asset.name,
+            company_id=asset.company_id,
+            created_at=asset.created_at,
+            deleted_at=asset.deleted_at,
+            funnel_id=asset.funnel_id,
+            color=asset.color,
+            order=asset.order,
+            is_exit_stage=asset.is_exit_stage
+        )
+
+
+# ============================================================================
+# Company Assets (CompanyAssetModel) - Stored in separate collections
+# ============================================================================
+
+class Funnel(CompanyAssetModel):
+    """
+    A funnel represents a pipeline/process for managing chats (e.g., sales funnel, support pipeline).
+    Companies can create multiple funnels to organize their chat workflows.
+    """
+    name: str = Field(description="Name of the funnel")
+    description: Optional[str] = Field(default=None, description="Description of the funnel's purpose")
+    created_by: StrObjectId = Field(description="User ID who created the funnel")
+    is_active: bool = Field(default=True, description="Whether the funnel is active or archived")
+
+    preview_class: ClassVar[type[FunnelPreview]] = FunnelPreview
+
+    model_config = ConfigDict(
+        validate_by_name=True,
+        validate_by_alias=True
+    )
+
+
+class FunnelStage(CompanyAssetModel):
+    """
+    A stage within a funnel. Stages are ordered and can have automations
+    that execute when a chat enters the stage.
+    """
+    funnel_id: StrObjectId = Field(frozen=True, description="The funnel this stage belongs to")
+    name: str = Field(description="Name of the stage")
+    description: Optional[str] = Field(default=None, description="Description of the stage")
+    color: str = Field(default="#808080", description="Hex color for the stage (e.g., '#FFAA00')")
+    order: int = Field(ge=0, description="Position of the stage in the funnel (0-indexed)")
+    inflexion_conversion_point: bool = Field(
+        default=False, 
+        description="If true, prioritized for chat assignment and sends notifications in automatic mode"
+    )
+    is_exit_stage: bool = Field(
+        default=False,
+        description="If true, moving to this stage completes the funnel for the chat"
+    )
+    automations: Automation = Field(
+        default_factory=Automation,
+        description="Automations to execute when a chat enters this stage"
+    )
+
+    preview_class: ClassVar[type[FunnelStagePreview]] = FunnelStagePreview
+
+    model_config = ConfigDict(
+        validate_by_name=True,
+        validate_by_alias=True
+    )
+
+
+class FunnelMember(CompanyAssetModel):
+    """
+    A user's membership in a funnel with their assigned role.
+    Determines what actions the user can perform within the funnel.
+    """
+    name: str = Field(default="Funnel Member", description="Name for asset compatibility")
+    funnel_id: StrObjectId = Field(frozen=True, description="The funnel this membership belongs to")
+    user_id: StrObjectId = Field(frozen=True, description="The user who is a member")
+    role: FunnelMemberRole = Field(description="The user's role within the funnel")
+
+    model_config = ConfigDict(
+        validate_by_name=True,
+        validate_by_alias=True
+    )
+
+    @property
+    def can_edit(self) -> bool:
+        """Check if the member can edit (move chats, etc.)"""
+        return self.role in (FunnelMemberRole.ADMIN, FunnelMemberRole.EDITOR)
+
+    @property
+    def can_admin(self) -> bool:
+        """Check if the member can administer the funnel"""
+        return self.role == FunnelMemberRole.ADMIN
+
+
+# ============================================================================
+# ChatFunnel - Stored in separate chat_funnels collection
+# This is a ChattyAssetModel (not CompanyAssetModel) because it's a chat history
+# record rather than a company-level asset.
+# ============================================================================
+
+class ChatFunnel(ChattyAssetModel):
+    """
+    Full record of a chat's journey through a funnel.
+    Stored in a separate 'chat_funnels' collection, NOT embedded in chat.
+    
+    This extends ChattyAssetModel (not CompanyAssetModel) because it's a 
+    chat-level record tracking funnel history, not a company-owned asset.
+    
+    A new ChatFunnel is created each time a chat enters a funnel.
+    If a chat completes a funnel and enters it again, a NEW ChatFunnel is created.
+    
+    The Chat document stores a lightweight ActiveFunnel for fast
+    filtering and display, with a reference to this full record.
+    """
+    company_id: StrObjectId = Field(frozen=True, description="Company for multi-tenant isolation")
+    chat_id: StrObjectId = Field(frozen=True, description="The chat this funnel record belongs to")
+    funnel_id: StrObjectId = Field(frozen=True, description="The funnel the chat entered")
+    status: FunnelStatus = Field(default=FunnelStatus.IN_PROGRESS)
+    started_at: datetime = Field(default_factory=lambda: datetime.now(ZoneInfo("UTC")))
+    completed_at: Optional[datetime] = Field(default=None)
+    abandoned_at: Optional[datetime] = Field(default=None)
+    current_stage_id: Optional[StrObjectId] = Field(
+        default=None, 
+        description="Current stage ID (None if funnel is completed/abandoned)"
+    )
+    entered_current_stage_at: Optional[datetime] = Field(
+        default=None,
+        description="When the chat entered the current stage"
+    )
+    stage_transitions: List[StageTransition] = Field(
+        default_factory=list,
+        description="Complete history of all stage transitions"
+    )
+
+    model_config = ConfigDict(
+        validate_by_name=True,
+        validate_by_alias=True
+    )
 
     @property
     def is_completed(self) -> bool:
-        return self.completed_at is not None
+        """Check if the chat has completed the funnel"""
+        return self.status == FunnelStatus.COMPLETED and self.completed_at is not None
 
     @property
     def is_abandoned(self) -> bool:
-        return self.abandoned_at is not None
+        """Check if the chat has abandoned the funnel"""
+        return self.status == FunnelStatus.ABANDONED and self.abandoned_at is not None
+
+    @property
+    def is_active(self) -> bool:
+        """Check if the chat is still active in the funnel"""
+        return self.status == FunnelStatus.IN_PROGRESS
 
     @property
     def time_in_funnel_seconds(self) -> int:
+        """Calculate total time spent in the funnel"""
         end_time = self.completed_at or self.abandoned_at or datetime.now(tz=ZoneInfo("UTC"))
         return int((end_time - self.started_at).total_seconds())
 
     @property
     def time_in_current_stage_seconds(self) -> Optional[int]:
-        if not self.entered_current_stage_at:
+        """Calculate time spent in the current stage"""
+        if not self.entered_current_stage_at or not self.current_stage_id:
             return None
         return int((datetime.now(tz=ZoneInfo("UTC")) - self.entered_current_stage_at).total_seconds())
 
     @property
     def unique_stages_visited(self) -> int:
+        """Count of unique stages the chat has visited"""
         return len(set(t.to_stage_id for t in self.stage_transitions))
 
-class FunnelStage(CompanyAssetModel):
-    name: str
-    description: str
-    index: int
-    inflexion_conversion_point: bool = Field(default=False, description="If true, it'll be prioritized for chat assignment and will send notifications in automatic mode to all agents.")
-    workflow_ids: List[StrObjectId] = Field(default_factory=list)
+    @property
+    def total_transitions(self) -> int:
+        """Total number of stage transitions"""
+        return len(self.stage_transitions)
 
+    @property
+    def regression_count(self) -> int:
+        """Count of times the chat moved backwards in the funnel"""
+        return sum(1 for t in self.stage_transitions if t.is_regression)
 
-class Funnel(CompanyAssetModel):
-    name: str
-    description: str
-    stages: List[FunnelStage]
-    assignment_priority: int = Field(ge=0, le=10, description="Priority for chat assignment, between funnels")
+    @property
+    def last_transition(self) -> Optional[StageTransition]:
+        """Get the most recent stage transition"""
+        return self.stage_transitions[-1] if self.stage_transitions else None
+
+    def record_transition(
+        self,
+        to_stage_id: StrObjectId,
+        executor_type: ExecutorType,
+        executor_id: StrObjectId,
+        from_stage_order: Optional[int] = None,
+        to_stage_order: Optional[int] = None
+    ) -> StageTransition:
+        """
+        Record a transition to a new stage.
+        Returns the created StageTransition.
+        
+        Args:
+            to_stage_id: The stage to transition to
+            executor_type: Who/what triggered the transition
+            executor_id: ID of the executor
+            from_stage_order: Order of current stage (for regression detection)
+            to_stage_order: Order of target stage (for regression detection)
+        """
+        time_in_previous = self.time_in_current_stage_seconds
+        
+        transition = StageTransition(
+            from_stage_id=self.current_stage_id,
+            to_stage_id=to_stage_id,
+            executor_type=executor_type,
+            executor_id=executor_id,
+            time_in_previous_stage_seconds=time_in_previous,
+            from_stage_order=from_stage_order,
+            to_stage_order=to_stage_order
+        )
+        
+        self.stage_transitions.append(transition)
+        self.current_stage_id = to_stage_id
+        self.entered_current_stage_at = transition.transitioned_at
+        
+        return transition
+
+    def complete(self) -> None:
+        """Mark the funnel as completed"""
+        self.status = FunnelStatus.COMPLETED
+        self.completed_at = datetime.now(tz=ZoneInfo("UTC"))
+
+    def abandon(self) -> None:
+        """Mark the funnel as abandoned"""
+        self.status = FunnelStatus.ABANDONED
+        self.abandoned_at = datetime.now(tz=ZoneInfo("UTC"))
+
+    def to_active_funnel(self, funnel_name: str, stage_name: str) -> ActiveFunnel:
+        """
+        Create an ActiveFunnel for embedding in the Chat document.
+        Call this after creating/updating the ChatFunnel.
+        
+        Args:
+            funnel_name: Name of the funnel (for denormalization)
+            stage_name: Name of the current stage (for denormalization)
+        """
+        if not self.current_stage_id or not self.entered_current_stage_at:
+            raise ValueError("Cannot create ActiveFunnel without current stage")
+        
+        return ActiveFunnel(
+            chat_funnel_id=self.id,
+            funnel_id=self.funnel_id,
+            funnel_name=funnel_name,
+            current_stage_id=self.current_stage_id,
+            current_stage_name=stage_name,
+            entered_current_stage_at=self.entered_current_stage_at
+        )

letschatty/models/company/__init__.py

@@ -1,3 +1,4 @@
 from .assets import *
 from .empresa import EmpresaModel
-from .form_field import FormField, FormFieldPreview, CollectedData, SystemFormFields
+from .form_field import FormField, FormFieldPreview, CollectedData, SystemFormFields
+from .CRM.funnel import Funnel, FunnelPreview, ChatFunnel, StageTransition, FunnelStatus

letschatty/models/company/assets/ai_agents_v2/chatty_ai_agent.py

@@ -110,6 +110,12 @@ class ChattyAIAgent(CompanyAssetModel):
     examples: List[StrObjectId] = Field(default_factory=list, description="Training examples")
     double_checker_enabled: bool = Field(default=False, description="Whether the double checker is enabled")
     double_checker_instructions: Optional[str] = Field(default=None, description="Instructions for the double checker")
+    copilot_confidence_threshold: Optional[int] = Field(
+        default=None,
+        ge=0,
+        le=100,
+        description="Confidence threshold 0-100 para modo COPILOT (fallback a env si no está)"
+    )
 
     # Pre-qualification configuration
     pre_qualify: Optional["PreQualifyConfig"] = Field(
@@ -165,4 +171,4 @@ class ChattyAIAgent(CompanyAssetModel):
 
 # Import and rebuild for forward reference resolution
 from .pre_qualify_config import PreQualifyConfig
-ChattyAIAgent.model_rebuild()
+ChattyAIAgent.model_rebuild()

letschatty/models/company/assets/automation.py

@@ -14,7 +14,16 @@ class Automation(BaseModel):
     chatty_ai_agent_config: Optional[ChattyAIConfigForAutomation] = Field(default=None)
     area: Optional[Area] = Field(default=None)
     agent_id: Optional[StrObjectId] = Field(default=None)
-    chain_of_thought : Optional[str] = Field(default=None)
+    chain_of_thought: Optional[str] = Field(default=None)
+    # Funnel transition automations
+    target_funnel_id: Optional[StrObjectId] = Field(
+        default=None,
+        description="Target funnel to move the chat to (for cross-funnel transitions)"
+    )
+    target_stage_id: Optional[StrObjectId] = Field(
+        default=None,
+        description="Target stage within the target funnel"
+    )
     # client_info: Optional[ClientInfo] = Field(default=None) me gustaría que levante el mail y/o otros atributos
 
     @model_validator(mode='after')

letschatty/models/company/assets/company_assets.py

@@ -5,6 +5,8 @@ class CompanyAssetType(StrEnum):
     USERS = "users"
     BUSINESS_AREAS = "business_areas"
     FUNNELS = "funnels"
+    FUNNEL_STAGES = "funnel_stages"
+    FUNNEL_MEMBERS = "funnel_members"
     PRODUCTS = "products"
     SALES = "sales"
     TAGS = "tags"

letschatty/models/messages/chatty_messages/schema/chatty_content/content_document.py

@@ -1,5 +1,6 @@
 from pydantic import BaseModel, Field, model_validator, ValidationInfo
 from typing import Optional
+from urllib.parse import urlparse, unquote
 from .content_media import ChattyContentMedia
 
 class ChattyContentDocument(ChattyContentMedia):
@@ -8,5 +9,6 @@ class ChattyContentDocument(ChattyContentMedia):
     @model_validator(mode='before')
     def validate_filename(cls, data: dict, info: ValidationInfo):
         if not data.get("filename") and data.get("url"):
-            data["filename"] = data["url"].split("/")[-1]
-        return data
+            parsed = urlparse(data["url"])
+            data["filename"] = unquote(parsed.path.split("/")[-1])
+        return data

letschatty/models/messages/chatty_messages/schema/chatty_content/content_media.py

@@ -1,5 +1,6 @@
 from pydantic import BaseModel, Field, field_validator, HttpUrl
 from typing import Optional
+from urllib.parse import quote
 class ChattyContentMedia(BaseModel):
     id: Optional[str] = Field(description="Unique identifier for the image. Also known as media_id", default="")
     url: str = Field(description="URL of the media from S3")
@@ -11,9 +12,9 @@ class ChattyContentMedia(BaseModel):
     def validate_url(cls, v):
         if not v:
             raise ValueError("URL is required")
-        HttpUrl(v)
-        return v
+        encoded = quote(str(v), safe=":/?&=%#")
+        HttpUrl(encoded)
+        return encoded
     
     def get_body_or_caption(self) -> str:
         return self.caption
-

letschatty/models/utils/custom_exceptions/custom_exceptions.py

@@ -59,6 +59,30 @@ class WhatsAppPayloadValidationError(Exception):
     def __init__(self, message="WhatsApp payload validation error", status_code=400, **context_data):
         super().__init__(message, status_code=status_code, **context_data)
 
+
+class ChatWithActiveContinuousConversation(CustomException):
+    """
+    Raised when an AI agent is triggered on a chat that has an active Continuous Conversation.
+    """
+    def __init__(self, message="Chat has an active continuous conversation", status_code=400, **context_data):
+        super().__init__(message, status_code=status_code, **context_data)
+
+
+class ChattyAIModeOff(CustomException):
+    """
+    Raised when an AI agent is in OFF mode and cannot be triggered.
+    """
+    def __init__(self, message="Chatty AI agent is OFF", status_code=400, **context_data):
+        super().__init__(message, status_code=status_code, **context_data)
+
+
+class MissingAIAgentInChat(CustomException):
+    """
+    Raised when a chat has no AI agent assigned but one is required for the operation.
+    """
+    def __init__(self, message="AI agent not assigned to chat", status_code=404, **context_data):
+        super().__init__(message, status_code=status_code, **context_data)
+
 class UnsuportedChannel(CustomException):
     def __init__(self, message="Channel not supported", status_code=400, **context_data):
         super().__init__(message, status_code=status_code, **context_data)

letschatty/services/factories/analytics/events_factory.py

@@ -321,7 +321,7 @@ class EventFactory:
         return events
 
     @staticmethod
-    def funnel_stage_events(chat_with_assets: ChatWithAssets, company_info: EmpresaModel, trace_id: str,executor_type: ExecutorType, executor_id: StrObjectId, chat_funnel: ClientFunnel, funnel_transition: StageTransition, event_type: EventType, time: datetime, company_snapshot: Optional[CompanyChatsSnapshot] = None, agent_snapshot: Optional[AgentChatsSnapshot] = None) -> List[Event]:
+    def funnel_stage_events(chat_with_assets: ChatWithAssets, company_info: EmpresaModel, trace_id: str,executor_type: ExecutorType, executor_id: StrObjectId, chat_funnel: ChatFunnel, funnel_transition: StageTransition, event_type: EventType, time: datetime, company_snapshot: Optional[CompanyChatsSnapshot] = None, agent_snapshot: Optional[AgentChatsSnapshot] = None) -> List[Event]:
         events = []
         base_data = EventFactory._create_base_customer_event_data(
                                                                     chat_with_assets=chat_with_assets,
@@ -334,8 +334,10 @@ class EventFactory:
         funnel_data = FunnelEventData(
             **base_data.model_dump(),
             funnel_id=chat_funnel.funnel_id,
-            funnel_stage_transition=funnel_transition,
-            time_in_funnel_seconds=chat_funnel.time_in_funnel_seconds
+            chat_funnel_id=chat_funnel.id,
+            stage_transition=funnel_transition,
+            time_in_funnel_seconds=chat_funnel.time_in_funnel_seconds,
+            time_in_last_stage_seconds=chat_funnel.time_in_current_stage_seconds
         )
         event = ChatFunnelEvent(
             specversion=EventFactory.package_version(),

{letschatty-0.4.332.dist-info → letschatty-0.4.334.dist-info}/METADATA

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

{letschatty-0.4.332.dist-info → letschatty-0.4.334.dist-info}/RECORD

@@ -1,19 +1,19 @@
 letschatty/__init__.py,sha256=6dGYdy5edB1dHdgvpqUpENZ347CpIyWgR1CsGYwPSk8,45
 letschatty/models/__init__.py,sha256=obWHa796C-O1mqo_lk22KhUC2ODVvG7cICY3Lo-AqJg,126
 letschatty/models/ai_microservices/__init__.py,sha256=h0xLiuU1wfHpDl1oKCzVKUef3ROYU7qIyVxBsdcdZe0,641
-letschatty/models/ai_microservices/expected_output.py,sha256=2JuQvQAmaWPuDiZQyHA4r9yAnVAKgzDA5oxe-xaxKMc,9220
-letschatty/models/ai_microservices/lambda_events.py,sha256=meIr4rVb9QEZL0VKziZ46NzGfedOzxuo0CA6NgquYhM,14045
+letschatty/models/ai_microservices/expected_output.py,sha256=PWXvmGiOhqAuOVCZHhfvUMzb8BwSnAoys4CReJ9dIK4,9441
+letschatty/models/ai_microservices/lambda_events.py,sha256=aazW8g6M7b7Lk-KZbx0R4AoV5oMjgXEpAcnsIwQ7Jf4,14319
 letschatty/models/ai_microservices/lambda_invokation_types.py,sha256=KWvXFvHhwYMaAIHbGpdW8AYE0eqrfCgZ_28jIyGXoME,1918
 letschatty/models/ai_microservices/n8n_ai_agents_payload.py,sha256=E5tu2UcSJCybMSvxfZG3JIxSxHbTBbjdRE74cnRtlGY,696
 letschatty/models/ai_microservices/openai_payloads.py,sha256=HauUGf4c37khJJsKyH4ikxzHKboGWnerjDQgDOnMFrY,271
 letschatty/models/analytics/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-letschatty/models/analytics/events/__init__.py,sha256=-0S6DyvbrIbLb7s0FD2HCg0Uqc9eU0OkLyOmM7KD_tg,2084
+letschatty/models/analytics/events/__init__.py,sha256=LtbKa54_Um7LFKyn-nQ30efHuR4et-aOVFTg3K0Ova4,2096
 letschatty/models/analytics/events/base.py,sha256=vmRnowUYot4OjYyqVjevGY9kF3Kb47IDkMJgJRwvcfU,1793
 letschatty/models/analytics/events/chat_based_events/ai_agent_chat.py,sha256=Ac6Llg2IFM0lftCkAErThjd283f_AEYqg76OkNnihuM,1681
 letschatty/models/analytics/events/chat_based_events/business_area.py,sha256=YZgIejCzbryySxolMSgvCFMuRggMcwBJ-jeQKdEshvM,904
 letschatty/models/analytics/events/chat_based_events/chat_based_event.py,sha256=YDXzX78jZgxuPFkTqipXFAo6G0-ajl_RkJISsjM9YJU,1469
 letschatty/models/analytics/events/chat_based_events/chat_context.py,sha256=Y6VfYorrKurbUgWtIPOsfNMbGQbuTPR5wQQLrbBxD9Q,2226
-letschatty/models/analytics/events/chat_based_events/chat_funnel.py,sha256=HmasWF9auAZPvwQRuYyHZvGG8jmqx9TXgiRGD71-m3Y,1699
+letschatty/models/analytics/events/chat_based_events/chat_funnel.py,sha256=LX_lcOn1R2VhdffdZeuc7S87PcoHBhEuppWaBXFP6tY,4184
 letschatty/models/analytics/events/chat_based_events/chat_status.py,sha256=9vt8GP6QnMrUuJF-AbUQm68Nkc0Zgexmnb-T1k8tsD4,2222
 letschatty/models/analytics/events/chat_based_events/contact_point.py,sha256=IIzf0EkgxUJKr7vqnv95LHEy0wQA9sVchHZA7Yi0H88,1944
 letschatty/models/analytics/events/chat_based_events/continuous_conversation.py,sha256=4Tbv83Zk5RIoUu6pKYpQdWMtxz9XZi26V-j5OSBP91U,2305
@@ -25,11 +25,11 @@ letschatty/models/analytics/events/chat_based_events/quality_scoring.py,sha256=f
 letschatty/models/analytics/events/chat_based_events/sale.py,sha256=WqpFp10h8yZwa5S5T4NCWCRLcBgkAAAME_CKmCv6K7M,1738
 letschatty/models/analytics/events/chat_based_events/tag_chat.py,sha256=7f1MaNdst-KN8-aIzgzyc6oBES-y8kkH5jVrsOOcxBs,1418
 letschatty/models/analytics/events/chat_based_events/workflow.py,sha256=BZQN2JDIgCVr2VbdcLg3O0J69SL_yPqGgMXzzNCId4E,1399
-letschatty/models/analytics/events/company_based_events/asset_events.py,sha256=Yc5og6bbkpr9_jH8lWQKxP80TITDsUGip6XPUibG6MI,3265
+letschatty/models/analytics/events/company_based_events/asset_events.py,sha256=EtVhl_W3wxkJhflbyk4NQraxAdpLeuesc9IfyOC5QV8,3490
 letschatty/models/analytics/events/company_based_events/company_events.py,sha256=PZAiw2imo706iM0EaCxnIaiFchMKivbwjKd7gsozA8k,1673
 letschatty/models/analytics/events/company_based_events/user_events.py,sha256=ZUoBaS60s63SoTUOUunLpojP1BQ9Cdl4sl_KdgY6NGI,2466
-letschatty/models/analytics/events/event_type_to_classes.py,sha256=cA7FFZei5-Zbc7HT2ZK7qLheo657wyHhqY1bDr_pBaU,4346
-letschatty/models/analytics/events/event_types.py,sha256=CWJCrgCCzANQQr1_AbvqEY3F1EdwVX-0GLd33zVjxnU,5278
+letschatty/models/analytics/events/event_type_to_classes.py,sha256=mjE45PLLNAuXIoCuIQaOMSxu-Z3NkIhQYk5y5NOOdOw,4331
+letschatty/models/analytics/events/event_types.py,sha256=kubeWq3ICqFnrM6rm1UNJJIveQy8lfb0KpM2o1aY6Wk,5471
 letschatty/models/analytics/metrics/__init_.py,sha256=DnGDYvEn9S1sSMe56e7mwE5r013nO-Fsf0pgBnf9RjI,276
 letschatty/models/analytics/metrics/daily_contact_points.py,sha256=eWwUmhFpL-Xn5sWQWCcACrulb4xwjMY80jDSAWsTMb4,1524
 letschatty/models/analytics/metrics/daily_new_chats.py,sha256=kTsQFDFwavTq3u7HcHx3RqZ_O517HqTrOD-k8q4JQz0,322
@@ -63,10 +63,10 @@ letschatty/models/base_models/update_model_interface.py,sha256=80YuvkEM5Rd3Ycysq
 letschatty/models/base_models/validate_timestamps_and_id.py,sha256=WRtaoW2EYtItgZjnNOYAffxy9K7M_NMNJ5imRN8Iu80,1971
 letschatty/models/channels/channel.py,sha256=Mgqigm-3uRDozxBIZZYj62PQwtnB0rAKoY2JS4477n8,2029
 letschatty/models/chat/assets_assigned_to_chat.py,sha256=nAdSzRvUSWa8-Plw6KZKnpUxxjCdWs_grml0bhskSis,192
-letschatty/models/chat/chat.py,sha256=NJcahnCHmY_RLUP6oKQEuEn1J8ycUsIkc7OruQmn1zs,16137
+letschatty/models/chat/chat.py,sha256=8kAQvtH_ccrhk6lnPDdmRvBwvV_iBYsA2h7Q9NcdNOA,16298
 letschatty/models/chat/chat_status_modifications.py,sha256=LcwXNl4WRllPI_ZYKcg5ANRjmSk4Cykkra0naayMAt4,317
-letschatty/models/chat/chat_with_assets.py,sha256=AvpcKz5zyiIxfnLjyVx8JSX9c0UQFhVKoACnyW0bu4Q,574
-letschatty/models/chat/client.py,sha256=qMaa-s65lBHMXOpSO2XRtKYeEki7Rr3E79ocKI5kcC4,2299
+letschatty/models/chat/chat_with_assets.py,sha256=K4UUwdfLw_Q0ZNHdeoqavqyHkZwisAQOi1OPMBYszOU,814
+letschatty/models/chat/client.py,sha256=oa7PM76V-OiBJL4T-IMytPW0WZdtvh9vFZhNtRQvt6Q,2196
 letschatty/models/chat/continuous_conversation.py,sha256=hoRYOMd_vfYglTGVw30yKS5Ogt5mLcsgDySrfHEli6o,4529
 letschatty/models/chat/filter_parameters.py,sha256=X1IHBYCJr_1y4R8syQYEwKhintdUZc-ZiB_8kSnjiYw,4489
 letschatty/models/chat/flow_link_state.py,sha256=RblDBp6uD-P0ZtaQn1-HzL1EpEgtVhN1rT3iBhO0gMw,5458
@@ -77,15 +77,15 @@ letschatty/models/chat/scheduled_messages.py,sha256=6z9XXgXUV6lPW8BalAZ4-MsmT8Zn
 letschatty/models/chat/temporary_chat.py,sha256=MR68vYrNvoyf40cLs2p5NnI8BNeN1VGTMAcuQw8j9RA,2303
 letschatty/models/chat/time_left.py,sha256=2uA9dS_0QAVnWn7Q2wIwGe4tMrlYBP9qySC7M8I0jb8,3307
 letschatty/models/company/CRM/business_area.py,sha256=U0F_7Rbq-e5tMSj_MugPqMHm2-IHxbAKbN0PWZ_93-o,296
-letschatty/models/company/CRM/funnel.py,sha256=Sn39LUJsrGLAhUFOdhHk5E3yblI1-RDlyCG_VRpOwxo,2510
-letschatty/models/company/__init__.py,sha256=5D1Ya_ZRGq2sLf9MXXTLZwGcrZPzo87t1NhRKS7Tw6o,140
+letschatty/models/company/CRM/funnel.py,sha256=gBGZhud060sK5QFI5y9NgmFuhLCOAtzK81TKBhK2gxE,15820
+letschatty/models/company/__init__.py,sha256=N_I-kRMHrtnp00c_bbFSiYYM47HJRS-d5slgtbexsl4,229
 letschatty/models/company/assets/__init__.py,sha256=z0xN_lt1D76bXt8DXVdbH3GkofUPQPZU9NioRSLt_lI,244
 letschatty/models/company/assets/ai_agents_v2/ai_agent_message_draft.py,sha256=xbshA34RSjHm2g8J7hW2FkWo-Qm8MH2HTbcRcoYmyvc,2076
 letschatty/models/company/assets/ai_agents_v2/ai_agents_decision_output.py,sha256=aEKZCOsGiFFPSx23fkS5Khfsxo-r8JGk3O0sxiGs8T0,5876
 letschatty/models/company/assets/ai_agents_v2/chain_of_thought_in_chat.py,sha256=LJqtSl1A1V0frPLYwW-5cMZxaGx7-0x1HvujRXsZsNU,5877
 letschatty/models/company/assets/ai_agents_v2/chat_example.py,sha256=yCKt6ifNYch3C78zAvj8To0_Sb9CPAZ8sC-hyoBPa4s,1816
 letschatty/models/company/assets/ai_agents_v2/chat_example_test.py,sha256=vChD-TkX1ORRD9LMbd2HlpbK4QyrsfhDiJd-LDjIqlk,4618
-letschatty/models/company/assets/ai_agents_v2/chatty_ai_agent.py,sha256=hRDdyG2dTgmu7KUHHCMviGJ03XiU99gVS5jp3EWyVUs,7992
+letschatty/models/company/assets/ai_agents_v2/chatty_ai_agent.py,sha256=R2rCANri8ZiqnmPP10PWoanGddMImCMxrl78Y6d-194,8204
 letschatty/models/company/assets/ai_agents_v2/chatty_ai_agent_config_for_automation.py,sha256=W8orpgp-yG8OHNWGQ16jMv-VgM_Z-Hk0q8PtC0KT2KU,388
 letschatty/models/company/assets/ai_agents_v2/chatty_ai_agent_in_chat.py,sha256=uVmD4FqGP5Tc8noxMBuRYGbkOXrtYlH2w6SAYwQZlLo,15494
 letschatty/models/company/assets/ai_agents_v2/chatty_ai_mode.py,sha256=CKlKI3t_D5eWJPn6hRvN4_V8Wu6W8c0x_EFQlpA50F4,2521
@@ -100,11 +100,11 @@ letschatty/models/company/assets/ai_agents_v2/n8n_schema_smart_follow_up_output.
 letschatty/models/company/assets/ai_agents_v2/pre_qualify_config.py,sha256=o9kKywbnm1lEliTTV0G7oSCFroyqp_w0GkypL--sSk4,4181
 letschatty/models/company/assets/assignment/__init__.py,sha256=eWYZfaDQde5OJNIDed8D-LNRXOa5O_O4mGMToNFtaW8,239
 letschatty/models/company/assets/assignment/assignment_assets.py,sha256=phIJqNh4UGTU-Hux_kaOYhJm2GCqv37AnCGePSDVKmM,2245
-letschatty/models/company/assets/automation.py,sha256=droRF1QeSCMt7jEPxAx8FPReuiVwb3yULGiLGi6nyIs,1296
+letschatty/models/company/assets/automation.py,sha256=RQFOvM-lipBdalfsRSZ8K5opytVgq_GS6YSR0Mz5Qs8,1639
 letschatty/models/company/assets/chat_assets.py,sha256=OV33LPOBOaK02Va0yH7rCH5ufmEyOploQPTEefjlsdk,7524
 letschatty/models/company/assets/chatty_fast_answers/__init__.py,sha256=tbgWS0n1i0nVi9f79U44GPRnrW25NKcjl6Port92alk,48
 letschatty/models/company/assets/chatty_fast_answers/chatty_fast_answer.py,sha256=PxW3eStHXo0BY7Z9hMDqBTHmgO7XcwtOvEpwXi-rA5g,1076
-letschatty/models/company/assets/company_assets.py,sha256=YKRo_uXhQYRQ8HvMf4HhrHTBC2zp7xlE_B0nqSMfMFY,726
+letschatty/models/company/assets/company_assets.py,sha256=9Or3hdUsWO0YCLqlwUb0Zcm_c5OerJqDx7rrrUK4_-E,800
 letschatty/models/company/assets/contact_point.py,sha256=2-C00CwQTAQkofQ4ufr5_nJPoxauOXZSDtyL-nj-hF8,2916
 letschatty/models/company/assets/filter_criteria.py,sha256=5hYhHWz5hoMyIURHML2XPZo_Bl66Cyvbh8caVPgdAvE,2283
 letschatty/models/company/assets/flow.py,sha256=mYKB6DG_DHSJymoTpeXm15OWsWI1OP4rkzvMg8AeYzY,1198
@@ -157,11 +157,11 @@ letschatty/models/messages/chatty_messages/schema/chatty_content/content_audio.p
 letschatty/models/messages/chatty_messages/schema/chatty_content/content_button.py,sha256=jdk9QFBN-SaAV6_fnBqkXwl0AFXJLbBNatikhUXLobo,181
 letschatty/models/messages/chatty_messages/schema/chatty_content/content_central.py,sha256=k7J1G4GlfRX5J4ZJIoviOHiekioaLbAc-76In_ZfiIo,712
 letschatty/models/messages/chatty_messages/schema/chatty_content/content_contacts.py,sha256=I1f_NNaT7QYriruMJdWT6K_8JjaU7XVaTSXctNB-_9o,985
-letschatty/models/messages/chatty_messages/schema/chatty_content/content_document.py,sha256=cxQXOFFZ_kCPs5M7QBAye8_HIPReWgNZPPxayHCCSGY,508
+letschatty/models/messages/chatty_messages/schema/chatty_content/content_document.py,sha256=sy25r2a2eVxHoJoy_4ZiGSBXz7gYxErXvsq-JWSMLL0,604
 letschatty/models/messages/chatty_messages/schema/chatty_content/content_image.py,sha256=AmILz3zm1HFUh5hjSxjBxLg4AR2DoY9NrBU9NIjjjvk,102
 letschatty/models/messages/chatty_messages/schema/chatty_content/content_interactive.py,sha256=zIdk_-RlTQIAGh9AifnY7Yqs3C7ukyX2RPb-VyhIJ0w,164
 letschatty/models/messages/chatty_messages/schema/chatty_content/content_location.py,sha256=GLk7-QtkksY7G53swRKRiZo481GuhBXA-bsCEBf3B3A,217
-letschatty/models/messages/chatty_messages/schema/chatty_content/content_media.py,sha256=-K10IU5Snt9TMU9qiuR9uRrLhF0HUEZ0vZRHP25jKSo,775
+letschatty/models/messages/chatty_messages/schema/chatty_content/content_media.py,sha256=Y_jm1HkGFORZAr3uxz-cNo4nGGuwdHS6cC0KHu5-9e0,865
 letschatty/models/messages/chatty_messages/schema/chatty_content/content_reaction.py,sha256=ZRCrWXJxUYCnpMikPO6JGj1eeZvQGcj8nKMQkVXw0KA,155
 letschatty/models/messages/chatty_messages/schema/chatty_content/content_sticker.py,sha256=hmV6LQZXorn3iM-tzVk_kxA9BxW4jEiopRjNFY9xcFA,254
 letschatty/models/messages/chatty_messages/schema/chatty_content/content_text.py,sha256=A_gw5WNCcStpSzHC_jzszDvxtv-ChVOJA2po5EHnccs,416
@@ -202,7 +202,7 @@ letschatty/models/messages/meta_message_model/schema/values/value_messages.py,sh
 letschatty/models/messages/meta_message_model/schema/values/value_statuses.py,sha256=SGibpHxdWy6DbzGfJjlrHIxrviqxXbRj54k4rz-fDQM,1966
 letschatty/models/utils/__init__.py,sha256=ziz1DfISJPfq5dE9xjNiwBlwsscHfOks1s0BWD7c1cI,20
 letschatty/models/utils/custom_exceptions/__init__.py,sha256=FrZBwS0o2TuTJcJFRnreRT5v_tv8EY2_EhKL2cAr7PI,32
-letschatty/models/utils/custom_exceptions/custom_exceptions.py,sha256=yzakSiZhyA5boBedGffN8-7W7VRfP6P1kYtRed4in2w,10690
+letschatty/models/utils/custom_exceptions/custom_exceptions.py,sha256=mX7AGWsl3qj76lub3wpe8HCUgZEOwnKDYPOw0_3YYOY,11665
 letschatty/models/utils/definitions.py,sha256=ylyTOyDVYpE6UcViTSpxnzoxic4VzPVHE45k2Vc1U6A,826
 letschatty/models/utils/types/CRUD_operations.py,sha256=bRagXYtzeIzM4JSY8mD-4tTaqviUmq_0tY9H74nSS5I,139
 letschatty/models/utils/types/__init__.py,sha256=2z69a0c4s5fWiA9I3thv4P_SbehlvF3e-t757L0vcK4,419
@@ -244,7 +244,7 @@ letschatty/services/continuous_conversation_service/continuous_conversation_help
 letschatty/services/events/events_manager.py,sha256=z2CAc-TqpXkyX9pPHImFXMIDRipLp7e-mN1gRvaM04E,67
 letschatty/services/factories/__init__.py,sha256=cDAQ_0M5xKqZAui5ijHvbtHxn3jFFM4kBcXIXc_Bv38,161
 letschatty/services/factories/analytics/contact_point_factory.py,sha256=5YXkoIwd43gtoYpFUACIXJGCJYyUEqS97XxpR_dBrt4,441
-letschatty/services/factories/analytics/events_factory.py,sha256=SiSrieKtURfG8m3YQsMhzq28h8lsqMSkUm4TkQGAqzE,35268
+letschatty/services/factories/analytics/events_factory.py,sha256=o_ojRvzM5X8U3zSzbWqqA2bAWk6TP0YH3CZzPzxC7lY,35384
 letschatty/services/factories/analytics/smart_messages/topics_factory.py,sha256=nJRlOtQFiosafXakZoJj8UCVoiNovjDiOoO52vIh4ok,682
 letschatty/services/factories/analytics/sources/helpers.py,sha256=_2lsaTEhNFqr2ZyO8clMCD-t3MCPTQMyVoSUo5Fio_Y,868
 letschatty/services/factories/analytics/sources/source_factory.py,sha256=kvpS9dLoCsIVnV_wMQzBpFXoN3AyjyphX-IFRg5sO5c,7877
@@ -274,7 +274,7 @@ letschatty/services/template_campaigns/template_campaign_service.py,sha256=jORgD
 letschatty/services/users/agent_service.py,sha256=hIkUUJ1SpkKbh5_uo4i2CeqGtuMTjU7tSV8k5J7WPG4,279
 letschatty/services/users/user_factory.py,sha256=FCB9uiAfjMeYfh4kMdx5h8VDHJ8MCsD-uaxW3X3KaWM,6681
 letschatty/services/validators/analytics_validator.py,sha256=-QBR6XIqEv2qw3stcBQehkwui1EcfWUM6M9DRQODykY,6335
-letschatty-0.4.332.dist-info/LICENSE,sha256=EClLu_bO2HBLDcThowIwfaIg5EOwIYhpRsBJjVEk92A,1197
-letschatty-0.4.332.dist-info/METADATA,sha256=32bLBqSIgu54CEMcJGo4nXmnoDWPzGSbABK5FuxZLnE,3283
-letschatty-0.4.332.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
-letschatty-0.4.332.dist-info/RECORD,,
+letschatty-0.4.334.dist-info/LICENSE,sha256=EClLu_bO2HBLDcThowIwfaIg5EOwIYhpRsBJjVEk92A,1197
+letschatty-0.4.334.dist-info/METADATA,sha256=1ufTW9UjstNL0GU3fIc9h6Z6e71jgE93skR5bFoxqjc,3283
+letschatty-0.4.334.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
+letschatty-0.4.334.dist-info/RECORD,,